Menu
任务执行引擎——选择正确的执行模式。当 plan 已批准需要写代码，或提到"执行""实现""编码"
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
结构化脑暴——发散探索 + 收敛评估。当想法模糊、面临开放性问题或需要方案对比，或提到"脑暴""想法""方案对比""怎么办"
恢复保存的工作上下文。当新 session 需要继续之前的工作，或提到"恢复""restore""继续上次"
保存工作上下文。当需要保存当前工作状态供后续 session 恢复，或提到"保存""save""checkpoint""挂起"
架构决策记录（ADR）。当面临技术选型、架构决策、方案取舍需要记录，或提到"ADR""决策记录""为什么这样做"
发布或导出检查 → Go/No-Go → 归档。当审查通过后需要上线或交付最终产物，或提到"发布""上线""ship""Go/No-Go"
合并 PR → 等待 CI → 验证生产。当 PR 已创建需要合并到主分支并验证部署，或提到"合并""merge""PR""land"
| name | build-cognitive-execution-engine |
| description | 任务执行引擎——选择正确的执行模式。当 plan 已批准需要写代码，或提到"执行""实现""编码" |
build-workflow-plan 完成，任务列表已就绪/reviewbuild-quality-tdd/SKILL.md + build-workflow-execute/SKILL.md执行引擎只消费 /plan 已批准的任务列表：implement this plan task-by-task。
### Task N 是一个执行单元，必须有验收条件和验证证据plans/*.md 子计划也是执行单元；子计划内部仍按 ### Task N 逐项执行Task N 或 plans/*.md 子计划Subagent 的目标是隔离高噪音上下文、执行专项任务、压缩可决策信息；并行只是可选收益，不是默认目标。
适合分派 subagent：
不适合分派 subagent：
每次分派必须写清：Goal、Task Source、Selected Persona、Read Scope、Write Scope、Forbidden Actions、Allowed Tools、Output Limit、Completion Criteria。
默认优先 read-only；只有 implementer / debugger 类型任务允许 Edit / Write。
返回内容不得包含原始日志、完整 diff、大段代码、长篇推理或无关背景。默认压缩到 1200 字以内；最后一行必须是单行 JSON：{"status":"...","changed_files":[],"test_results":[],"artifact_paths":[]}。
执行引擎选择执行模式时，也必须选择明确 persona；persona 选择不改变 Task N / Write Scope / Verification Evidence。
agents/task-planner.mdagents/software-engineer.mdagents/api-designer.md first, then agents/software-engineer.mdagents/data-architect.md first, then agents/software-engineer.mdagents/content-writer.mdagents/content-writer.md for narrative first, then agents/visual-designer.md for layoutagents/visual-designer.mdMode B fan-out can use different personas in parallel only when their Write Scope does not overlap and semantic independence is explicit. Mode C implementer/reviewer prompts must name the selected persona and include its required skills, inputs, outputs, scope, allowed tools, output limit, and completion criteria.
主 agent 按 ### Task N 顺序执行。适用单文件修改、简单 bug 修复、配置变更。
规则：实现 → 测试验证 → 记录/提交 → 下一个 Task N。当前 Task N 验证未通过前不进入下一个。每个任务 < 100 行变更。不要同时开多个实现分支。
面对 2+ 个真正独立的 Task N 或 plans/*.md 子计划（无共享文件、无共享状态、无顺序依赖），一次性分派。
规则：
Parallel Execution Matrix 中明确 parallel_safe: yes 的 task 或子计划Write Scope禁止并行： 任务有依赖关系、修改同一文件、共享 DB schema 变更、共享 API/type/flag/config/test 契约未冻结、子计划缺 Write Scope / Verification Evidence / Merge Checkpoint / Cross-check Command / Semantic Independence Reason、release/export/ship 收口子计划。
当 Plan Topology 是 gated-parallel：主 agent 先串行执行 contracts/gated/serial 子计划 → 共享契约验证通过 → 才分派依赖该契约的 parallel_safe 子计划。契约变化时已分派子计划全部作废。
分派模板： 每个 subagent 必须指定 Goal、Task Source、Selected Persona、Write Scope、Read Scope、Forbidden Actions、Allowed Tools、Shared Contracts、Global Invariants、Verification Evidence、Cross-check Command、Merge Checkpoint、Output Limit、Completion Criteria。最后一行输出 JSON 包含 status + changed_files + test_results + artifact_paths。
用于高复杂度任务（跨多模块、关键业务逻辑、需安全审查）。
流程： Implementer subagent → 返回 status → Spec Gate subagent（独立验证）→ Code Quality Gate subagent（五轴审查）。
定位： 这是 build 阶段的内部保险丝，不是 formal /review。通过此 gate 只表示“允许继续集成 / 进入正式审查候选”，不表示“已经完成正式审查”。
关键规则：
/review 仍需单独产出 04-review.md提示词模板： 使用 implementer-prompt.md、spec-reviewer-prompt.md、quality-reviewer-prompt.md。
| 复杂度 | 模型 | 适用 |
|---|---|---|
| 低 | Haiku / 廉价模型 | 样板代码、格式变更、copy-paste 重构 |
| 中 | Sonnet / 标准模型 | 常规实现、CRUD、前端组件 |
| 高 | Opus / 能力最强模型 | 核心业务逻辑、复杂算法、安全关键代码 |
原则： 不省不该省的钱。Entity 关系重构用 Opus，改颜色变量用 Haiku。
并行 agent 返回后：全部 DONE → 合并变更 + 跑全量测试；有失败 → 回退失败 agent 变更 + 重新分派；有冲突 → 合并有效部分 + 手动处理冲突。
合并前必做：
Cross-check Command 已运行并通过Parallel Execution Matrix 没有证明 parallel_safe| 说辞 | 现实 | 后果 |
|---|---|---|
| "分派太慢，我直接写" | 1 个复杂任务 subagent 做 15min > 你猜 2h。并行 3 个 15min vs 串行 45min。 | 主 agent 猜测实现 > 单次返工 30-50%，总耗时 2-3x |
| "并行不会冲突" | 两个 agent 改同一文件 = 必定合并冲突。 | 合并冲突手动解决 > 30min/冲突，严重时丢弃一个 agent 全部变更 |
| "build 里已经审过了，不用 /review" | Mode C 只是 pre-review gate，不能替代 formal /review。 | 缺少独立 formal review → 合并质量门失效 → 返工和漏检风险叠加 |
| "跳过审查，代码看起来对" | 两阶段审查防止"看起来对但不符 spec"的错误。 | 无审查 → Implementer 偏离 spec → 合入不合规代码 → 返工 > 2x |
| "再分派一次也一样" | 第一次偏离 → 补约束 → 第二次才可能对。 | 不补约束重分派 → 同样偏离 → 3 次循环浪费 45+ min |
| "多开几个 agent 更保险" | 未限定目标、工具和输出上限的 subagent 会把噪音变成多份噪音摘要。 | 主 session 被重复背景、完整日志和无关建议污染，决策质量下降 |
Task N 或子计划就分派 subagentparallel_safe 不是来自 Parallel Execution Matrix 的显式结论 — 停止并行Cross-check Command 或 Semantic Independence Reason 却被标为 parallel_safeparallel_safe 子计划Task N 或子计划| 失败场景 | 处理方式 |
|---|---|
| Implementer 返回 BLOCKED | 人类介入。不猜测原因，不静默跳过 |
| Implementer 返回 NEEDS_CONTEXT | 提供更多上下文，重新分派 |
| Spec Gate 返回 SPEC_GAP | 退回 Implementer 修正，列出具体 gap |
| Code Quality Gate 发现 Spec Gate 应发现的问题 | STOP，重走 Spec → Quality 顺序 |
| 连续 3 次 Implementer 返回 ISSUES | STOP。回到 /plan 修补，不第四次分派 |
| 并行 agent changed_files 越界 | 回退越界 agent，降级串行或重切 Write Scope |
| 并行 agent 文件冲突 | 合并有效部分，冲突部分串行重做 |
| Cross-check Command 失败 | 视为语义耦合未被控制，回退相关并行结果并降级串行 |
| 全量测试合并后失败 | 定位失败 agent，回退其变更，修复后重跑 |
### Execution Engine 交付记录
**执行模式**: [inline / subagent / parallel fan-out]
**任务来源**: [03-plan.md Task N / plans/*.md 子计划名]
**任务完成状态**:
| Task N | 状态 | changed_files | test_results | 验证证据 |
|--------|------|--------------|-------------|---------|
| [Task N] | DONE / BLOCKED / NEEDS_CONTEXT | [文件列表] | [通过/失败] | [描述] |
**并行结果**（如适用）:
- Agent 1: [status] — Write Scope: [范围] — changed_files ⊆ Write Scope ✓/✗
- Agent 2: [status] — Write Scope: [范围] — changed_files ⊆ Write Scope ✓/✗
**Cross-check 结果**: [命令 + PASS/FAIL]
**合并后全量验证**: [通过 / 失败 — 具体原因]