@@ -23,20 +23,12 @@ Main process orchestrator: intent analysis → workflow selection → command ch
| `workflow-multi-cli-plan` | ACE context → CLI discussion → plan → execute |
| `review-cycle` | session/module review → fix orchestration |
| `brainstorm` | auto/single-role → artifacts → analysis → synthesis |
| `spec-generator` | product-brief → PRD → architecture → epics |
| `workflow:collaborative-plan-with-file` | understanding agent → parallel agents → plan-note.md |
| `workflow:req-plan -with-file` | requirement decomposition → issue creation → execution-plan.json |
| `workflow:roadmap -with-file` | strategic requirement roadmap → issue creation → execution-plan.json |
| `workflow:integration-test-cycle` | explore → test dev → test-fix cycle → reflection |
| `workflow:refactor-cycle` | tech debt discovery → prioritize → execute → validate |
| `team-planex` | planner + executor wave pipeline( 边规划边执行 ) |
| `team-iterdev` | 迭代开发团队( planner → developer → reviewer 循环)|
| `team-lifecycle` | 全生命周期团队( spec → impl → test) |
| `team-issue` | issue 解决团队( discover → plan → execute) |
| `team-testing` | 测试团队( strategy → generate → execute → analyze) |
| `team-quality-assurance` | QA 团队( scout → strategist → generator → executor → analyst) |
| `team-brainstorm` | 团队头脑风暴( facilitator → participants → synthesizer) |
| `team-uidesign` | UI 设计团队( designer → implementer dual-track) |
独立命令(仍使用 colon 格式) : workflow:brainstorm-with-file, workflow:debug-with-file, workflow:analyze-with-file, workflow:collaborative-plan-with-file, workflow:req-plan-with-file, workflow:integration-test-cycle, workflow:refactor-cycle, workflow:unified-execute-with-file, workflow:clean, workflow:init, workflow:init-guidelines, workflow:ui-design:*, issue:*, workflow:session:*
| `team-planex` | planner + executor wave pipeline( 适合大量零散 issue 或 roadmap 产出的清晰 issue, 实现 0→1 开发 ) |
## Core Concept: Self-Contained Skills (自包含 Skill)
@@ -54,21 +46,16 @@ Main process orchestrator: intent analysis → workflow selection → command ch
| 轻量 Plan+Execute | `workflow-lite-plan` | 内部完成 plan→execute |
| 标准 Planning | `workflow-plan` → `workflow-execute` | plan 和 execute 是独立 Skill |
| TDD Planning | `workflow-tdd-plan` → `workflow-execute` | tdd-plan 和 execute 是独立 Skill |
| 规格驱动 | `spec-generator` → `workflow-plan` → `workflow-execute` | 规格文档驱动完整开发 |
| 测试流水线 | `workflow-test-fix` | 内部完成 gen→cycle |
| 代码审查 | `review-cycle` | 内部完成 review→fix |
| 多CLI协作 | `workflow-multi-cli-plan` | ACE context → CLI discussion → plan → execute |
| 协作 规划 | `workflow:collaborative-plan-with-file` | 多 agent 协作生成 plan-note.md |
| 需求路线图 | `workflow:req-plan -with-file` | 需求拆解→issue 创建→执行计划 |
| 分析→ 规划 | `workflow:analyze-with-file` → `workflow-lite-plan` | 协作分析产物自动传递给 lite-plan |
| 头脑风暴→规划 | `workflow:brainstorm -with-file` → `workflow-lite-plan` | 头脑风暴产物自动传递给 lite-plan |
| 协作规划 | `workflow:collaborative-plan-with-file` → `workflow:unified-execute-with-file` | 多 agent 协作规划→通用执行 |
| 需求路线图 | `workflow:roadmap-with-file` → `team-planex` | 需求拆解→issue 创建→wave pipeline 执行 |
| 集成测试循环 | `workflow:integration-test-cycle` | 自迭代集成测试闭环 |
| 重构循环 | `workflow:refactor-cycle` | 技术债务发现→重构→验证 |
| 团队 Plan+Execute | `team-planex` | 2 人团队 wave pipeline, 边规划边执行 |
| 团队迭代开发 | `team-iterdev` | 多角色迭代开发闭环 |
| 团队全生命周期 | `team-lifecycle` | spec→impl→test 全流程 |
| 团队 Issue | `team-issue` | 多角色协作 issue 解决 |
| 团队测试 | `team-testing` | 多角色测试流水线 |
| 团队 QA | `team-quality-assurance` | 多角色质量保障闭环 |
| 团队头脑风暴 | `team-brainstorm` | 多角色协作头脑风暴 |
| 团队 UI 设计 | `team-uidesign` | dual-track 设计+实现 |
## Execution Model
@@ -136,27 +123,21 @@ function analyzeIntent(input) {
function detectTaskType ( text ) {
const patterns = {
'bugfix-hotfix' : /urgent|production|critical/ && /fix|bug/ ,
// With-File workflows (documented exploration with multi-CLI collaboratio n)
// With-File workflows (documented exploration → auto chain to lite-pla n)
'brainstorm' : /brainstorm|ideation|头脑风暴|创意|发散思维|creative thinking|multi-perspective.*think|compare perspectives|探索.*可能/ ,
'brainstorm-to-issue' : /brainstorm.*issue|头脑风暴.*issue|idea.*issue|想法.*issue|从.*头脑风暴|convert.*brainstorm/ ,
'debug-file' : /debug.*document|hypothesis.*debug|troubleshoot.*track|investigate.*log|调试.*记录|假设.*验证|systematic debug|深度调试/ ,
'analyze-file' : /analyze.*document|explore.*concept|understand.*architecture|investigate.*discuss|collaborative analysis|分析.*讨论|深度.*理解|协作.*分析/ ,
'collaborative-plan' : /collaborative.*plan|协作.*规划|多人.*规划|multi.*agent.*plan|Plan Note|分工.*规划/ ,
'req-plan ' : /roadmap|需求.*规划|需求.*拆解|requirement.*plan|req.*plan| progressive.*plan|路线.*图/ ,
'roadmap ' : /roadmap|需求.*规划|需求.*拆解|requirement.*plan|progressive.*plan|路线.*图/ ,
'spec-driven' : /spec.*gen|specification|PRD|产品需求|产品文档|产品规格/ ,
// Cycle workflows (self-iterating with reflection)
'integration-test' : /integration.*test|集成测试|端到端.*测试|e2e.*test|integration.*cycle/ ,
'refactor' : /refactor|重构|tech.*debt|技术债务/ ,
// Team workflows (multi-role collaboration, explicit "team" keyword required )
// Team workflows (kept: team-planex only )
'team-planex' : /team.*plan.*exec|team.*planex|团队.*规划.*执行|并行.*规划.*执行|wave.*pipeline/ ,
'team-iterdev' : /team.*iter|team.*iterdev|迭代.*开发.*团队|iterative.*dev.*team/ ,
'team-lifecycle' : /team.*lifecycle|全生命周期|full.*lifecycle|spec.*impl.*test.*team/ ,
'team-issue' : /team.*issue.*resolv|团队.*issue|team.*resolve.*issue/ ,
'team-testing' : /team.*test|测试团队|comprehensive.*test.*team|全面.*测试.*团队/ ,
'team-qa' : /team.*qa|quality.*assurance.*team|QA.*团队|质量.*保障.*团队|团队.*质量/ ,
'team-brainstorm' : /team.*brainstorm|团队.*头脑风暴|team.*ideation|多人.*头脑风暴/ ,
'team-uidesign' : /team.*ui.*design|UI.*设计.*团队|dual.*track.*design|团队.*UI/ ,
// Standard workflows
'multi-cli-plan ' : /multi.*cli|多.*CLI|多模型.*协作|multi.*model.*collab/ ,
'multi-cli' : /multi.*cli|多.*CLI|多模型.*协作|multi.*model.*collab/ ,
'bugfix' : /fix|bug|error|crash|fail|debug/ ,
'issue-batch' : /issues?|batch/ && /fix|resolve/ ,
'issue-transition' : /issue workflow|structured workflow|queue|multi-stage/ ,
@@ -165,6 +146,7 @@ function detectTaskType(text) {
'ui-design' : /ui|design|component|style/ ,
'tdd' : /tdd|test-driven|test first/ ,
'test-fix' : /test fail|fix test|failing test/ ,
'test-gen' : /generate test|写测试|add test|补充测试/ ,
'review' : /review|code review/ ,
'documentation' : /docs|documentation|readme/
} ;
@@ -202,34 +184,29 @@ async function clarifyRequirements(analysis) {
function selectWorkflow ( analysis ) {
const levelMap = {
'bugfix-hotfix' : { level : 2 , flow : 'bugfix.hotfix' } ,
// With-File workflows (documented exploration with multi-CLI collaboration)
'brainstorm' : { level : 4 , flow : 'brainstorm-with-file ' } , // Multi-perspective ideatio n
// With-File workflows → auto chain to lite-plan
'brainstorm' : { level : 4 , flow : 'brainstorm-to-plan ' } , // brainstorm-with-file → lite-pla n
'brainstorm-to-issue' : { level : 4 , flow : 'brainstorm-to-issue' } , // Brainstorm → Issue workflow
'debug-file' : { level : 3 , flow : 'debug-with-file' } , // Hypothesis-driven debugging
'analyze-file' : { level : 3 , flow : 'analyze-with-file ' } , // Collaborative analysis
'debug-file' : { level : 3 , flow : 'debug-with-file' } , // Hypothesis-driven debugging (standalone)
'analyze-file' : { level : 3 , flow : 'analyze-to-plan ' } , // analyze-with-file → lite-plan
'collaborative-plan' : { level : 3 , flow : 'collaborative-plan' } , // Multi-agent collaborative planning
'req-plan ' : { level : 4 , flow : 'req-plan ' } , // Requirement-level roadmap planning
'roadmap ' : { level : 4 , flow : 'roadmap ' } , // roadmap → team-planex
'spec-driven' : { level : 4 , flow : 'spec-driven' } , // spec-generator → plan → execute
// Cycle workflows (self-iterating with reflection)
'integration-test' : { level : 3 , flow : 'integration-test-cycle' } , // Self-iterating integration test
'refactor' : { level : 3 , flow : 'refactor-cycle' } , // Tech debt discovery and refactoring
// Team workflows (multi-role collaboration )
'integration-test' : { level : 3 , flow : 'integration-test-cycle' } ,
'refactor' : { level : 3 , flow : 'refactor-cycle' } ,
// Team workflows (kept: team-planex only )
'team-planex' : { level : 'Team' , flow : 'team-planex' } ,
'team-iterdev' : { level : 'Team' , flow : 'team-iterdev' } ,
'team-lifecycle' : { level : 'Team' , flow : 'team-lifecycle' } ,
'team-issue' : { level : 'Team' , flow : 'team-issue' } ,
'team-testing' : { level : 'Team' , flow : 'team-testing' } ,
'team-qa' : { level : 'Team' , flow : 'team-qa' } ,
'team-brainstorm' : { level : 'Team' , flow : 'team-brainstorm' } ,
'team-uidesign' : { level : 'Team' , flow : 'team-uidesign' } ,
// Standard workflows
'multi-cli-plan ' : { level : 3 , flow : 'multi-cli-plan' } , // Multi-CLI collaborative planning
'multi-cli' : { level : 3 , flow : 'multi-cli-plan' } ,
'bugfix' : { level : 2 , flow : 'bugfix.standard' } ,
'issue-batch' : { level : 'Issue' , flow : 'issue' } ,
'issue-transition' : { level : 2.5 , flow : 'rapid-to-issue' } , // Bridge workflow
'issue-transition' : { level : 2.5 , flow : 'rapid-to-issue' } ,
'exploration' : { level : 4 , flow : 'full' } ,
'quick-task' : { level : 2 , flow : 'rapid' } ,
'ui-design' : { level : analysis . complexity === 'high' ? 4 : 3 , flow : 'ui' } ,
'tdd' : { level : 3 , flow : 'tdd' } ,
'test-gen' : { level : 3 , flow : 'test-gen' } ,
'test-fix' : { level : 3 , flow : 'test-fix-gen' } ,
'review' : { level : 3 , flow : 'review-cycle-fix' } ,
'documentation' : { level : 2 , flow : 'docs' } ,
@@ -281,18 +258,15 @@ function buildCommandChain(workflow, analysis) {
{ cmd : 'workflow-lite-plan' , args : ` " ${ analysis . goal } " ` }
] ,
// With-File workflows (documented exploration with multi-CLI collaboration)
'brainstorm-with-file ' : [
{ cmd : 'workflow:brainstorm -with-file' , args : ` " ${ analysis . goal } " ` }
// Note: Has built-in post-completion options (create plan, create issue, deep analysis )
// With-File → Auto Chain to lite-plan
'analyze-to-plan ' : [
{ cmd : 'workflow:analyze -with-file' , args : ` " ${ analysis . goal } " ` } ,
{ cmd : 'workflow-lite-plan' , args : '' } // auto receives analysis artifacts (discussion.md )
] ,
// B rainstorm-to-Issue workflow (bridge from brainstorm to issue execution)
'brainstorm-to-issue' : [
// Note: Assumes brainstorm session already exists, or run brainstorm first
{ cmd : 'issue:from-brainstorm' , args : ` SESSION=" ${ extractBrainstormSession ( analysis ) } " --auto ` } ,
{ cmd : 'issue:queue' , args : '' } ,
{ cmd : 'issue:execute' , args : '--queue auto' }
'b rainstorm-to-plan' : [
{ cmd : 'workflow:brainstorm-with-file' , args : ` " ${ analysis . goal } " ` } ,
{ cmd : 'workflow-lite-plan' , args : '' } // auto receives brainstorm artifacts ( brainstorm.md)
] ,
'debug-with-file' : [
@@ -300,32 +274,22 @@ function buildCommandChain(workflow, analysis) {
// Note: Self-contained with hypothesis-driven iteration and Gemini validation
] ,
'analyze-with-file' : [
{ cmd : 'workflow:analyze-with-file' , args : ` " ${ analysis . goal } " ` }
// Note: Self-contained with multi-round discussion and CLI exploration
// Brainstorm-to-Issue workflow (bridge from brainstorm to issue execution)
'brainstorm-to-issue' : [
{ cmd : 'issue:from-brainstorm' , args : ` SESSION=" ${ extractBrainstormSession ( analysis ) } " --auto ` } ,
{ cmd : 'issue:queue' , args : '' } ,
{ cmd : 'issue:execute' , args : '--queue auto' }
] ,
// Universal Plan+Execute
'collaborative-plan' : [
{ cmd : 'workflow:collaborative-plan-with-file' , args : ` " ${ analysis . goal } " ` } ,
{ cmd : 'workflow:unified-execute-with-file' , args : '' }
// Note: Plan Note → unified execution engine
] ,
'req-plan ' : [
{ cmd : 'workflow:req-plan -with-file' , args : ` " ${ analysis . goal } " ` } ,
'roadmap ' : [
{ cmd : 'workflow:roadmap -with-file' , args : ` " ${ analysis . goal } " ` } ,
{ cmd : 'team-planex' , args : '' }
// Note: Requirement decomposition → issue creation → team-planex wave execution
] ,
// Cycle workflows (self-iterating with reflection)
'integration-test-cycle' : [
{ cmd : 'workflow:integration-test-cycle' , args : ` " ${ analysis . goal } " ` }
// Note: Self-contained explore → test → fix cycle with reflection
] ,
'refactor-cycle' : [
{ cmd : 'workflow:refactor-cycle' , args : ` " ${ analysis . goal } " ` }
// Note: Self-contained tech debt discovery → refactor → validate
] ,
// Level 3 - Standard
@@ -338,11 +302,25 @@ function buildCommandChain(workflow, analysis) {
] )
] ,
// Level 4 - Spec-Driven Full Pipeline
'spec-driven' : [
{ cmd : 'spec-generator' , args : ` " ${ analysis . goal } " ` } ,
{ cmd : 'workflow-plan' , args : '' } ,
{ cmd : 'workflow-execute' , args : '' } ,
... ( analysis . constraints ? . includes ( 'skip-tests' ) ? [ ] : [
{ cmd : 'workflow-test-fix' , args : '' }
] )
] ,
'tdd' : [
{ cmd : 'workflow-tdd-plan' , args : ` " ${ analysis . goal } " ` } ,
{ cmd : 'workflow-execute' , args : '' }
] ,
'test-gen' : [
{ cmd : 'workflow-test-fix' , args : ` " ${ analysis . goal } " ` }
] ,
'test-fix-gen' : [
{ cmd : 'workflow-test-fix' , args : ` " ${ analysis . goal } " ` }
] ,
@@ -360,7 +338,7 @@ function buildCommandChain(workflow, analysis) {
{ cmd : 'workflow-execute' , args : '' }
] ,
// Level 4 - Full
// Level 4 - Full Exploration
'full' : [
{ cmd : 'brainstorm' , args : ` " ${ analysis . goal } " ` } ,
{ cmd : 'workflow-plan' , args : '' } ,
@@ -370,6 +348,15 @@ function buildCommandChain(workflow, analysis) {
] )
] ,
// Cycle workflows (self-iterating with reflection)
'integration-test-cycle' : [
{ cmd : 'workflow:integration-test-cycle' , args : ` " ${ analysis . goal } " ` }
] ,
'refactor-cycle' : [
{ cmd : 'workflow:refactor-cycle' , args : ` " ${ analysis . goal } " ` }
] ,
// Issue Workflow
'issue' : [
{ cmd : 'issue:discover' , args : '' } ,
@@ -378,37 +365,9 @@ function buildCommandChain(workflow, analysis) {
{ cmd : 'issue:execute' , args : '' }
] ,
// Team Workflows (multi-role collaboration, self-contained )
// Team Workflows (kept: team-planex only )
'team-planex' : [
{ cmd : 'team-planex' , args : ` " ${ analysis . goal } " ` }
] ,
'team-iterdev' : [
{ cmd : 'team-iterdev' , args : ` " ${ analysis . goal } " ` }
] ,
'team-lifecycle' : [
{ cmd : 'team-lifecycle' , args : ` " ${ analysis . goal } " ` }
] ,
'team-issue' : [
{ cmd : 'team-issue' , args : ` " ${ analysis . goal } " ` }
] ,
'team-testing' : [
{ cmd : 'team-testing' , args : ` " ${ analysis . goal } " ` }
] ,
'team-qa' : [
{ cmd : 'team-quality-assurance' , args : ` " ${ analysis . goal } " ` }
] ,
'team-brainstorm' : [
{ cmd : 'team-brainstorm' , args : ` " ${ analysis . goal } " ` }
] ,
'team-uidesign' : [
{ cmd : 'team-uidesign' , args : ` " ${ analysis . goal } " ` }
]
} ;
@@ -607,7 +566,7 @@ Phase 1: Analyze Intent
+-- If clarity < 2 -> Phase 1.5: Clarify Requirements
|
Phase 2: Select Workflow & Build Chain
|-- Map task_type -> Level (1/ 2/3/4/Issue)
|-- Map task_type -> Level (2/3/4/Issue/Team )
|-- Select flow based on complexity
+-- Build command chain (Skill-based)
|
@@ -639,12 +598,13 @@ Phase 5: Execute Command Chain
| "Add API endpoint" | feature (low) | 2 | workflow-lite-plan → workflow-test-fix |
| "Fix login timeout" | bugfix | 2 | workflow-lite-plan → workflow-test-fix |
| "Use issue workflow" | issue-transition | 2.5 | workflow-lite-plan(plan-only) → convert-to-plan → queue → execute |
| "头脑风暴: 通知系统重构" | brainstorm | 4 | workflow:brainstorm-with-file |
| "从头脑风暴创建 issue" | brainstorm-to-issue | 4 | issue:from-brainstorm → issue:queue → issue:execute |
| "协作分析: 认证架构" | analyze-file | 3 | analyze-with-file → workflow-lite-plan |
| "深度调试 WebSocket" | debug-file | 3 | workflow:debug-with-file |
| "协作分析: 认证架构优化" | analyze -file | 3 | workflow:analyze-with-file |
| "头脑风暴: 通知系统" | brainstorm | 4 | brainstorm-with -file → workflow-lite-plan |
| "从头脑风暴创建 issue" | brainstorm-to-issue | 4 | issue:from-brainstorm → issue:queue → issue:execute |
| "协作规划: 实时通知系统" | collaborative-plan | 3 | collaborative-plan-with-file → unified-execute-with-file |
| "需求规划 : OAuth + 2FA" | req-plan | 4 | req-plan -with-file → team-planex |
| "需求路线图 : OAuth + 2FA" | roadmap | 4 | roadmap -with-file → team-planex |
| "specification: 用户系统" | spec-driven | 4 | spec-generator → workflow-plan → workflow-execute → workflow-test-fix |
| "集成测试: 支付流程" | integration-test | 3 | workflow:integration-test-cycle |
| "重构 auth 模块" | refactor | 3 | workflow:refactor-cycle |
| "multi-cli plan: API设计" | multi-cli-plan | 3 | workflow-multi-cli-plan → workflow-test-fix |
@@ -652,13 +612,6 @@ Phase 5: Execute Command Chain
| "Implement with TDD" | tdd | 3 | workflow-tdd-plan → workflow-execute |
| "Uncertain: real-time" | exploration | 4 | brainstorm → workflow-plan → workflow-execute → workflow-test-fix |
| "team planex: 用户系统" | team-planex | Team | team-planex |
| "迭代开发团队: 支付模块" | team-iterdev | Team | team-iterdev |
| "全生命周期: 通知服务" | team-lifecycle | Team | team-lifecycle |
| "team resolve issue #42 " | team-issue | Team | team-issue |
| "测试团队: 全面测试认证" | team-testing | Team | team-testing |
| "QA 团队: 质量保障支付" | team-qa | Team | team-quality-assurance |
| "团队头脑风暴: API 设计" | team-brainstorm | Team | team-brainstorm |
| "团队 UI 设计: 仪表盘" | team-uidesign | Team | team-uidesign |
---
@@ -668,10 +621,11 @@ Phase 5: Execute Command Chain
2. **Intent-Driven ** - Auto-select workflow based on task intent
3. **Skill-Based Chaining ** - Build command chain by composing independent Skills
4. **Self-Contained Skills ** - 每个 Skill 内部处理完整流水线,是天然的最小执行单元
5. **Progressive Clarification ** - Low clarity triggers clarification phase
6. **TODO Tracking ** - Use CCW prefix to isolate workflow todos
7. **Error Handling ** - Retry/skip/abort at Skill level
8. **User Control ** - Optional user confirmation at each phase
5. **Auto Chain ** - With-File 产物自动传递给下游 Skill( 如 analyze → lite-plan)
6. **Progressive Clarification ** - Low clarity triggers clarification phase
7. **TODO Tracking ** - Use CCW prefix to isolate workflow todos
8. **Error Handling ** - Retry/skip/abort at Skill level
9. **User Control ** - Optional user confirmation at each phase
---
@@ -715,114 +669,51 @@ todos = [
"complexity" : "medium"
} ,
"command_chain" : [
{
"index" : 0 ,
"command" : "workflow-lite-plan" ,
"status" : "completed"
} ,
{
"index" : 1 ,
"command" : "workflow-test-fix" ,
"status" : "running"
}
{ "index" : 0 , "command" : "workflow-lite-plan" , "status" : "completed" } ,
{ "index" : 1 , "command" : "workflow-test-fix" , "status" : "running" }
] ,
"current_index" : 1
}
```
**Status Values ** :
- `running` : Workflow executing commands
- `completed` : All commands finished
- `failed` : User aborted or unrecoverable error
- `error` : Command execution failed (during error handling)
**Command Status Values ** :
- `pending` : Not started
- `running` : Currently executing
- `completed` : Successfully finished
- `failed` : Execution failed
**Status Values ** : `running` | `completed` | `failed` | `error`
**Command Status Values ** : `pending` | `running` | `completed` | `failed`
---
## With-File Workflows
**With-File workflows ** provide documented exploration with multi-CLI collaboration. They are self-contained and generate comprehensive session artifacts.
**With-File workflows ** provide documented exploration with multi-CLI collaboration. They generate comprehensive session artifacts and can auto-chain to lite-plan for implementation .
| Workflow | Purpose | Key Features | Output Folder |
|----------|---------|-------------- |---------------|
| **brainstorm-with-file ** | Multi-perspective ideation | Gemini/Codex/Claude perspectives, diverge-converge cycles | `.workflow/.brainstorm/` |
| **debug-with-file ** | Hypothesis-driven debugging | Gemini validation, understanding evolution, NDJSON logging | `.workflow/.debug/` |
| **analyze-with-file ** | Collaborative analysis | Multi-round Q&A, CLI exploration, documented discussions | `.workflow/.analysis/` |
| **collaborative-plan-with-file ** | Multi-agent collaborative planning | Understanding agent + parallel agents, Plan Note shared doc | `.workflow/.planning/` |
| **req-plan -with-file ** | R equirement roadmap planning | Requirement decomposition, issue creation, execution-plan.json | `.workflow/.planning/` |
| Workflow | Purpose | Auto Chain | Output Folder |
|----------|---------|------------|---------------|
| **brainstorm-with-file ** | Multi-perspective ideation | → workflow-lite-plan (auto) | `.workflow/.brainstorm/` |
| **debug-with-file ** | Hypothesis-driven debugging | Standalone (self-contained) | `.workflow/.debug/` |
| **analyze-with-file ** | Collaborative analysis | → workflow-lite-plan (auto) | `.workflow/.analysis/` |
| **collaborative-plan-with-file ** | Multi-agent collaborative planning | → unified-execute-with-file | `.workflow/.planning/` |
| **roadmap -with-file ** | Strategic r equirement roadmap | → team-planex | `.workflow/.planning/` |
**Auto Chain Mechanism ** : When `analyze-with-file` or `brainstorm-with-file` completes, its artifacts (discussion.md / brainstorm.md) are automatically passed to `workflow-lite-plan` as context input. No user intervention needed.
**Detection Keywords ** :
- **brainstorm**: 头脑风暴, 创意, 发散思维, multi-perspective, compare perspectives
- **debug-file**: 深度调试, 假设验证, systematic debug, hypothesis debug
- **analyze-file**: 协作分析, 深度理解, collaborative analysis, explore concept
- **collaborative-plan**: 协作规划, 多人规划, collaborative plan, multi-agent plan, Plan Note
- **req-plan **: roadmap, 需求规划, 需求拆解, requirement plan, progressive plan
**Characteristics ** :
1. **Self-Contained ** : Each workflow handles its own iteration loop
2. **Documented Process ** : Creates evolving documents (brainstorm.md, understanding.md, discussion.md)
3. **Multi-CLI ** : Uses Gemini/Codex/Claude for different perspectives
4. **Built-in Post-Completion ** : Offers follow-up options (create plan, issue, etc.)
---
## Team Workflows
**Team workflows ** provide multi-role collaboration for complex tasks. Each team skill is self-contained with internal role routing via `--role=xxx` .
| Workflow | Roles | Pipeline | Use Case |
|----------|-------|----------|----------|
| **team-planex ** | planner + executor | wave pipeline( 边规划边执行) | 需要并行规划和执行的任务 |
| **team-iterdev ** | planner → developer → reviewer | 迭代开发循环 | 需要多轮迭代的开发任务 |
| **team-lifecycle ** | spec → impl → test | 全生命周期 | 从需求到测试的完整流程 |
| **team-issue ** | discover → plan → execute | issue 解决 | 多角色协作解决 issue |
| **team-testing ** | strategy → generate → execute → analyze | 测试流水线 | 全面测试覆盖 |
| **team-quality-assurance ** | scout → strategist → generator → executor → analyst | QA 闭环 | 质量保障全流程 |
| **team-brainstorm ** | facilitator → participants → synthesizer | 团队头脑风暴 | 多角色协作头脑风暴 |
| **team-uidesign ** | designer → implementer | dual-track 设计+实现 | UI 设计与实现并行 |
**Detection Keywords ** :
- **team-planex**: team planex, 团队规划执行, wave pipeline
- **team-iterdev**: team iterdev, 迭代开发团队, iterative dev team
- **team-lifecycle**: team lifecycle, 全生命周期, full lifecycle
- **team-issue**: team issue, 团队 issue, team resolve issue
- **team-testing**: team test, 测试团队, comprehensive test team
- **team-qa**: team qa, QA 团队, 质量保障团队
- **team-brainstorm**: team brainstorm, 团队头脑风暴, team ideation
- **team-uidesign**: team ui design, UI 设计团队, dual track design
**Characteristics ** :
1. **Self-Contained ** : Each team skill handles internal role coordination
2. **Role-Based Routing ** : All roles invoke the same skill with `--role=xxx`
3. **Shared Memory ** : Roles communicate via shared-memory.json and message bus
4. **Auto Mode Support ** : All team skills support `-y` /`--yes` for skip confirmations
- **roadmap **: roadmap, 需求规划, 需求拆解, requirement plan, progressive plan
- **spec-driven**: specification, PRD, 产品需求, 产品文档
---
## Cycle Workflows
**Cycle workflows ** provide self-iterating development cycles with reflection-driven strategy adjustment. Each cycle is autonomous with built-in test-fix loops and quality gates.
**Cycle workflows ** provide self-iterating development cycles with reflection-driven strategy adjustment.
| Workflow | Pipeline | Key Features | Output Folder |
|----------|----------|--------------|---------------|
| **integration-test-cycle ** | explore → test dev → test-fix → reflection | Self-iterating with max-iterations, auto continue | `.workflow/.test-cycle/` |
| **refactor-cycle ** | discover → prioritize → execute → validate | Multi-dimensional analysis, regression validation | `.workflow/.refactor-cycle/` |
**Detection Keywords ** :
- **integration-test**: integration test, 集成测试, 端到端测试, e2e test
- **refactor**: refactor, 重构, tech debt, 技术债务
**Characteristics ** :
1. **Self-Iterating ** : Autonomous test-fix loops until quality gate passes
2. **Reflection-Driven ** : Strategy adjusts based on previous iteration results
3. **Continue Support ** : `--continue` flag to resume interrupted sessions
4. **Auto Mode Support ** : `-y` /`--yes` for fully autonomous execution
---
## Utility Commands
@@ -831,10 +722,11 @@ todos = [
| Command | Purpose |
|---------|---------|
| `workflow:unified-execute-with-file` | Universal execution engine - consumes plan output from collaborative-plan, req-plan , brainstorm |
| `workflow:unified-execute-with-file` | Universal execution engine - consumes plan output from collaborative-plan, roadmap , brainstorm |
| `workflow:clean` | Intelligent code cleanup - mainline detection, stale artifact removal |
| `workflow:init` | Initialize `.workflow/project-tech.json` with project analysis |
| `workflow:init-guidelines` | Interactive wizard to fill `specs/*.md` |
| `workflow:status` | Generate on-demand views for project overview and workflow tasks |
---
@@ -848,9 +740,6 @@ todos = [
/ccw -y "Add user authentication"
/ccw --yes "Fix memory leak in WebSocket handler"
# Complex requirement (triggers clarification)
/ccw "Optimize system performance"
# Bug fix
/ccw "Fix memory leak in WebSocket handler"
@@ -863,35 +752,31 @@ todos = [
# Multi-CLI collaborative planning
/ccw "multi-cli plan: 支付网关API设计" # → workflow-multi-cli-plan → workflow-test-fix
# With-File workflows (documented exploration with multi-CLI collaboration)
/ccw "头脑风暴: 用户通知系统重新设计" # → brainstorm-with-file
# With-File workflows → auto chain to lite-plan
/ccw "协作分析: 理解现有认证架构的设计决策" # → analyze-with-file → workflow-lite-plan
/ccw "头脑风暴: 用户通知系统重新设计" # → brainstorm-with-file → workflow-lite-plan
/ccw "深度调试: 系统随机崩溃问题" # → debug-with-file (standalone)
/ccw "从头脑风暴 BS-通知系统-2025-01-28 创建 issue" # → brainstorm-to-issue (bridge)
/ccw "深度调试: 系统随机崩溃问题" # → debug-with-file
/ccw "协作分析: 理解现有认证架构的设计决策" # → analyze-with-file
# Team workflows (multi-role collaboration)
/ccw "team planex: 用户认证系统" # → team-planex (planner + executor wave pipeline)
/ccw "迭代开发团队: 支付模块重构" # → team-iterdev (planner → developer → reviewer)
/ccw "全生命周期: 通知服务开发" # → team-lifecycle (spec → impl → test)
/ccw "team resolve issue #42" # → team-issue (discover → plan → execute)
/ccw "测试团队: 全面测试认证模块" # → team-testing (strategy → generate → execute → analyze)
/ccw "QA 团队: 质量保障支付流程" # → team-quality-assurance (scout → strategist → generator → executor → analyst)
/ccw "团队头脑风暴: API 网关设计" # → team-brainstorm (facilitator → participants → synthesizer)
/ccw "团队 UI 设计: 管理后台仪表盘" # → team-uidesign (designer → implementer dual-track)
# Spec-driven full pipeline
/ccw "specification: 用户认证系统产品文档" # → spec-generator → workflow-plan → workflow-execute → workflow-test-fix
# Collaborative planning & requirement workflows
/ccw "协作规划: 实时通知系统架构" # → collaborative-plan-with-file → unified-execute
/ccw "需求规划 : 用户认证 OAuth + 2FA" # → req-plan -with-file → team-planex
/ccw "roadmap: 数据导出功能路线图" # → req-plan -with-file → team-planex
/ccw "需求路线图 : 用户认证 OAuth + 2FA" # → roadmap -with-file → team-planex
/ccw "roadmap: 数据导出功能路线图" # → roadmap -with-file → team-planex
# Team workflows (kept: team-planex)
/ccw "team planex: 用户认证系统" # → team-planex (planner + executor wave pipeline)
# Cycle workflows (self-iterating)
/ccw "集成测试: 支付流程端到端" # → integration-test-cycle
/ccw "重构 auth 模块的技术债务" # → refactor-cycle
/ccw "tech debt: 清理支付服务" # → refactor-cycle
# Utility commands (invoked directly, not auto-routed)
# /workflow:unified-execute-with-file # 通用执行引擎(消费 plan 输出)
# /workflow:clean # 智能代码清理
# /workflow:init # 初始化项目状态
# /workflow:init-guidelines # 交互式填充项目规范
# /workflow:status # 项目概览和工作流状态
```