SuperAPI AI 工具集

spec-merge-back

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:完成一次需求后,把会长期约束未来需求的内容晋升到 .aidlc/project/(Project SSOT),其余内容留在 {FEATURE_DIR} 作为交付证据。核心原则是 Project SSOT 只沉淀入口、护栏(不变量)与证据链,禁止搬入一次性交付细节。

适用:本次需求完成、准备晋升 ADR/API Contract/Data Contract/Ops/NFR/Registry;plan.md 中出现 ## Merge-back 待办需清空或留痕;多需求反复出现同类契约口径、门禁口径、运维入口需沉淀为长期资产。不适用于 git 分支合并,也不适用于仓库尚无 .aidlc/project/ 骨架的情况(属 CONTEXT GAP,应先用 project-discover* 或项目初始化建立)。

主要能力与用法:先过门禁——必须通过 spec-context 定位 FEATURE_DIR 并在对话中回显,报错即停止;确认 .aidlc/project/ 存在,否则输出 CONTEXT GAP: .aidlc/project missing 并停止。随后按 SOP:以 {FEATURE_DIR}/implementation/plan.md 的 ## Merge-back 待办清单为唯一主入口,按 ADR、API Contract、Data Contract、Ops、NFR、Registry 等分类汇总,若存在 .gitmodules 则结合子仓路径确认证据来源;生成或更新 {FEATURE_DIR}/merge_back.md,逐条写明 project 落点(路径与锚点)、不变量摘要、证据入口、状态 Done/Not Done 及代码来源;再只晋升长期资产,例如 ADR 到 .aidlc/project/adr/,契约到 .aidlc/project/components/{module}.md#api-contract 与 #data-contract,Ops 到 .aidlc/project/ops/,NFR 到 .aidlc/project/nfr.md,并更新 .aidlc/project/index.md 状态。最后做 DoD 自检:清单落盘、入口可导航、锚点稳定、Done 项有落点与证据、Not Done 有缺口与计划、project 未被污染。完成后必须输出 ROUTER_SUMMARY(YAML)并立即调用 using-aidlc 路由下一步。

限制:禁止口头提供 FEATURE_DIR 而不跑 spec-context;禁止整包复制 design/implementation/release/verification 到 project;禁止跳过 plan.md 待办;不得把 merge-back 当作 git merge/rebase。缺失的 project 骨架不由本技能创建。