菜单
Use when executing multi-wave engineering work needing strict TDD, bug-capture/fix split, quality gates, and orchestrated teams with per-agent Opus-advisor / Sonnet-executor model routing.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use as the first phase of a wave. Drafts brutal, testable acceptance criteria for a feature. Each AC must be falsifiable by a real-world test. Output written to .wave/ac.md.
Use after AC and before RED for any wave that ships UI. Performs component API audit against installed dist files, produces per-route mockup, defines visual ACs, flags design-system gaps. Output written to .wave/dr.md.
Use after RED is verified failing. Writes the minimum code to make RED tests pass, then verifies on a live stack with Playwright screenshots before any hand-off. Implements the verify-before-scan rule.
Use after DR and before any production code is written. Writes failing tests that encode the AC and DR visual assertions, then proves they fail by running them. RED phase of TDD — strict, no exceptions.
Use only after the user has approved the GREEN screenshot. Performs True End-to-End Testing across backend, frontend, DB, and external services with computed-style and boundingBox assertions, producing the final wave evidence pack.
Use when shipping a feature end-to-end. Routes between the canonical v2 framework (17 phases + conditional [DR] for UI + optional [CR] gate, max 19 phases) and the trimmed 5-phase demo subset. Invoked by /wave-start and /wave-start --demo. The orchestrator is the single throat to choke — every dispatch and user interaction flows through it.
| name | wave-execution-framework-v2 |
| description | Use when executing multi-wave engineering work needing strict TDD, bug-capture/fix split, quality gates, and orchestrated teams with per-agent Opus-advisor / Sonnet-executor model routing. |
| effort | xhigh |
A multi-wave, multi-team engineering execution framework. Work is decomposed into waves; each wave runs a strict 17-phase pipeline plus two conditional gates: [DR] Design Review at Phase 1.5 (mandatory when the wave ships UI — web, mobile, Storybook, or CLI-TUI) and [CR] Code Review at Phase 3.5 (optional, opt-in). Maximum surface per wave: 19 phases. Enforced by specialized subagent teams (Stream-Aligned, Quality Gate, Platform, Enabling). The orchestrator is the single point of coordination and the single throat to choke.
v2 preserves every phase, invariant, and cardinal rule from v1 and adds three changes that realize the framework against the current (2026) Claude Code / Agent SDK primitives:
Agent tool. Opus = advisory (plan, critique, decide). Sonnet = executor (write code, run tests, scan, fix). Haiku = mechanical (dashboard render, version bump). See references/10-model-routing.md.[ACB], [BSEA], [BTEET]) is enforced by separate dispatches with only the prior output in context. See references/01-architecture.md.isolation: "worktree" on writing dispatches; run_in_background for Dashboard and long Playwright runs; PreCompact / PostToolUse / PreToolUse hooks to enforce invariants; TaskCreate replaces tasks/todo.md; ToolSearch gates the per-phase tool surface. See references/09-platform-deltas.md, references/11-hooks-and-automation.md, references/12-mcp-and-plugins.md.references/05-language-binding-rules.md.AC=Acceptance Criteria · ACB=Brutal AC · DR=Design Review (UI waves only) · TDE=Test-Driven Execution · CR=Code Review (optional) · BC=Bug Capture · BF=Bug Fix · SEA=Silent Error Analysis · BSEA=Brutal SEA · DS=Dependency Scan · OA=Output Alignment · TEET=True E2E Testing · TEET-TC=TEET Test Case Design · BTEET=Brutal TEET · BTEET-X=Brutal TEET Execution · CL=Cleanup · CCP=Checkpoint · AD=Dashboard Update · E=Enabling · SA=Stream-Aligned · QG=Quality Gate · P=Platform
| # | Code | Phase | Team | Topology | Lead / Executor / Reviewer model |
|---|---|---|---|---|---|
| 1 | [AC] | Acceptance Criteria | AC Team | E | Opus / Sonnet / Opus |
| 1.2 | [ACB] | Brutal AC Review (fresh eyes) | AC Hardening Team | E | Opus / Opus / Opus |
| 1.5 | [DR] | Design Review (mandatory for UI waves, skipped otherwise) | Design Review Team | E | Opus / Sonnet / Opus |
| 2 | [TDE-RED] | Write tests, verify FAIL | TDD-RED Team | SA | Sonnet / Sonnet / Sonnet |
| 3 | [TDE-GREEN] | Implement, verify PASS (isolation: worktree) | TDD-GREEN Team | SA | Sonnet / Sonnet / Opus |
| 3.5 | [CR] | Code Review gate (CodeRabbit — optional) | CodeRabbit Plugin | QG | plugin-managed |
| 4 | [BC] | Bug Capture | Bug Capture Team | QG | Sonnet |
| 4.1 | [BF-BC] | Fix BC findings (user approves) | Bug Fix Team | SA | Opus / Sonnet / Opus |
| 5 | [SEA] | Silent Error Scan | Silent Error Team | QG | Sonnet |
| 5.1 | [BF-SEA] | Fix SEA findings | Bug Fix Team | SA | Opus / Sonnet / Opus |
| 6 | [DS] | Dependency Validation | Dependency Audit Team | QG | Sonnet |
| 6.1 | [BF-DS] | Fix DS findings | Bug Fix Team | SA | Opus / Sonnet / Opus |
| 7 | [BSEA] | Brutal Silent Error Scan (fresh eyes) | SEA Hardening Team | QG | Opus / Opus / Opus |
| 7.1 | [BF-BSEA] | Fix BSEA findings | Bug Fix Team | SA | Opus / Sonnet / Opus |
| 8 | [OA] | Output Alignment vs AC | Output Alignment Team | E | Opus / Opus / Opus |
| 9 | [TEET-TC] | E2E Test Case Design | TEET Test Design Team | E | Opus / Sonnet / Opus |
| 10 | [TEET] | True End-to-End Testing (Playwright MCP for UI) | E2E Team | SA | Sonnet / Sonnet / Sonnet |
| 10.1 | [BF-TEET] | Fix TEET findings | Bug Fix Team | SA | Opus / Sonnet / Opus |
| 11 | [BTEET] | Brutal E2E Hardening (fresh eyes) | E2E Hardening Team | QG | Opus / Opus / Opus |
| 12 | [BTEET-X] | Execute brutalized E2E tests | E2E Execution Team | SA | Sonnet / Sonnet / Sonnet |
| 12.1 | [BF-BTEET] | Fix BTEET findings | Bug Fix Team | SA | Opus / Sonnet / Opus |
| 13 | — | Version Bump (parallel with 14) | Standalone subagent | — | Haiku |
| 14 | — | Git Commit (specific files only) | Standalone subagent | — | Sonnet |
| 15 | [CL] | Cleanup | Cleanup Team | P | Sonnet |
| 16 | [CCP] | Save Checkpoint | Checkpoint Team | P | Sonnet |
| 17 | [AD] | Dashboard Update (run_in_background) | Dashboard Team | P | Haiku |
Fresh-eyes rule — unchanged from v1: every hardening phase ([ACB], [BSEA], [BTEET]) must be a separate dispatch from the team that did the first pass. Every [BF-*] runs only if its preceding scan found bugs, and every fix strategy is user-approved — never auto-resolved.
Design Review rule (Phase 1.5): [DR] is mandatory for any wave that ships UI (web, mobile, Storybook, CLI-TUI). It is a separate team from [AC] and [ACB] because its inputs (installed design-system dist files, compiled CSS, route topology) and its outputs (component API audit, per-route mockup, computed-style visual ACs, gaps as OPEN items) are categorically different from functional acceptance criteria. [DR] skipped silently on non-UI waves; [TDE-RED] does not begin while any DR OPEN item is unresolved.
Invariants 6, 7 are now hook-enforced in v2; see references/11-hooks-and-automation.md.
| File | Load when |
|---|---|
references/01-architecture.md | Starting a session; designing team composition |
references/02-standing-teams.md | Instantiating Orchestrator, Permission, Dashboard, Checkpoint, Bug Ops, Cleanup |
references/03-wave-pipeline.md | Executing any wave phase — full phase spec with team rosters and model assignments |
references/04-meta-orchestration.md | Sequencing waves; acquiring session-wide permissions; toggling the CR gate |
references/05-language-binding-rules.md | Any cross-language boundary work (N-API / FFI / WASM) |
references/06-team-quick-reference.md | Spinning up a new team and needing membership / topology / model |
references/07-invariant-rules.md | Pressure to skip a step — re-read the invariants |
references/08-worktree-strategy.md | Multi-wave project with 3+ waves; isolating writes |
references/09-platform-deltas.md | Confirming which Claude Code / Agent SDK primitives the framework assumes |
references/10-model-routing.md | Choosing Opus / Sonnet / Haiku for a dispatch; escalation rules |
references/11-hooks-and-automation.md | Wiring PreCompact / PostToolUse / PreToolUse / TaskCreated hooks into settings.json |
references/12-mcp-and-plugins.md | Playwright for UI TEET; CodeRabbit as optional CR gate; ToolSearch scoping |