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