SuperAPI AI 工具集

planning-github-task

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:作为 GitHub issue 任务规划协调器,针对 docs/<ISSUE_SLUG>-tasks.md 中的一个任务,规划其执行方式。它调度聚焦的子代理,仅保留其结构化摘要,并把可复用的工作流产物留在磁盘上。该技能独立运行,仅依赖本文件夹内文件及 ./references/external-sources.md 中列出的可选公开 URL。

主要能力:按阶段调度四个子代理——execution-prepper 校验任务就绪度并组装执行简报;execution-planner 检查代码库并编写实现计划;test-strategist 定义行为驱动测试;refactoring-advisor 仅推荐本任务所需的重构。协调器一次只调度一个子代理,依据返回状态分支:PASS 继续,BLOCKED 停止并报告缺失前置产物或任务章节,FAIL 停止并报告未解决依赖、歧义、行为缺口或规划风险,ERROR 停止并询问用户。

使用方式:输入 ISSUE_SLUG(必填,如 acme-app-42)、TASK_NUMBER(必填,如 3)、RE_PLAN(可选)、DECISIONS_FILE(可选,如 docs/acme-app-42-task-3-decisions.md)。RE_PLAN 与 DECISIONS_FILE 仅用于评审驱动的重跑。输出四类产物:docs/<ISSUE_SLUG>-task-<TASK_NUMBER>-brief.md、-execution-plan.md、-test-spec.md、-refactoring-plan.md。

适用场景:需要为 GitHub issue 中的单个任务生成结构化执行规划,并希望产物可恢复、可被下游评审与执行复用。

限制:仅写入上述工作流规划产物,不写实现历史;外部页面为可选即时来源,无网络时以本地契约与模板为准;评审驱动重跑最多 3 轮,之后需暴露剩余高严重度问题;产物校验修复时仅重新调度产物所有者并传入 REPAIR_FINDINGS。具体收费、价格、平台支持等信息暂未提供。