task-plan-v2-orchestrator

任务计划 V2 编排器

使用此技能创建规划和编排产物，而不是直接实现功能。

标准模型

• 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. 从实施前层开始。如果该层不完整，不要将实施任务标记为就绪。
6. 将每项任务规范化为包含明确字段的稳定任务块，而不是自由格式文本。
7. 默认按顺序对多 Agent 执行进行建模。
8. 在执行任务前添加 Execution Governance 和 Verification Policy。
9. 将缺失的事实明确标记为 TBD、unknown 或 open_question；不得自行编造。
10. 将关键的 TBD 字段视为 ready、in_progress、approved 和 done 的阻碍因素。
11. 默认采用 NO-MOCKS 和 NO-PLACEHOLDERS。
12. 如果暂时无法避免使用模拟内容或占位符，请将其转为明确警报，并注明替换要求；还要在所有下游提示词或运行时投影中保留该警报。

多 Agent 规则

• 一项任务可以有多个 Agent，但当前只能有一个 owner_role。
• 除非用户明确要求并行工作流，否则 agent_sequence 必须按顺序执行。
• agent_contracts 必须定义：
  • 准入条件
  • 预期产出
  • 交接目标
  • 停止条件
• required_approvals 必须指定角色或门槛，不得笼统地写成“审核”。
• 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。
• 占位证据、占位测试和占位产物路径均无效。
• 未解决的模拟内容和占位符必须转为 alarms，不得作为普通备注悄然保留。
• 每个未解决警报必须说明：
  • 哪些内容是模拟的或占位的
  • 其存在的原因
  • 要替换它，具体缺少什么事实、系统、凭据、产物或依赖项
  • 替换目标和拟议的替换路径
  • 它是否会阻碍 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
  • 需要类似 Claude 的精简任务视图时，使用 assets/CLAUDE-CODE.tasks-projection.md
  • Gemini 或 Antigravity 需要投影文件时，使用 assets/IMPLEMENTATION-PLAN.runtime.md

输出规则

• 以 Markdown 作为唯一事实来源。
• 确保任务块足够稳定，便于确定性解析。
• 只有在有助于导航或生成看板时，才在靠近顶部的位置保留精简的登记表。
• 不要将 Agent 级别的数据压缩成一句话；明确保留交接信息。
• 为其他运行时进行调整时，保持字段语义不变，只调整布局或标题。
• 如果计划中仍有未解决的模拟项或占位符，应将其作为顶层警告和各任务的警报明确列出，而不是埋在正文中。
• 存在尚未解决的关键模拟项／占位符警报时，不要将任务标记为 ready、in_progress、approved 或 done。

运行时投影

• Codex：直接编辑规范 Markdown。
• Claude Code：保留规范 Markdown，并仅在有用时生成精简的任务投影。
• Gemini 和 Antigravity：保留规范 Markdown，并仅将 implementation_plan.md 作为投影文件生成，不得替代规范 Markdown。

完成标准

优秀的 TASK-PLAN v2 应具备：

1. 明确的功能准备门槛
2. 规范化的任务块
3. 顺序执行的 Agent 契约
4. Execution Governance 章节
5. 编码前制定的 Verification Strategy
6. 测试、评审、产物和回滚字段
7. Wiki 的读取和写入规则
8. 可用于生成看板的结构
9. 对任何临时模拟项或占位符进行明确的未解决警报跟踪