SuperAPI AI 工具集

change-init

编程与开发

查看项目

更新于 10-16 01:24

技能介绍

用途:从 git 历史中挖掘代码演变的“为什么”,生成变更决策记录(ChDR)草稿,供人工复核。ChDR 记录只存在于提交与关联 issue 中的历史决策。

主要能力:扫描指定窗口的 git log,用正则识别引用 issue 追踪系统的提交(JIRA 键、GitHub/GitLab #NNN、MR !NNN、issue URL);将共享同一 issue 键的提交聚类为一个变更故事;尽力抓取 issue 标题与正文(GitLab 通过 MCP,GitHub 通过 gh,否则仅保留链接);从 diff 摘要推断 Decision,并记录 Consequences(revert、后续修复链等负向知识);将草稿写入 {REPO_ROOT}/.adlc/drafts/chdr/ChDR-{NNN}.md(状态 Discovered),并重建 chdr.md 索引。

用法:先运行技能目录下的 scripts/bash/setup-change-init.sh,解析 REPO_ROOT、CHDR_DRAFTS_DIR、NEXT_CHDR 等输出;支持参数如 --since 6months、--tracker gitlab、--no-fetch、--include-unlinked、--limit N、--resume 和路径限制。空输入默认扫描最近 500 次提交并自动检测追踪系统。完成后需运行 /change-clarify 校验,再用 /change-publish 发布。

限制:非 git 仓库无可挖掘,应改用 /team-init;不适合绿地项目、当前模式文档或会话学习记录;每条 Decision 必须引用 SHA 或 issue URL 并标注置信度,未知原因须明确写出,不得编造;issue 正文可能含敏感信息,只做 1-3 句摘要;不覆盖已有 ChDR。链接率过低时建议加 --include-unlinked。