claude-code-workflow 6.3.44 → 6.3.47
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/ccw-coordinator.md +944 -0
- package/.claude/commands/ccw.md +486 -0
- package/ccw/dist/tools/command-registry.d.ts +77 -0
- package/ccw/dist/tools/command-registry.d.ts.map +1 -0
- package/ccw/dist/tools/command-registry.js +265 -0
- package/ccw/dist/tools/command-registry.js.map +1 -0
- package/ccw/dist/tools/command-registry.test.d.ts +14 -0
- package/ccw/dist/tools/command-registry.test.d.ts.map +1 -0
- package/ccw/dist/tools/command-registry.test.js.map +1 -0
- package/ccw/dist/tools/index.d.ts +2 -0
- package/ccw/dist/tools/index.d.ts.map +1 -1
- package/ccw/dist/tools/index.js +2 -0
- package/ccw/dist/tools/index.js.map +1 -1
- package/ccw/src/tools/command-registry.test.ts +669 -0
- package/ccw/src/tools/command-registry.ts +308 -0
- package/ccw/src/tools/index.ts +4 -0
- package/codex-lens/README.md +59 -0
- package/codex-lens/pyproject.toml +1 -1
- package/package.json +1 -1
- package/.claude/skills/ccw/SKILL.md +0 -522
- package/.claude/skills/ccw/command.json +0 -641
- package/.claude/skills/ccw-coordinator/README.md +0 -45
- package/.claude/skills/ccw-coordinator/SKILL.md +0 -320
- package/.claude/skills/ccw-coordinator/phases/actions/action-abort.md +0 -9
- package/.claude/skills/ccw-coordinator/phases/actions/action-command-build.md +0 -40
- package/.claude/skills/ccw-coordinator/phases/actions/action-command-execute.md +0 -124
- package/.claude/skills/ccw-coordinator/phases/actions/action-command-selection.md +0 -48
- package/.claude/skills/ccw-coordinator/phases/actions/action-complete.md +0 -25
- package/.claude/skills/ccw-coordinator/phases/actions/action-init.md +0 -26
- package/.claude/skills/ccw-coordinator/phases/orchestrator.md +0 -59
- package/.claude/skills/ccw-coordinator/phases/state-schema.md +0 -66
- package/.claude/skills/ccw-coordinator/skill-config.json +0 -66
- package/.claude/skills/ccw-coordinator/specs/command-library.md +0 -169
- package/.claude/skills/ccw-coordinator/specs/specs.md +0 -362
- package/.claude/skills/ccw-coordinator/tools/README.md +0 -95
- package/.claude/skills/ccw-coordinator/tools/chain-validate.cjs +0 -320
- package/.claude/skills/ccw-coordinator/tools/command-registry.cjs +0 -255
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
# State Schema
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
interface State {
|
|
5
|
-
session_id: string;
|
|
6
|
-
status: 'pending' | 'running' | 'executing' | 'completed' | 'aborted';
|
|
7
|
-
started_at: string;
|
|
8
|
-
task_description: string; // 用户任务描述
|
|
9
|
-
command_chain: Command[];
|
|
10
|
-
current_command_index: number;
|
|
11
|
-
execution_results: ExecutionResult[];
|
|
12
|
-
confirmed: boolean;
|
|
13
|
-
error_count: number;
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
interface Command {
|
|
17
|
-
id: string;
|
|
18
|
-
order: number;
|
|
19
|
-
command: string;
|
|
20
|
-
status: 'pending' | 'running' | 'completed' | 'failed';
|
|
21
|
-
result?: ExecutionResult;
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
interface ExecutionResult {
|
|
25
|
-
command: string;
|
|
26
|
-
status: 'success' | 'failed';
|
|
27
|
-
exit_code: number;
|
|
28
|
-
output?: string;
|
|
29
|
-
summary?: { // 提取的关键产物
|
|
30
|
-
session?: string;
|
|
31
|
-
files?: string[];
|
|
32
|
-
timestamp: string;
|
|
33
|
-
};
|
|
34
|
-
}
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## 状态转移
|
|
38
|
-
|
|
39
|
-
```
|
|
40
|
-
pending → running → executing → completed
|
|
41
|
-
↓ ↓
|
|
42
|
-
(abort) (error → abort)
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## 初始化
|
|
46
|
-
|
|
47
|
-
```javascript
|
|
48
|
-
{
|
|
49
|
-
session_id: generateId(),
|
|
50
|
-
status: 'pending',
|
|
51
|
-
started_at: new Date().toISOString(),
|
|
52
|
-
task_description: '', // 从用户输入获取
|
|
53
|
-
command_chain: [],
|
|
54
|
-
current_command_index: 0,
|
|
55
|
-
execution_results: [],
|
|
56
|
-
confirmed: false,
|
|
57
|
-
error_count: 0
|
|
58
|
-
}
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
## 更新
|
|
62
|
-
|
|
63
|
-
- 添加命令: `command_chain.push(cmd)`
|
|
64
|
-
- 确认执行: `confirmed = true, status = 'executing'`
|
|
65
|
-
- 记录执行: `execution_results.push(...), current_command_index++`
|
|
66
|
-
- 错误计数: `error_count++`
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"skill_name": "ccw-coordinator",
|
|
3
|
-
"display_name": "CCW Coordinator",
|
|
4
|
-
"description": "Interactive command orchestration - select, build, and execute workflow command chains",
|
|
5
|
-
"execution_mode": "autonomous",
|
|
6
|
-
"version": "1.0.0",
|
|
7
|
-
"triggers": [
|
|
8
|
-
"coordinator",
|
|
9
|
-
"ccw-coordinator",
|
|
10
|
-
"命令编排",
|
|
11
|
-
"command chain"
|
|
12
|
-
],
|
|
13
|
-
"allowed_tools": [
|
|
14
|
-
"Task",
|
|
15
|
-
"AskUserQuestion",
|
|
16
|
-
"Read",
|
|
17
|
-
"Write",
|
|
18
|
-
"Bash"
|
|
19
|
-
],
|
|
20
|
-
"actions": [
|
|
21
|
-
{
|
|
22
|
-
"id": "action-init",
|
|
23
|
-
"name": "Init",
|
|
24
|
-
"description": "Initialize orchestration session"
|
|
25
|
-
},
|
|
26
|
-
{
|
|
27
|
-
"id": "action-command-selection",
|
|
28
|
-
"name": "Select Commands",
|
|
29
|
-
"description": "Interactive command selection from library"
|
|
30
|
-
},
|
|
31
|
-
{
|
|
32
|
-
"id": "action-command-build",
|
|
33
|
-
"name": "Build Chain",
|
|
34
|
-
"description": "Adjust and confirm command chain"
|
|
35
|
-
},
|
|
36
|
-
{
|
|
37
|
-
"id": "action-command-execute",
|
|
38
|
-
"name": "Execute",
|
|
39
|
-
"description": "Execute command chain sequentially"
|
|
40
|
-
},
|
|
41
|
-
{
|
|
42
|
-
"id": "action-complete",
|
|
43
|
-
"name": "Complete",
|
|
44
|
-
"description": "Generate final report"
|
|
45
|
-
},
|
|
46
|
-
{
|
|
47
|
-
"id": "action-abort",
|
|
48
|
-
"name": "Abort",
|
|
49
|
-
"description": "Abort session and save state"
|
|
50
|
-
}
|
|
51
|
-
],
|
|
52
|
-
"termination_conditions": [
|
|
53
|
-
"user_exit",
|
|
54
|
-
"task_completed",
|
|
55
|
-
"error"
|
|
56
|
-
],
|
|
57
|
-
"output": {
|
|
58
|
-
"location": ".workflow/.ccw-coordinator/{timestamp}",
|
|
59
|
-
"artifacts": [
|
|
60
|
-
"state.json",
|
|
61
|
-
"command-chain.json",
|
|
62
|
-
"execution-log.md",
|
|
63
|
-
"final-report.md"
|
|
64
|
-
]
|
|
65
|
-
}
|
|
66
|
-
}
|
|
@@ -1,169 +0,0 @@
|
|
|
1
|
-
# Command Library
|
|
2
|
-
|
|
3
|
-
CCW Coordinator 支持的命令库。基于 CCW workflow 命令系统。
|
|
4
|
-
|
|
5
|
-
## Command Categories
|
|
6
|
-
|
|
7
|
-
### Planning Commands
|
|
8
|
-
|
|
9
|
-
| Command | Description | Level |
|
|
10
|
-
|---------|-------------|-------|
|
|
11
|
-
| `/workflow:lite-plan` | 轻量级规划 | L2 |
|
|
12
|
-
| `/workflow:plan` | 标准规划 | L3 |
|
|
13
|
-
| `/workflow:multi-cli-plan` | 多CLI协作规划 | L2 |
|
|
14
|
-
| `/workflow:brainstorm:auto-parallel` | 头脑风暴规划 | L4 |
|
|
15
|
-
| `/workflow:tdd-plan` | TDD规划 | L3 |
|
|
16
|
-
|
|
17
|
-
### Execution Commands
|
|
18
|
-
|
|
19
|
-
| Command | Description | Level |
|
|
20
|
-
|---------|-------------|-------|
|
|
21
|
-
| `/workflow:lite-execute` | 轻量级执行 | L2 |
|
|
22
|
-
| `/workflow:execute` | 标准执行 | L3 |
|
|
23
|
-
| `/workflow:test-cycle-execute` | 测试循环执行 | L3 |
|
|
24
|
-
|
|
25
|
-
### BugFix Commands
|
|
26
|
-
|
|
27
|
-
| Command | Description | Level |
|
|
28
|
-
|---------|-------------|-------|
|
|
29
|
-
| `/workflow:lite-fix` | 轻量级修复 | L2 |
|
|
30
|
-
| `/workflow:lite-fix --hotfix` | 紧急修复 | L2 |
|
|
31
|
-
|
|
32
|
-
### Testing Commands
|
|
33
|
-
|
|
34
|
-
| Command | Description | Level |
|
|
35
|
-
|---------|-------------|-------|
|
|
36
|
-
| `/workflow:test-gen` | 测试生成 | L3 |
|
|
37
|
-
| `/workflow:test-fix-gen` | 测试修复生成 | L3 |
|
|
38
|
-
| `/workflow:tdd-verify` | TDD验证 | L3 |
|
|
39
|
-
|
|
40
|
-
### Review Commands
|
|
41
|
-
|
|
42
|
-
| Command | Description | Level |
|
|
43
|
-
|---------|-------------|-------|
|
|
44
|
-
| `/workflow:review-session-cycle` | 会话审查 | L3 |
|
|
45
|
-
| `/workflow:review-module-cycle` | 模块审查 | L3 |
|
|
46
|
-
| `/workflow:review-fix` | 审查修复 | L3 |
|
|
47
|
-
| `/workflow:plan-verify` | 计划验证 | L3 |
|
|
48
|
-
|
|
49
|
-
### Documentation Commands
|
|
50
|
-
|
|
51
|
-
| Command | Description | Level |
|
|
52
|
-
|---------|-------------|-------|
|
|
53
|
-
| `/memory:docs` | 生成文档 | L2 |
|
|
54
|
-
| `/memory:update-related` | 更新相关文档 | L2 |
|
|
55
|
-
| `/memory:update-full` | 全面更新文档 | L2 |
|
|
56
|
-
|
|
57
|
-
### Issue Commands
|
|
58
|
-
|
|
59
|
-
| Command | Description | Level |
|
|
60
|
-
|---------|-------------|-------|
|
|
61
|
-
| `/issue:discover` | 发现Issue | Supplementary |
|
|
62
|
-
| `/issue:discover-by-prompt` | 基于提示发现Issue | Supplementary |
|
|
63
|
-
| `/issue:plan --all-pending` | 规划所有待处理Issue | Supplementary |
|
|
64
|
-
| `/issue:queue` | 排队Issue | Supplementary |
|
|
65
|
-
| `/issue:execute` | 执行Issue | Supplementary |
|
|
66
|
-
|
|
67
|
-
## Command Chains (Recommended)
|
|
68
|
-
|
|
69
|
-
### 标准开发流程
|
|
70
|
-
|
|
71
|
-
```
|
|
72
|
-
1. /workflow:lite-plan
|
|
73
|
-
2. /workflow:lite-execute
|
|
74
|
-
3. /workflow:test-cycle-execute
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
### 完整规划流程
|
|
78
|
-
|
|
79
|
-
```
|
|
80
|
-
1. /workflow:plan
|
|
81
|
-
2. /workflow:plan-verify
|
|
82
|
-
3. /workflow:execute
|
|
83
|
-
4. /workflow:review-session-cycle
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
### TDD 流程
|
|
87
|
-
|
|
88
|
-
```
|
|
89
|
-
1. /workflow:tdd-plan
|
|
90
|
-
2. /workflow:execute
|
|
91
|
-
3. /workflow:tdd-verify
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
### Issue 批处理流程
|
|
95
|
-
|
|
96
|
-
```
|
|
97
|
-
1. /issue:plan --all-pending
|
|
98
|
-
2. /issue:queue
|
|
99
|
-
3. /issue:execute
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
## JSON Format
|
|
103
|
-
|
|
104
|
-
```json
|
|
105
|
-
{
|
|
106
|
-
"workflow_commands": [
|
|
107
|
-
{
|
|
108
|
-
"category": "Planning",
|
|
109
|
-
"commands": [
|
|
110
|
-
{ "name": "/workflow:lite-plan", "description": "轻量级规划" },
|
|
111
|
-
{ "name": "/workflow:plan", "description": "标准规划" },
|
|
112
|
-
{ "name": "/workflow:multi-cli-plan", "description": "多CLI协作规划" },
|
|
113
|
-
{ "name": "/workflow:brainstorm:auto-parallel", "description": "头脑风暴" },
|
|
114
|
-
{ "name": "/workflow:tdd-plan", "description": "TDD规划" }
|
|
115
|
-
]
|
|
116
|
-
},
|
|
117
|
-
{
|
|
118
|
-
"category": "Execution",
|
|
119
|
-
"commands": [
|
|
120
|
-
{ "name": "/workflow:lite-execute", "description": "轻量级执行" },
|
|
121
|
-
{ "name": "/workflow:execute", "description": "标准执行" },
|
|
122
|
-
{ "name": "/workflow:test-cycle-execute", "description": "测试循环执行" }
|
|
123
|
-
]
|
|
124
|
-
},
|
|
125
|
-
{
|
|
126
|
-
"category": "BugFix",
|
|
127
|
-
"commands": [
|
|
128
|
-
{ "name": "/workflow:lite-fix", "description": "轻量级修复" },
|
|
129
|
-
{ "name": "/workflow:lite-fix --hotfix", "description": "紧急修复" }
|
|
130
|
-
]
|
|
131
|
-
},
|
|
132
|
-
{
|
|
133
|
-
"category": "Testing",
|
|
134
|
-
"commands": [
|
|
135
|
-
{ "name": "/workflow:test-gen", "description": "测试生成" },
|
|
136
|
-
{ "name": "/workflow:test-fix-gen", "description": "测试修复" },
|
|
137
|
-
{ "name": "/workflow:tdd-verify", "description": "TDD验证" }
|
|
138
|
-
]
|
|
139
|
-
},
|
|
140
|
-
{
|
|
141
|
-
"category": "Review",
|
|
142
|
-
"commands": [
|
|
143
|
-
{ "name": "/workflow:review-session-cycle", "description": "会话审查" },
|
|
144
|
-
{ "name": "/workflow:review-module-cycle", "description": "模块审查" },
|
|
145
|
-
{ "name": "/workflow:review-fix", "description": "审查修复" },
|
|
146
|
-
{ "name": "/workflow:plan-verify", "description": "计划验证" }
|
|
147
|
-
]
|
|
148
|
-
},
|
|
149
|
-
{
|
|
150
|
-
"category": "Documentation",
|
|
151
|
-
"commands": [
|
|
152
|
-
{ "name": "/memory:docs", "description": "生成文档" },
|
|
153
|
-
{ "name": "/memory:update-related", "description": "更新相关文档" },
|
|
154
|
-
{ "name": "/memory:update-full", "description": "全面更新文档" }
|
|
155
|
-
]
|
|
156
|
-
},
|
|
157
|
-
{
|
|
158
|
-
"category": "Issues",
|
|
159
|
-
"commands": [
|
|
160
|
-
{ "name": "/issue:discover", "description": "发现Issue" },
|
|
161
|
-
{ "name": "/issue:discover-by-prompt", "description": "基于提示发现Issue" },
|
|
162
|
-
{ "name": "/issue:plan --all-pending", "description": "规划所有待处理Issue" },
|
|
163
|
-
{ "name": "/issue:queue", "description": "排队Issue" },
|
|
164
|
-
{ "name": "/issue:execute", "description": "执行Issue" }
|
|
165
|
-
]
|
|
166
|
-
}
|
|
167
|
-
]
|
|
168
|
-
}
|
|
169
|
-
```
|
|
@@ -1,362 +0,0 @@
|
|
|
1
|
-
# CCW Coordinator Specifications
|
|
2
|
-
|
|
3
|
-
命令库、验证规则和注册表一体化规范。
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## 命令库
|
|
8
|
-
|
|
9
|
-
### Planning Commands
|
|
10
|
-
|
|
11
|
-
| Command | Description | Level |
|
|
12
|
-
|---------|-------------|-------|
|
|
13
|
-
| `/workflow:lite-plan` | 轻量级规划 | L2 |
|
|
14
|
-
| `/workflow:plan` | 标准规划 | L3 |
|
|
15
|
-
| `/workflow:multi-cli-plan` | 多CLI协作规划 | L2 |
|
|
16
|
-
| `/workflow:brainstorm:auto-parallel` | 头脑风暴规划 | L4 |
|
|
17
|
-
| `/workflow:tdd-plan` | TDD规划 | L3 |
|
|
18
|
-
|
|
19
|
-
### Execution Commands
|
|
20
|
-
|
|
21
|
-
| Command | Description | Level |
|
|
22
|
-
|---------|-------------|-------|
|
|
23
|
-
| `/workflow:lite-execute` | 轻量级执行 | L2 |
|
|
24
|
-
| `/workflow:execute` | 标准执行 | L3 |
|
|
25
|
-
| `/workflow:test-cycle-execute` | 测试循环执行 | L3 |
|
|
26
|
-
|
|
27
|
-
### BugFix Commands
|
|
28
|
-
|
|
29
|
-
| Command | Description | Level |
|
|
30
|
-
|---------|-------------|-------|
|
|
31
|
-
| `/workflow:lite-fix` | 轻量级修复 | L2 |
|
|
32
|
-
| `/workflow:lite-fix --hotfix` | 紧急修复 | L2 |
|
|
33
|
-
|
|
34
|
-
### Testing Commands
|
|
35
|
-
|
|
36
|
-
| Command | Description | Level |
|
|
37
|
-
|---------|-------------|-------|
|
|
38
|
-
| `/workflow:test-gen` | 测试生成 | L3 |
|
|
39
|
-
| `/workflow:test-fix-gen` | 测试修复生成 | L3 |
|
|
40
|
-
| `/workflow:tdd-verify` | TDD验证 | L3 |
|
|
41
|
-
|
|
42
|
-
### Review Commands
|
|
43
|
-
|
|
44
|
-
| Command | Description | Level |
|
|
45
|
-
|---------|-------------|-------|
|
|
46
|
-
| `/workflow:review-session-cycle` | 会话审查 | L3 |
|
|
47
|
-
| `/workflow:review-module-cycle` | 模块审查 | L3 |
|
|
48
|
-
| `/workflow:review-fix` | 审查修复 | L3 |
|
|
49
|
-
| `/workflow:plan-verify` | 计划验证 | L3 |
|
|
50
|
-
|
|
51
|
-
### Documentation Commands
|
|
52
|
-
|
|
53
|
-
| Command | Description | Level |
|
|
54
|
-
|---------|-------------|-------|
|
|
55
|
-
| `/memory:docs` | 生成文档 | L2 |
|
|
56
|
-
| `/memory:update-related` | 更新相关文档 | L2 |
|
|
57
|
-
| `/memory:update-full` | 全面更新文档 | L2 |
|
|
58
|
-
|
|
59
|
-
### Issue Commands
|
|
60
|
-
|
|
61
|
-
| Command | Description |
|
|
62
|
-
|---------|-------------|
|
|
63
|
-
| `/issue:discover` | 发现Issue |
|
|
64
|
-
| `/issue:discover-by-prompt` | 基于提示发现Issue |
|
|
65
|
-
| `/issue:plan --all-pending` | 规划所有待处理Issue |
|
|
66
|
-
| `/issue:queue` | 排队Issue |
|
|
67
|
-
| `/issue:execute` | 执行Issue |
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## 命令链推荐
|
|
72
|
-
|
|
73
|
-
### 标准开发流程
|
|
74
|
-
|
|
75
|
-
```
|
|
76
|
-
1. /workflow:lite-plan
|
|
77
|
-
2. /workflow:lite-execute
|
|
78
|
-
3. /workflow:test-cycle-execute
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
### 完整规划流程
|
|
82
|
-
|
|
83
|
-
```
|
|
84
|
-
1. /workflow:plan
|
|
85
|
-
2. /workflow:plan-verify
|
|
86
|
-
3. /workflow:execute
|
|
87
|
-
4. /workflow:review-session-cycle
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### TDD 流程
|
|
91
|
-
|
|
92
|
-
```
|
|
93
|
-
1. /workflow:tdd-plan
|
|
94
|
-
2. /workflow:execute
|
|
95
|
-
3. /workflow:tdd-verify
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
### Issue 批处理流程
|
|
99
|
-
|
|
100
|
-
```
|
|
101
|
-
1. /issue:plan --all-pending
|
|
102
|
-
2. /issue:queue
|
|
103
|
-
3. /issue:execute
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
108
|
-
## 验证规则
|
|
109
|
-
|
|
110
|
-
### Rule 1: Single Planning Command
|
|
111
|
-
|
|
112
|
-
每条链最多包含一个规划命令。
|
|
113
|
-
|
|
114
|
-
| 有效 | 无效 |
|
|
115
|
-
|------|------|
|
|
116
|
-
| `plan → execute` | `plan → lite-plan → execute` |
|
|
117
|
-
|
|
118
|
-
### Rule 2: Compatible Pairs
|
|
119
|
-
|
|
120
|
-
规划和执行命令必须兼容。
|
|
121
|
-
|
|
122
|
-
| Planning | Execution | 兼容 |
|
|
123
|
-
|----------|-----------|------|
|
|
124
|
-
| lite-plan | lite-execute | ✓ |
|
|
125
|
-
| lite-plan | execute | ✗ |
|
|
126
|
-
| multi-cli-plan | lite-execute | ✓ |
|
|
127
|
-
| multi-cli-plan | execute | ✓ |
|
|
128
|
-
| plan | execute | ✓ |
|
|
129
|
-
| plan | lite-execute | ✗ |
|
|
130
|
-
| tdd-plan | execute | ✓ |
|
|
131
|
-
| tdd-plan | lite-execute | ✗ |
|
|
132
|
-
|
|
133
|
-
### Rule 3: Testing After Execution
|
|
134
|
-
|
|
135
|
-
测试命令必须在执行命令之后。
|
|
136
|
-
|
|
137
|
-
| 有效 | 无效 |
|
|
138
|
-
|------|------|
|
|
139
|
-
| `execute → test-cycle-execute` | `test-cycle-execute → execute` |
|
|
140
|
-
|
|
141
|
-
### Rule 4: Review After Execution
|
|
142
|
-
|
|
143
|
-
审查命令必须在执行命令之后。
|
|
144
|
-
|
|
145
|
-
| 有效 | 无效 |
|
|
146
|
-
|------|------|
|
|
147
|
-
| `execute → review-session-cycle` | `review-session-cycle → execute` |
|
|
148
|
-
|
|
149
|
-
### Rule 5: BugFix Standalone
|
|
150
|
-
|
|
151
|
-
`lite-fix` 必须单独执行,不能与其他命令组合。
|
|
152
|
-
|
|
153
|
-
| 有效 | 无效 |
|
|
154
|
-
|------|------|
|
|
155
|
-
| `lite-fix` | `plan → lite-fix → execute` |
|
|
156
|
-
| `lite-fix --hotfix` | `lite-fix → test-cycle-execute` |
|
|
157
|
-
|
|
158
|
-
### Rule 6: Dependency Satisfaction
|
|
159
|
-
|
|
160
|
-
每个命令的依赖必须在前面执行。
|
|
161
|
-
|
|
162
|
-
```javascript
|
|
163
|
-
test-fix-gen → test-cycle-execute ✓
|
|
164
|
-
test-cycle-execute ✗
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
### Rule 7: No Redundancy
|
|
168
|
-
|
|
169
|
-
链条中不能有重复的命令。
|
|
170
|
-
|
|
171
|
-
| 有效 | 无效 |
|
|
172
|
-
|------|------|
|
|
173
|
-
| `plan → execute → test` | `plan → plan → execute` |
|
|
174
|
-
|
|
175
|
-
### Rule 8: Command Exists
|
|
176
|
-
|
|
177
|
-
所有命令必须在此规范中定义。
|
|
178
|
-
|
|
179
|
-
---
|
|
180
|
-
|
|
181
|
-
## 反模式(避免)
|
|
182
|
-
|
|
183
|
-
### ❌ Pattern 1: Multiple Planning
|
|
184
|
-
|
|
185
|
-
```
|
|
186
|
-
plan → lite-plan → execute
|
|
187
|
-
```
|
|
188
|
-
**问题**: 重复分析,浪费时间
|
|
189
|
-
**修复**: 选一个规划命令
|
|
190
|
-
|
|
191
|
-
### ❌ Pattern 2: Test Without Context
|
|
192
|
-
|
|
193
|
-
```
|
|
194
|
-
test-cycle-execute (独立执行)
|
|
195
|
-
```
|
|
196
|
-
**问题**: 没有执行上下文,无法工作
|
|
197
|
-
**修复**: 先执行 `execute` 或 `test-fix-gen`
|
|
198
|
-
|
|
199
|
-
### ❌ Pattern 3: BugFix with Planning
|
|
200
|
-
|
|
201
|
-
```
|
|
202
|
-
plan → execute → lite-fix
|
|
203
|
-
```
|
|
204
|
-
**问题**: lite-fix 是独立命令,不应与规划混合
|
|
205
|
-
**修复**: 用 `lite-fix` 单独修复,或用 `plan → execute` 做大改
|
|
206
|
-
|
|
207
|
-
### ❌ Pattern 4: Review Without Changes
|
|
208
|
-
|
|
209
|
-
```
|
|
210
|
-
review-session-cycle (独立执行)
|
|
211
|
-
```
|
|
212
|
-
**问题**: 没有 git 改动可审查
|
|
213
|
-
**修复**: 先执行 `execute` 生成改动
|
|
214
|
-
|
|
215
|
-
### ❌ Pattern 5: TDD Misuse
|
|
216
|
-
|
|
217
|
-
```
|
|
218
|
-
tdd-plan → lite-execute
|
|
219
|
-
```
|
|
220
|
-
**问题**: lite-execute 无法处理 TDD 任务结构
|
|
221
|
-
**修复**: 用 `tdd-plan → execute → tdd-verify`
|
|
222
|
-
|
|
223
|
-
---
|
|
224
|
-
|
|
225
|
-
## 命令注册表
|
|
226
|
-
|
|
227
|
-
### 命令元数据结构
|
|
228
|
-
|
|
229
|
-
```json
|
|
230
|
-
{
|
|
231
|
-
"command_name": {
|
|
232
|
-
"category": "Planning|Execution|Testing|Review|BugFix|Maintenance",
|
|
233
|
-
"level": "L0|L1|L2|L3",
|
|
234
|
-
"description": "命令描述",
|
|
235
|
-
"inputs": ["input1", "input2"],
|
|
236
|
-
"outputs": ["output1", "output2"],
|
|
237
|
-
"dependencies": ["依赖命令"],
|
|
238
|
-
"parameters": [
|
|
239
|
-
{"name": "--flag", "type": "string|boolean|number", "default": "value"}
|
|
240
|
-
],
|
|
241
|
-
"chain_position": "start|middle|middle_or_end|end|standalone",
|
|
242
|
-
"next_recommended": ["推荐的下一个命令"]
|
|
243
|
-
}
|
|
244
|
-
}
|
|
245
|
-
```
|
|
246
|
-
|
|
247
|
-
### 命令分组
|
|
248
|
-
|
|
249
|
-
| Group | Commands |
|
|
250
|
-
|-------|----------|
|
|
251
|
-
| planning | lite-plan, multi-cli-plan, plan, tdd-plan |
|
|
252
|
-
| execution | lite-execute, execute, develop-with-file |
|
|
253
|
-
| testing | test-gen, test-fix-gen, test-cycle-execute, tdd-verify |
|
|
254
|
-
| review | review-session-cycle, review-module-cycle, review-fix |
|
|
255
|
-
| bugfix | lite-fix, debug, debug-with-file |
|
|
256
|
-
| maintenance | clean, replan |
|
|
257
|
-
| verification | plan-verify, tdd-verify |
|
|
258
|
-
|
|
259
|
-
### 兼容性矩阵
|
|
260
|
-
|
|
261
|
-
| 组合 | 状态 |
|
|
262
|
-
|------|------|
|
|
263
|
-
| lite-plan + lite-execute | ✓ compatible |
|
|
264
|
-
| lite-plan + execute | ✗ incompatible - use plan |
|
|
265
|
-
| multi-cli-plan + lite-execute | ✓ compatible |
|
|
266
|
-
| plan + execute | ✓ compatible |
|
|
267
|
-
| plan + lite-execute | ✗ incompatible - use lite-plan |
|
|
268
|
-
| tdd-plan + execute | ✓ compatible |
|
|
269
|
-
| execute + test-cycle-execute | ✓ compatible |
|
|
270
|
-
| lite-execute + test-cycle-execute | ✓ compatible |
|
|
271
|
-
| test-fix-gen + test-cycle-execute | ✓ required |
|
|
272
|
-
| review-session-cycle + review-fix | ✓ compatible |
|
|
273
|
-
| lite-fix + test-cycle-execute | ✗ incompatible - lite-fix standalone |
|
|
274
|
-
|
|
275
|
-
---
|
|
276
|
-
|
|
277
|
-
## 验证工具
|
|
278
|
-
|
|
279
|
-
### chain-validate.cjs
|
|
280
|
-
|
|
281
|
-
位置: `tools/chain-validate.cjs`
|
|
282
|
-
|
|
283
|
-
验证命令链合法性:
|
|
284
|
-
|
|
285
|
-
```bash
|
|
286
|
-
node tools/chain-validate.cjs plan execute test-cycle-execute
|
|
287
|
-
```
|
|
288
|
-
|
|
289
|
-
输出:
|
|
290
|
-
```
|
|
291
|
-
{
|
|
292
|
-
"valid": true,
|
|
293
|
-
"errors": [],
|
|
294
|
-
"warnings": []
|
|
295
|
-
}
|
|
296
|
-
```
|
|
297
|
-
|
|
298
|
-
## 命令注册表
|
|
299
|
-
|
|
300
|
-
### 工具位置
|
|
301
|
-
|
|
302
|
-
位置: `tools/command-registry.cjs` (skill 内置)
|
|
303
|
-
|
|
304
|
-
### 工作模式
|
|
305
|
-
|
|
306
|
-
**按需提取**: 只提取用户确定的任务链中的命令,不是全量扫描。
|
|
307
|
-
|
|
308
|
-
```javascript
|
|
309
|
-
// 用户任务链: [lite-plan, lite-execute]
|
|
310
|
-
const commandNames = command_chain.map(cmd => cmd.command);
|
|
311
|
-
const commandMeta = registry.getCommands(commandNames);
|
|
312
|
-
// 只提取这 2 个命令的元数据
|
|
313
|
-
```
|
|
314
|
-
|
|
315
|
-
### 功能
|
|
316
|
-
|
|
317
|
-
- 自动查找全局 `.claude/commands/workflow` 目录(相对路径 > 用户 home)
|
|
318
|
-
- 按需提取指定命令的 YAML 头元数据
|
|
319
|
-
- 缓存机制避免重复读取
|
|
320
|
-
- 提供批量查询接口
|
|
321
|
-
|
|
322
|
-
### 集成方式
|
|
323
|
-
|
|
324
|
-
在 action-command-execute 中自动集成:
|
|
325
|
-
|
|
326
|
-
```javascript
|
|
327
|
-
const CommandRegistry = require('./tools/command-registry.cjs');
|
|
328
|
-
const registry = new CommandRegistry();
|
|
329
|
-
|
|
330
|
-
// 只提取任务链中的命令
|
|
331
|
-
const commandNames = command_chain.map(cmd => cmd.command);
|
|
332
|
-
const commandMeta = registry.getCommands(commandNames);
|
|
333
|
-
|
|
334
|
-
// 使用元数据生成提示词
|
|
335
|
-
const cmdInfo = commandMeta[cmd.command];
|
|
336
|
-
// {
|
|
337
|
-
// name: 'lite-plan',
|
|
338
|
-
// description: '轻量级规划...',
|
|
339
|
-
// argumentHint: '[-e|--explore] "task description"',
|
|
340
|
-
// allowedTools: [...],
|
|
341
|
-
// filePath: '...'
|
|
342
|
-
// }
|
|
343
|
-
```
|
|
344
|
-
|
|
345
|
-
### 提示词生成
|
|
346
|
-
|
|
347
|
-
智能提示词自动包含:
|
|
348
|
-
|
|
349
|
-
1. **任务上下文**: 用户任务描述
|
|
350
|
-
2. **前序产物**: 已完成命令的产物信息
|
|
351
|
-
3. **命令元数据**: 命令的参数提示和描述
|
|
352
|
-
|
|
353
|
-
```
|
|
354
|
-
任务: 实现用户注册功能
|
|
355
|
-
|
|
356
|
-
前序完成:
|
|
357
|
-
- /workflow:lite-plan: WFS-plan-001 (IMPL_PLAN.md)
|
|
358
|
-
|
|
359
|
-
命令: /workflow:lite-execute [--resume-session="session-id"]
|
|
360
|
-
```
|
|
361
|
-
|
|
362
|
-
详见 `tools/README.md`。
|