SuperAPI AI 工具集

synthesize

通用与其它

查看项目

更新于 10-16 00:02

技能介绍

用途:在评审阶段(spec 与质量评审均通过)完成后,把堆叠分支提交为 PR 并启用自动合并。触发条件包括用户执行 synthesize 命令、所有评审通过、准备提交 PR,或 oneshot 工作流经 finalize_oneshot 解析到 synthesize。

主要能力:prepare_synthesis 复合动作一次性完成阶段就绪、堆叠完整性(检测分叉分支、缺失任务分支、断裂父链并自动重建)、测试验证(在栈顶运行 npm run test:run && npm run typecheck)、基准回归检查、质量信号查询与文档就绪检查,并自动发出 gate.executed 事件。

使用方式:先调用 exarchos_orchestrate({ action: "prepare_synthesis", featureId, repoRoot }),repoRoot 必填,堆叠合成时传集成工作树的绝对路径。随后按 references/pr-descriptions.md 写 PR 描述(含 Summary、Changes、Test Plan 与页脚,标题格式 <type>: <what>,不超过 72 字符),用 validate_pr_body 校验通过后再自底向上调用 create_pr 与 merge_pr(strategy: squash)。提交后记录 PR URL、更新状态,并暂停等待用户确认是否合并。合并后调用 cleanup 并同步、回收工作树。

限制:评审未完成或失败时不得继续;create_pr 是“PR 已存在”的唯一权威,不要预先检查;直接编辑栈分支时推送须用显式 SHA 租约 git push --force-with-lease=<ref>:<expected-sha>,不可用裸 --force-with-lease;不要在合并确认前删除工作树。具体失败处理见 references/troubleshooting.md。