SuperAPI AI 工具集

task-plan-v2-orchestrator

智能体与模型

查看项目

更新于 10-16 02:24

技能介绍

用途

Task Plan V2 Orchestrator 用于规划与编排类工作,而不是功能实现本身。它帮助创建、重构、审计和维护一份多智能体的 TASK-PLAN v2,作为规范化的 Markdown 控制文档。

规范模型

  • FEATURE-PREPARATION.md 是实施前的门禁。
  • TASK-PLAN.md 是规范、可编辑的控制文档。
  • TASK-DASHBOARD.html 由 Markdown 派生,永远不是事实来源。
  • 如果用户只要求一个文件,则在该文件内部保持同样的逻辑分离。

工作流程

  1. 对请求分类:创建新计划、重构现有计划、审计计划、准备特定运行时的投影。
  2. 阅读 references/field-layers.md。
  3. 如果用户提到 Codex、Claude Code、Gemini 或 Antigravity,还要阅读 references/runtime-adapters.md。
  4. 如果用户想要 HTML、仪表盘、图、看板或可观测视图,还要阅读 references/dashboard-contract.md。
  5. 从实施前层开始。如果它不完整,不要把实施任务标记为 ready。
  6. 把每个任务规范化为带显式字段的稳定任务块,而不是自由散文。
  7. 默认把多智能体执行建模为顺序执行。
  8. 在任务执行前加入 Execution Governance 和 Verification Policy。
  9. 缺失事实保持显式为 TBD、unknown 或 open_question,不要编造。
  10. 把关键 TBD 字段视为 ready、in_progress、approved、done 的阻塞项。
  11. 默认 NO-MOCKS 和 NO-PLACEHOLDERS。
  12. 如果模拟或占位暂时不可避免,把它转换为显式告警,附上替换要求,并把该告警带入每个下游提示或运行时投影。

多智能体规则

  • 一个任务可以有很多智能体,但只有一个当前 owner_role。
  • agent_sequence 是有序且顺序的,除非用户明确要求并行通道。
  • agent_contracts 必须定义:进入标准、预期输出、交接目标、停止条件。
  • required_approvals 必须指明角色或门禁,而不是含糊的“review”。
  • max_review_loops 必须是有限的。
  • escalation_rule 必须说明当评审循环耗尽或阻塞无法在本地解决时会发生什么。

治理规则

  • NO-FICTION:不要编造文件、提交、检查、审批、阻塞项或产物路径。
  • NO-MOCKS:不要计划或接受模拟、假集成、桩结果、假证据或假装后端作为安静的默认。
  • NO-PLACEHOLDERS:不要在可执行就绪的工作中留下占位符,除非作为显式未解决告警。
  • INVALID_INPUT:如果缺少必需输入,返回缺失字段并且不执行。
  • prompt-first:一个任务在 in_progress 前需要一个提示。
  • code-first:实施任务不能以仅文档进展收尾。
  • strict DONE:done 需要依赖、审批、已执行的验证、证据、回滚和同步。
  • verification-first:测试由 planner 规划、reviewer 评审、tester 执行。
  • commands_planned 与 commands_run 不同。
  • 占位证据、占位测试和占位产物路径无效。
  • 未解决的模拟和占位符必须变成告警,而不是静默备注。

每个未解决告警必须说明:

  • 什么被模拟或占位
  • 为什么存在
  • 替换它缺少什么确切事实、系统、凭证、产物或依赖
  • 替换目标和提议的替换路径
  • 它是否阻塞 ready、in_progress、approved 或 done

每个未解决告警必须复制到:

  • 任务块
  • 任务提示
  • 运行时投影
  • 交接摘要

需要阅读的内容

  • 始终阅读 references/field-layers.md。
  • 当需要特定运行时输出时,阅读 references/runtime-adapters.md。
  • 当用户想要 .html 或可视化看板时,阅读 references/dashboard-contract.md。

从以下复制:

  • assets/FEATURE-PREPARATION-CHECKLIST.md
  • assets/TASK-PLAN-v2.template.md
  • assets/CLAUDE-CODE.tasks-projection.md(当需要 Claude 风格的精简任务视图时)
  • assets/IMPLEMENTATION-PLAN.runtime.md(当 Gemini 或 Antigravity 需要投影时)

输出规则

  • 保留 Markdown 作为事实来源。
  • 让任务块足够稳定,以便确定性解析。
  • 仅在有助于导航或仪表盘生成时,在顶部附近保留紧凑登记表。
  • 不要把智能体级数据压缩成一句话;保持交接显式。
  • 为另一个运行时适配时,保持字段语义不变,只调整布局或标题。
  • 如果计划仍包含未解决的模拟或占位符,把它们作为顶层警告和每任务告警呈现,而不是埋在散文里。
  • 当关键未解决模拟/占位告警处于活动状态时,不要把任务标记为 ready、in_progress、approved 或 done。

运行时投影

  • Codex:直接编辑规范 Markdown。
  • Claude Code:保留规范 Markdown,仅在有用时输出精简任务投影。
  • Gemini 和 Antigravity:保留规范 Markdown,仅把 implementation_plan.md 作为投影输出,而不是替代品。

完成标准

一个好的 TASK-PLAN v2 具有:

  • 显式的功能准备门禁
  • 规范化的任务块
  • 顺序的智能体契约
  • Execution Governance 部分
  • 编码前规划的 Verification Strategy
  • 测试、评审、产物和回滚字段
  • wiki 读写规则
  • 仪表盘就绪的结构
  • 对任何临时模拟或占位符的显式未解决告警跟踪

适用场景与限制

该技能适用于多智能体任务的规划、编排、审计与运行时投影生成,尤其适合需要严格治理、显式交接和验证策略的工程计划。它不用于功能实现本身。资料未提供具体的收费、价格、平台支持范围或效果数据。