SuperAPI AI 工具集

synthesis

通用与其它

查看项目

更新于 10-16 00:02

技能介绍

用途:Synthesis 是 Exarchos 工作流里的收尾技能,在评审阶段(spec 与 quality 均通过)完成后,把已完成的特性分支以 GitHub 原生堆叠 PR 的形式提交评审并合并。触发方式包括运行 /exarchos:synthesize、所有评审通过、准备提交 PR,或 oneshot 工作流经 finalize_oneshot 解析到 synthesize。

主要能力:通过 Exarchos MCP 动作完成 VCS 操作(create_pr、merge_pr、list_prs、check_ci 等),自动路由到 GitHub、GitLab 或 Azure DevOps,无需 gh/glab/az 命令。核心是 prepare_synthesis 复合动作,一次性完成阶段就绪检查、堆叠完整性校验(检测分叉分支、缺失任务分支、断裂父链并自动重建)、测试验证(npm run test:run && npm run typecheck)、基准回归检查与质量信号查询,并自动发出 gate.executed 事件。

使用方式:先调用 prepare_synthesis 验证前置条件;再按 references/pr-descriptions.md 编写 PR 描述(含 Summary、Changes、Test Plan 与页脚,标题格式 <type>: <what>,不超过 72 字符),用 validate_pr_body 校验通过后才可创建 PR;随后自底向上对堆叠中每个分支调用 create_pr 与 merge_pr(squash)启用自动合并,记录 PR URL 并更新状态,最后在用户确认后经 cleanup 清理并同步。

适用场景:feature、debug、refactor 工作流的评审后阶段,以及 oneshot 的可选路径。

限制:评审未完成或失败时不得继续,需先回到 /exarchos:review;不要强制推送堆叠分支、不要在合并确认前删除 worktree、不要用失败测试创建 PR;需发出 stack.submitted 与 shepherd.iteration 事件,否则工作流校验会告警。具体命令与参数以官方文档为准。