用途
Task Plan V2 Orchestrator 用于规划与编排类工作,而不是功能实现本身。它帮助创建、重构、审计和维护一份多智能体的 TASK-PLAN v2,作为规范化的 Markdown 控制文档。
规范模型
- FEATURE-PREPARATION.md 是实施前的门禁。
- TASK-PLAN.md 是规范、可编辑的控制文档。
- TASK-DASHBOARD.html 由 Markdown 派生,永远不是事实来源。
- 如果用户只要求一个文件,则在该文件内部保持同样的逻辑分离。
工作流程
- 对请求分类:创建新计划、重构现有计划、审计计划、准备特定运行时的投影。
- 阅读 references/field-layers.md。
- 如果用户提到 Codex、Claude Code、Gemini 或 Antigravity,还要阅读 references/runtime-adapters.md。
- 如果用户想要 HTML、仪表盘、图、看板或可观测视图,还要阅读 references/dashboard-contract.md。
- 从实施前层开始。如果它不完整,不要把实施任务标记为 ready。
- 把每个任务规范化为带显式字段的稳定任务块,而不是自由散文。
- 默认把多智能体执行建模为顺序执行。
- 在任务执行前加入 Execution Governance 和 Verification Policy。
- 缺失事实保持显式为 TBD、unknown 或 open_question,不要编造。
- 把关键 TBD 字段视为 ready、in_progress、approved、done 的阻塞项。
- 默认 NO-MOCKS 和 NO-PLACEHOLDERS。
- 如果模拟或占位暂时不可避免,把它转换为显式告警,附上替换要求,并把该告警带入每个下游提示或运行时投影。
多智能体规则
- 一个任务可以有很多智能体,但只有一个当前 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 读写规则
- 仪表盘就绪的结构
- 对任何临时模拟或占位符的显式未解决告警跟踪
适用场景与限制
该技能适用于多智能体任务的规划、编排、审计与运行时投影生成,尤其适合需要严格治理、显式交接和验证策略的工程计划。它不用于功能实现本身。资料未提供具体的收费、价格、平台支持范围或效果数据。