SuperAPI AI 工具集

executing-github-task

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:这是 GitHub 工作流中针对单个任务的执行编排器,负责验证就绪状态、调度下一名专职子代理,并决定推进、进行定向修复还是升级。启动(kickoff)是评审通过后的第一个变更边界,之前的工作仍停留在评审与规划阶段。

主要能力:按阶段推进流程,包括就绪检查、启动、执行、文档、需求验证、质量门禁、定向修复循环、收尾与报告;调度 execution-starter、task-executor、documentation-writer、requirements-verifier、clean-code-reviewer、architecture-reviewer、security-auditor 等子代理;每轮只调度一个子代理,只在编排上下文保留结构化摘要。

使用方式:输入 ISSUE_SLUG(如 acme-app-42)与 TASK_NUMBER(每次调用仅一个任务)。需先读取 ./references/contracts.md 确认可跨越执行边界,再读 ./references/pipeline.md 按阶段顺序执行。按需加载 references 中的契约、重试与升级、评审门禁策略、示例和最终报告模板;子代理在返回时加载各自报告模板。每次运行以一份 FINAL_TASK_REPORT 结束,状态限于 COMPLETE、BLOCKED、STOPPED_FOR_USER_INPUT、ESCALATED。

适用场景:已在磁盘上完成评审与规划、需要把某个编号任务从启动推进到完成的 GitHub 工作流。

限制与约束:每次调用只执行一个任务;以任务计划与决策文件为唯一事实来源;Category A 编排产物需保留在磁盘且不入 git 历史;修复循环要定向,需求与各质量门禁最多重试三次;只有在输入通过新上下文、修复简报或用户明确决定改变时才重试停止的步骤;需求验证和所有质量门禁通过前,不得提交 GitHub 完成评论或关闭;缺少技能、跟踪能力、工作区状态不安全或歧义未解决时应明确暴露并停止,不自动继续。