SuperAPI AI 工具集

branch-comparison

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:分析两个 Git 分支之间的全部文件变更,进行影响分析,并据此更新规格文档。适用于分支对比、审查分支间改动、依据代码变更更新规格等场景。

主要能力:通过 git diff 与 git log 检测变更并分类(前端/后端、配置/数据库;功能/修复/重构);为每个变更文件建立知识图谱,记录依赖、影响级别与服务上下文;进行代码审查(优点、弱点、安全、性能、可维护性)与重构建议;在获得明确批准后更新需求、测试规格与架构文档。

使用方式:以 $skill-name 形式调用(Codex 环境)。核心命令包括 git diff --name-status [source-branch]..[target-branch]、git diff --stat [source-branch]..[target-branch]、git log --oneline [source-branch]..[target-branch]。分析结果写入 .ai/workspace/analysis/[comparison-name].analysis.md。流程分阶段:发现、知识图谱、分析、审批门、规格更新、验证。

限制:所有分析必须基于实际 git diff 证据,禁止臆测;未获用户明确批准不得越过审批门更新规格;若文件列表超过 75 个需按影响级别优先处理;若所需步骤或工具在当前环境无法运行,应停止并询问用户。具体项目配置与文档路径依赖仓库内的 docs/project-config.json 等文件,缺失时需先运行相应初始化流程。