| name | data-analysis |
| description | 代码库功能完成度分析工具。分析项目中各功能模块的实现状态、核心文件存在性、架构采用情况,并生成结构化的JSON分析报告。适用于项目进度跟踪、功能盘点、技术债务评估等场景。 |
代码库分析工具
代码库功能完成度分析工具,用于评估项目开发进度和质量。
快速开始
基本使用流程
- 准备分析配置:确保项目中存在功能模块定义文件(如 JSON 配置)
- 执行分析:运行代码库分析命令或请求 AI 助手执行分析
- 查看报告:获取 JSON 格式的详细分析报告
- 采取行动:根据报告识别需要改进的模块
快速示例
用户:分析当前项目的功能完成度
助手:
1. 读取 codebase-analysis.json 配置
2. 检查各功能模块的核心文件
3. 生成完成度报告
4. 输出统计结果
核心功能
功能模块分析
- 检测各功能模块的核心文件是否存在
- 评估功能完成度百分比
- 标识部分实现和未实现的功能指标
架构采用评估
- 评估项目架构决策的落地情况
- 检测技术选型的实际使用
- 提供架构采用证据
进度统计
- 统计已实现功能数量
- 计算整体项目完成度
- 生成可视化的进度报告
何时使用
当您需要以下功能时使用此技能:
- 项目进度跟踪:快速了解项目各功能模块的实现状态
- 功能盘点:检查计划功能是否已完整实现
- 技术债务评估:识别部分实现或缺失的功能
- 架构审查:验证架构设计是否得到实际落地
- 交接文档生成:为项目交接提供详细的功能清单
输出格式
生成 JSON 格式的分析报告,包含:
- 功能模块状态(完整/部分/缺失)
- 核心文件检查结果
- 功能完成度评分
- 架构采用情况
- 整体项目统计
使用场景
场景1:新成员加入团队
用户:帮我分析一下这个项目有哪些功能已经实现了
助手:使用 data-analysis 技能生成功能完成度报告
场景2:Sprint 复盘
用户:检查本次 Sprint 计划的功能是否都完成了
助手:使用 data-analysis 技能对比计划与实现
场景3:技术债务评估
用户:找出那些只完成了部分功能的模块
助手:使用 data-analysis 技能识别部分实现的功能
工作流程
完整分析流程
1. 读取配置
↓
读取 codebase-analysis.json
解析功能模块定义
2. 文件检查
↓
遍历每个功能模块
检查核心文件是否存在
3. 状态评估
↓
计算功能完成度
识别实现指标
4. 架构验证
↓
检查架构决策
收集采用证据
5. 生成报告
↓
统计整体数据
输出 JSON 结果
决策逻辑
- 完整实现:所有核心文件存在 + 所有指标实现
- 部分实现:部分核心文件存在或部分指标实现
- 未实现:核心文件缺失且无指标实现
快速提交工具
技能还包含快速 Git 提交脚本 push.sh,支持一键添加、提交和推送代码:
./push.sh "提交信息"
注意事项
- 分析结果基于文件存在性检查,不代表代码质量
- 需要预定义功能模块和核心文件清单
- 适合配合项目文档一起使用