SuperAPI AI 工具集

programing-pipeline

编程与开发

查看项目

更新于 10-19 18:16

技能介绍

用途

该技能面向多代理编程工作流,规定主代理、执行子代理和审查子代理之间的协作契约,以及任务单、验收测试、证据、恢复与合并规则。适用于 AI agent 修改、重构、修复、扩展或验证 Git 项目,尤其需要隔离 worktree、独立审查和真实测试的任务。

角色契约

用户提供目标与优先级,裁决真实设计决策、外部授权和不可逆风险。主代理负责读状态、拆任务、写任务单与逐条验收测试,提交冻结后派发,调度执行与审查子代理,核验全部证据并重跑关键验收,更新任务单与路线图,全部闸门通过后合并并在主工作树复验。执行子代理在指定 worktree 按红→绿→蓝实现冻结任务单,运行验收命令与必要回归,只在自己任务证据目录写执行报告,不改冻结目标、范围或验收测试。审查子代理以独立上下文读任务单、代码和执行报告,亲自重跑验收测试,检查正确性、边界、范围、覆盖率与证据新鲜度,发现问题报 BLOCKED/FAIL,默认只读。

标准生命周期

流程包括恢复核对、规划拆分、冻结任务单、执行、独立审查、最终检查、合并复验和持久化。主代理把子代理返回视为阶段性工具调用,不证明任务完成;每个子代理返回后需重新读取任务单、Git/worktree 身份和本轮证据,核对 task-id、branch、HEAD、角色和报告新鲜度。标准闭环为执行子代理→独立审查子代理→主代理最终检查→合并后主工作树复验。

证据与工具

事实只能来自本轮直接读取的文件、命令输出或测试产物,推断需标注,未验证不得补造结果。PASS 必须可回溯到当前 task-id、HEAD、worktree、branch、完整命令、退出码、关键断言和产物。机械检查由技能内置 pipeline_tools 命令程序执行,新任务单须包含 pipeline-contract 机器区块,执行前运行 task preflight,执行中用 command run,范围用 scope check,正式证据校验前运行 evidence readiness,合并前后用 evidence verify 与 gate。证据目录 .workflow/<task-id>/ 至少含 executor-report.md、review-report.md、final-check.md。

适用场景与限制

适用于 Git 项目中需要隔离 worktree、独立审查和真实测试的代码修改任务。执行 agent 须能读写项目文件、运行构建/测试命令、创建 Git worktree 并创建子代理;能力不足时需在结果中标注证据边界。超时默认单条测试 3 分钟硬上限,整套使用明确累计上限。缺产品决策、协议兼容、权限、外部服务或验收环境时须保留现场上报,不替用户定案。通知、代理自述和旧报告不能代替当前证据。

参考文件

按需读取 templates/task-sheet.md、references/task-design.md、references/acceptance-evidence.md、references/execution-and-review.md、references/merge-and-recovery.md、references/live-and-browser.md、references/multi-medium.md 以及 scripts/validate_task_sheet.py。