SuperAPI AI 工具集

git-derive-docs

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:分析 git 提交历史,找出文档缺口,识别未被记录的架构决策(ADR)、规则约定、需求文档(PRD)和规划文档(PRP)。

主要能力:支持 --rules(从提交模式推导 .claude/rules/)、--prd(发现缺少需求文档的功能)、--adr(发现缺少决策记录的架构决策)、--prp(发现缺少规划文档的实现工作)、--all(默认,运行全部检测)、--refinements(检测方案变更、回退、返工)。可限定范围:--since=<date>、--depth=<N>(默认 200)、--dry-run(只报告不创建文件)。

使用方式:先运行脚本采集历史信号:bash "${CLAUDE_SKILL_DIR}/scripts/git-derive-docs.sh" --home-dir "$HOME" --project-dir "$(pwd)" --depth "$DEPTH" --since "$SINCE",解析 STATUS= 与 ISSUES:,再结合 git log、git diff-tree 等命令交叉核对现有 .claude/rules/ 与 docs/{prds,adrs,prps}/,最后生成分级报告并在非 --dry-run 时创建文档骨架。若可用 blueprint 命令,可建议使用 /blueprint:prd、/blueprint:adr、/blueprint:prp-create。

适用场景:挖掘未记录的约定、审计文档与实际实践是否一致、识别已实现但未留档的功能或架构决策。

限制:是否将某次提交判定为值得记录的真实决策仍需人工判断;避免与已有文档重复;其他未提供信息暂未说明。