claude-code-workflow 6.3.43 → 6.3.46

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.
Files changed (78) hide show
  1. package/.claude/agents/tdd-developer.md +530 -0
  2. package/.claude/commands/ccw-coordinator.md +1042 -0
  3. package/.claude/commands/ccw.md +486 -0
  4. package/.claude/commands/issue/discover-by-prompt.md +5 -1
  5. package/.claude/commands/issue/discover.md +472 -468
  6. package/.claude/commands/issue/execute.md +580 -581
  7. package/.claude/commands/issue/new.md +417 -413
  8. package/.claude/commands/issue/plan.md +5 -1
  9. package/.claude/commands/issue/queue.md +445 -441
  10. package/.claude/commands/task/breakdown.md +207 -203
  11. package/.claude/commands/task/replan.md +440 -436
  12. package/.claude/commands/workflow/action-plan-verify.md +485 -447
  13. package/.claude/commands/workflow/brainstorm/artifacts.md +457 -453
  14. package/.claude/commands/workflow/brainstorm/auto-parallel.md +5 -1
  15. package/.claude/commands/workflow/brainstorm/synthesis.md +402 -398
  16. package/.claude/commands/workflow/clean.md +67 -35
  17. package/.claude/commands/workflow/debug-with-file.md +670 -666
  18. package/.claude/commands/workflow/debug.md +331 -327
  19. package/.claude/commands/workflow/develop-with-file.md +5 -1
  20. package/.claude/commands/workflow/execute.md +546 -498
  21. package/.claude/commands/workflow/lite-execute.md +44 -26
  22. package/.claude/commands/workflow/lite-fix.md +780 -730
  23. package/.claude/commands/workflow/lite-lite-lite.md +5 -1
  24. package/.claude/commands/workflow/lite-plan.md +87 -39
  25. package/.claude/commands/workflow/multi-cli-plan.md +572 -568
  26. package/.claude/commands/workflow/plan-verify.md +527 -0
  27. package/.claude/commands/workflow/plan.md +555 -551
  28. package/.claude/commands/workflow/replan.md +572 -515
  29. package/.claude/commands/workflow/review-fix.md +608 -610
  30. package/.claude/commands/workflow/session/complete.md +37 -14
  31. package/.claude/commands/workflow/session/solidify.md +303 -299
  32. package/.claude/commands/workflow/tdd-plan.md +630 -597
  33. package/.claude/commands/workflow/tdd-verify.md +391 -206
  34. package/.claude/commands/workflow/tools/conflict-resolution.md +24 -12
  35. package/.claude/commands/workflow/tools/task-generate-agent.md +583 -563
  36. package/.claude/commands/workflow/tools/task-generate-tdd.md +749 -517
  37. package/.claude/commands/workflow/ui-design/animation-extract.md +1154 -1150
  38. package/.claude/commands/workflow/ui-design/layout-extract.md +792 -788
  39. package/.claude/commands/workflow/ui-design/style-extract.md +777 -773
  40. package/.claude/skills/ccw-help/command.json +5 -5
  41. package/.claude/skills/ccw-help/scripts/analyze_commands.py +337 -337
  42. package/.claude/workflows/cli-templates/prompts/workflow-impl-plan-template.txt +1 -1
  43. package/ccw/dist/commands/issue.d.ts +4 -0
  44. package/ccw/dist/commands/issue.d.ts.map +1 -1
  45. package/ccw/dist/commands/issue.js +73 -6
  46. package/ccw/dist/commands/issue.js.map +1 -1
  47. package/ccw/dist/core/routes/cli-routes.d.ts.map +1 -1
  48. package/ccw/dist/core/routes/cli-routes.js +32 -28
  49. package/ccw/dist/core/routes/cli-routes.js.map +1 -1
  50. package/ccw/dist/tools/claude-cli-tools.d.ts +10 -0
  51. package/ccw/dist/tools/claude-cli-tools.d.ts.map +1 -1
  52. package/ccw/dist/tools/claude-cli-tools.js +45 -0
  53. package/ccw/dist/tools/claude-cli-tools.js.map +1 -1
  54. package/ccw/dist/tools/codex-lens.d.ts.map +1 -1
  55. package/ccw/dist/tools/codex-lens.js +38 -11
  56. package/ccw/dist/tools/codex-lens.js.map +1 -1
  57. package/ccw/dist/tools/command-registry.d.ts +77 -0
  58. package/ccw/dist/tools/command-registry.d.ts.map +1 -0
  59. package/ccw/dist/tools/command-registry.js +265 -0
  60. package/ccw/dist/tools/command-registry.js.map +1 -0
  61. package/ccw/dist/tools/command-registry.test.d.ts +14 -0
  62. package/ccw/dist/tools/command-registry.test.d.ts.map +1 -0
  63. package/ccw/dist/tools/command-registry.test.js.map +1 -0
  64. package/ccw/dist/tools/index.d.ts +2 -0
  65. package/ccw/dist/tools/index.d.ts.map +1 -1
  66. package/ccw/dist/tools/index.js +2 -0
  67. package/ccw/dist/tools/index.js.map +1 -1
  68. package/ccw/src/commands/issue.ts +84 -6
  69. package/ccw/src/core/routes/cli-routes.ts +30 -25
  70. package/ccw/src/templates/dashboard-js/views/help.js +1 -1
  71. package/ccw/src/tools/claude-cli-tools.ts +50 -0
  72. package/ccw/src/tools/codex-lens.ts +40 -11
  73. package/ccw/src/tools/command-registry.test.ts +669 -0
  74. package/ccw/src/tools/command-registry.ts +308 -0
  75. package/ccw/src/tools/index.ts +4 -0
  76. package/package.json +1 -1
  77. package/.claude/skills/ccw/SKILL.md +0 -522
  78. package/.claude/skills/ccw/command.json +0 -641
@@ -1,515 +1,572 @@
1
- ---
2
- name: replan
3
- description: Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning
4
- argument-hint: "[--session session-id] [task-id] \"requirements\"|file.md [--interactive]"
5
- allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*)
6
- ---
7
-
8
- # Workflow Replan Command
9
-
10
- ## Overview
11
- Intelligently replans workflow sessions or individual tasks with interactive boundary clarification and comprehensive artifact updates.
12
-
13
- **Core Capabilities**:
14
- - **Session Replan**: Updates multiple artifacts (IMPL_PLAN.md, TODO_LIST.md, task JSONs)
15
- - **Task Replan**: Focused updates within session context
16
- - **Interactive Clarification**: Guided questioning to define modification boundaries
17
- - **Impact Analysis**: Automatic detection of affected files and dependencies
18
- - **Backup Management**: Preserves previous versions with restore capability
19
-
20
- ## Operation Modes
21
-
22
- ### Session Replan Mode
23
-
24
- ```bash
25
- # Auto-detect active session
26
- /workflow:replan "添加双因素认证支持"
27
-
28
- # Explicit session
29
- /workflow:replan --session WFS-oauth "添加双因素认证支持"
30
-
31
- # File-based input
32
- /workflow:replan --session WFS-oauth requirements-update.md
33
-
34
- # Interactive mode
35
- /workflow:replan --interactive
36
- ```
37
-
38
- ### Task Replan Mode
39
-
40
- ```bash
41
- # Direct task update
42
- /workflow:replan IMPL-1 "修改为使用 OAuth2.0 标准"
43
-
44
- # Task with explicit session
45
- /workflow:replan --session WFS-oauth IMPL-2 "增加单元测试覆盖率到 90%"
46
-
47
- # Interactive mode
48
- /workflow:replan IMPL-1 --interactive
49
- ```
50
-
51
- ## Execution Process
52
-
53
- ```
54
- Input Parsing:
55
- ├─ Parse flags: --session, --interactive
56
- └─ Detect mode: task-id present → Task mode | Otherwise → Session mode
57
-
58
- Phase 1: Mode Detection & Session Discovery
59
- ├─ Detect operation mode (Task vs Session)
60
- ├─ Discover/validate session (--session flag or auto-detect)
61
- └─ Load session context (workflow-session.json, IMPL_PLAN.md, TODO_LIST.md)
62
-
63
- Phase 2: Interactive Requirement Clarification
64
- └─ Decision (by mode):
65
- ├─ Session mode → 3-4 questions (scope, modules, changes, dependencies)
66
- └─ Task mode → 2 questions (update type, ripple effect)
67
-
68
- Phase 3: Impact Analysis & Planning
69
- ├─ Analyze required changes
70
- ├─ Generate modification plan
71
- └─ User confirmation (Execute / Adjust / Cancel)
72
-
73
- Phase 4: Backup Creation
74
- └─ Backup all affected files with manifest
75
-
76
- Phase 5: Apply Modifications
77
- ├─ Update IMPL_PLAN.md (if needed)
78
- ├─ Update TODO_LIST.md (if needed)
79
- ├─ Update/Create/Delete task JSONs
80
- └─ Update session metadata
81
-
82
- Phase 6: Verification & Summary
83
- ├─ Validate consistency (JSON validity, task limits, acyclic dependencies)
84
- └─ Generate change summary
85
- ```
86
-
87
- ## Execution Lifecycle
88
-
89
- ### Input Parsing
90
-
91
- **Parse flags**:
92
- ```javascript
93
- const sessionFlag = $ARGUMENTS.match(/--session\s+(\S+)/)?.[1]
94
- const interactive = $ARGUMENTS.includes('--interactive')
95
- const taskIdMatch = $ARGUMENTS.match(/\b(IMPL-\d+(?:\.\d+)?)\b/)
96
- const taskId = taskIdMatch?.[1]
97
- ```
98
-
99
- ### Phase 1: Mode Detection & Session Discovery
100
-
101
- **Process**:
102
- 1. **Detect Operation Mode**:
103
- - Check if task ID provided (IMPL-N or IMPL-N.M format) → Task mode
104
- - Otherwise → Session mode
105
-
106
- 2. **Discover/Validate Session**:
107
- - Use `--session` flag if provided
108
- - Otherwise auto-detect from `.workflow/active/`
109
- - Validate session exists
110
-
111
- 3. **Load Session Context**:
112
- - Read `workflow-session.json`
113
- - List existing tasks
114
- - Read `IMPL_PLAN.md` and `TODO_LIST.md`
115
-
116
- **Output**: Session validated, context loaded, mode determined
117
-
118
- ---
119
-
120
- ### Phase 2: Interactive Requirement Clarification
121
-
122
- **Purpose**: Define modification scope through guided questioning
123
-
124
- #### Session Mode Questions
125
-
126
- **Q1: Modification Scope**
127
- ```javascript
128
- Options:
129
- - 仅更新任务细节 (tasks_only)
130
- - 修改规划方案 (plan_update)
131
- - 重构任务结构 (task_restructure)
132
- - 全面重规划 (comprehensive)
133
- ```
134
-
135
- **Q2: Affected Modules** (if scope >= plan_update)
136
- ```javascript
137
- Options: Dynamically generated from existing tasks' focus_paths
138
- - 认证模块 (src/auth)
139
- - 用户管理 (src/user)
140
- - 全部模块
141
- ```
142
-
143
- **Q3: Task Changes** (if scope >= task_restructure)
144
- ```javascript
145
- Options:
146
- - 添加/删除任务 (add_remove)
147
- - 合并/拆分任务 (merge_split)
148
- - 仅更新内容 (update_only)
149
- // Note: Max 4 options for AskUserQuestion
150
- ```
151
-
152
- **Q4: Dependency Changes**
153
- ```javascript
154
- Options:
155
- - 是,需要重新梳理依赖
156
- - 否,保持现有依赖
157
- ```
158
-
159
- #### Task Mode Questions
160
-
161
- **Q1: Update Type**
162
- ```javascript
163
- Options:
164
- - 需求和验收标准 (requirements & acceptance)
165
- - 实现方案 (implementation_approach)
166
- - 文件范围 (focus_paths)
167
- - 依赖关系 (depends_on)
168
- - 全部更新
169
- ```
170
-
171
- **Q2: Ripple Effect**
172
- ```javascript
173
- Options:
174
- - 是,需要同步更新依赖任务
175
- - 否,仅影响当前任务
176
- - 不确定,请帮我分析
177
- ```
178
-
179
- **Output**: User selections stored, modification boundaries defined
180
-
181
- ---
182
-
183
- ### Phase 3: Impact Analysis & Planning
184
-
185
- **Step 3.1: Analyze Required Changes**
186
-
187
- Determine affected files based on clarification:
188
-
189
- ```typescript
190
- interface ImpactAnalysis {
191
- affected_files: {
192
- impl_plan: boolean;
193
- todo_list: boolean;
194
- session_meta: boolean;
195
- tasks: string[];
196
- };
197
-
198
- operations: {
199
- type: 'create' | 'update' | 'delete' | 'merge' | 'split';
200
- target: string;
201
- reason: string;
202
- }[];
203
-
204
- backup_strategy: {
205
- timestamp: string;
206
- files: string[];
207
- };
208
- }
209
- ```
210
-
211
- **Step 3.2: Generate Modification Plan**
212
-
213
- ```markdown
214
- ## 修改计划
215
-
216
- ### 影响范围
217
- - [ ] IMPL_PLAN.md: 更新技术方案第 3
218
- - [ ] TODO_LIST.md: 添加 2 个新任务,删除 1 个废弃任务
219
- - [ ] IMPL-001.json: 更新实现方案
220
- - [ ] workflow-session.json: 更新任务计数
221
-
222
- ### 变更操作
223
- 1. **创建**: IMPL-004.json (双因素认证实现)
224
- 2. **更新**: IMPL-001.json (添加 2FA 准备工作)
225
- 3. **删除**: IMPL-003.json (已被新方案替代)
226
- ```
227
-
228
- **Step 3.3: User Confirmation**
229
-
230
- ```javascript
231
- Options:
232
- - 确认执行: 开始应用所有修改
233
- - 调整计划: 重新回答问题调整范围
234
- - 取消操作: 放弃本次重规划
235
- ```
236
-
237
- **Output**: Modification plan confirmed or adjusted
238
-
239
- ---
240
-
241
- ### Phase 4: Backup Creation
242
-
243
- **Process**:
244
-
245
- 1. **Create Backup Directory**:
246
- ```bash
247
- timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S")
248
- backup_dir=".workflow/active/$SESSION_ID/.process/backup/replan-$timestamp"
249
- mkdir -p "$backup_dir"
250
- ```
251
-
252
- 2. **Backup All Affected Files**:
253
- - IMPL_PLAN.md
254
- - TODO_LIST.md
255
- - workflow-session.json
256
- - Affected task JSONs
257
-
258
- 3. **Create Backup Manifest**:
259
- ```markdown
260
- # Replan Backup Manifest
261
-
262
- **Timestamp**: {timestamp}
263
- **Reason**: {replan_reason}
264
- **Scope**: {modification_scope}
265
-
266
- ## Restoration Command
267
- cp {backup_dir}/* .workflow/active/{session}/
268
- ```
269
-
270
- **Output**: All files safely backed up with manifest
271
-
272
- ---
273
-
274
- ### Phase 5: Apply Modifications
275
-
276
- **Step 5.1: Update IMPL_PLAN.md** (if needed)
277
-
278
- Use Edit tool to modify specific sections:
279
- - Update affected technical sections
280
- - Update modification date
281
-
282
- **Step 5.2: Update TODO_LIST.md** (if needed)
283
-
284
- - Add new tasks with `[ ]` checkbox
285
- - Mark deleted tasks as `[x] ~~task~~ (已废弃)`
286
- - Update modified task descriptions
287
-
288
- **Step 5.3: Update Task JSONs**
289
-
290
- For each affected task:
291
- ```typescript
292
- const updated_task = {
293
- ...task,
294
- context: {
295
- ...task.context,
296
- requirements: [...updated_requirements],
297
- acceptance: [...updated_acceptance]
298
- },
299
- flow_control: {
300
- ...task.flow_control,
301
- implementation_approach: [...updated_steps]
302
- }
303
- };
304
-
305
- Write({
306
- file_path: `.workflow/active/${SESSION_ID}/.task/${task_id}.json`,
307
- content: JSON.stringify(updated_task, null, 2)
308
- });
309
- ```
310
-
311
- **Step 5.4: Create New Tasks** (if needed)
312
-
313
- Generate complete task JSON with all required fields:
314
- - id, title, status
315
- - meta (type, agent)
316
- - context (requirements, focus_paths, acceptance)
317
- - flow_control (pre_analysis, implementation_approach, target_files)
318
-
319
- **Step 5.5: Delete Obsolete Tasks** (if needed)
320
-
321
- Move to backup instead of hard delete:
322
- ```bash
323
- mv ".workflow/active/$SESSION_ID/.task/{task-id}.json" "$backup_dir/"
324
- ```
325
-
326
- **Step 5.6: Update Session Metadata**
327
-
328
- Update workflow-session.json:
329
- - progress.current_tasks
330
- - progress.last_replan
331
- - replan_history array
332
-
333
- **Output**: All modifications applied, artifacts updated
334
-
335
- ---
336
-
337
- ### Phase 6: Verification & Summary
338
-
339
- **Step 6.1: Verify Consistency**
340
-
341
- 1. Validate all task JSONs are valid JSON
342
- 2. Check task count within limits (max 10)
343
- 3. Verify dependency graph is acyclic
344
-
345
- **Step 6.2: Generate Change Summary**
346
-
347
- ```markdown
348
- ## 重规划完成
349
-
350
- ### 会话信息
351
- - **Session**: {session-id}
352
- - **时间**: {timestamp}
353
- - **备份**: {backup-path}
354
-
355
- ### 变更摘要
356
- **范围**: {scope}
357
- **原因**: {reason}
358
-
359
- ### 修改的文件
360
- - ✓ IMPL_PLAN.md: {changes}
361
- - ✓ TODO_LIST.md: {changes}
362
- - ✓ Task JSONs: {count} files updated
363
-
364
- ### 任务变更
365
- - **新增**: {task-ids}
366
- - **删除**: {task-ids}
367
- - **更新**: {task-ids}
368
-
369
- ### 回滚方法
370
- cp {backup-path}/* .workflow/active/{session}/
371
- ```
372
-
373
- **Output**: Summary displayed, replan complete
374
-
375
- ---
376
-
377
- ## TodoWrite Progress Tracking
378
-
379
- ### Session Mode Progress
380
-
381
- ```json
382
- [
383
- {"content": "检测模式和发现会话", "status": "completed", "activeForm": "检测模式和发现会话"},
384
- {"content": "交互式需求明确", "status": "completed", "activeForm": "交互式需求明确"},
385
- {"content": "影响分析和计划生成", "status": "completed", "activeForm": "影响分析和计划生成"},
386
- {"content": "创建备份", "status": "completed", "activeForm": "创建备份"},
387
- {"content": "更新会话产出文件", "status": "completed", "activeForm": "更新会话产出文件"},
388
- {"content": "验证一致性", "status": "completed", "activeForm": "验证一致性"}
389
- ]
390
- ```
391
-
392
- ### Task Mode Progress
393
-
394
- ```json
395
- [
396
- {"content": "检测会话和加载任务", "status": "completed", "activeForm": "检测会话和加载任务"},
397
- {"content": "交互式更新确认", "status": "completed", "activeForm": "交互式更新确认"},
398
- {"content": "应用任务修改", "status": "completed", "activeForm": "应用任务修改"}
399
- ]
400
- ```
401
-
402
- ## Error Handling
403
-
404
- ### Session Errors
405
-
406
- ```bash
407
- # No active session found
408
- ERROR: No active session found
409
- Run /workflow:session:start to create a session
410
-
411
- # Session not found
412
- ERROR: Session WFS-invalid not found
413
- Available sessions: [list]
414
-
415
- # No changes specified
416
- WARNING: No modifications specified
417
- Use --interactive mode or provide requirements
418
- ```
419
-
420
- ### Task Errors
421
-
422
- ```bash
423
- # Task not found
424
- ERROR: Task IMPL-999 not found in session
425
- Available tasks: [list]
426
-
427
- # Task completed
428
- WARNING: Task IMPL-001 is completed
429
- Consider creating new task for additional work
430
-
431
- # Circular dependency
432
- ERROR: Circular dependency detected
433
- Resolve dependency conflicts before proceeding
434
- ```
435
-
436
- ### Validation Errors
437
-
438
- ```bash
439
- # Task limit exceeded
440
- ERROR: Replan would create 12 tasks (limit: 10)
441
- Consider: combining tasks, splitting sessions, or removing tasks
442
-
443
- # Invalid JSON
444
- ERROR: Generated invalid JSON
445
- Backup preserved, rolling back changes
446
- ```
447
-
448
- ## File Structure
449
-
450
- ```
451
- .workflow/active/WFS-session-name/
452
- ├── workflow-session.json
453
- ├── IMPL_PLAN.md
454
- ├── TODO_LIST.md
455
- ├── .task/
456
- │ ├── IMPL-001.json
457
- │ ├── IMPL-002.json
458
- │ └── IMPL-003.json
459
- └── .process/
460
- ├── context-package.json
461
- └── backup/
462
- └── replan-{timestamp}/
463
- ├── MANIFEST.md
464
- ├── IMPL_PLAN.md
465
- ├── TODO_LIST.md
466
- ├── workflow-session.json
467
- └── IMPL-*.json
468
- ```
469
-
470
- ## Examples
471
-
472
- ### Session Replan - Add Feature
473
-
474
- ```bash
475
- /workflow:replan "添加双因素认证支持"
476
-
477
- # Interactive clarification
478
- Q: 修改范围?
479
- A: 全面重规划
480
-
481
- Q: 受影响模块?
482
- A: 认证模块, API接口
483
-
484
- Q: 任务变更?
485
- A: 添加新任务, 更新内容
486
-
487
- # Execution
488
- 创建备份
489
- 更新 IMPL_PLAN.md
490
- 更新 TODO_LIST.md
491
- ✓ 创建 IMPL-004.json
492
- ✓ 更新 IMPL-001.json, IMPL-002.json
493
-
494
- 重规划完成! 新增 1 任务,更新 2 任务
495
- ```
496
-
497
- ### Task Replan - Update Requirements
498
-
499
- ```bash
500
- /workflow:replan IMPL-001 "支持 OAuth2.0 标准"
501
-
502
- # Interactive clarification
503
- Q: 更新部分?
504
- A: 需求和验收标准, 实现方案
505
-
506
- Q: 影响其他任务?
507
- A: 是,需要同步更新依赖任务
508
-
509
- # Execution
510
- 创建备份
511
- 更新 IMPL-001.json
512
- 更新 IMPL-002.json (依赖任务)
513
-
514
- 任务重规划完成! 更新 2 个任务
515
- ```
1
+ ---
2
+ name: replan
3
+ description: Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning
4
+ argument-hint: "[-y|--yes] [--session session-id] [task-id] \"requirements\"|file.md [--interactive]"
5
+ allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*)
6
+ ---
7
+
8
+ # Workflow Replan Command
9
+
10
+ ## Overview
11
+ Intelligently replans workflow sessions or individual tasks with interactive boundary clarification and comprehensive artifact updates.
12
+
13
+ **Core Capabilities**:
14
+ - **Session Replan**: Updates multiple artifacts (IMPL_PLAN.md, TODO_LIST.md, task JSONs)
15
+ - **Task Replan**: Focused updates within session context
16
+ - **Interactive Clarification**: Guided questioning to define modification boundaries
17
+ - **Impact Analysis**: Automatic detection of affected files and dependencies
18
+ - **Backup Management**: Preserves previous versions with restore capability
19
+
20
+ ## Operation Modes
21
+
22
+ ### Session Replan Mode
23
+
24
+ ```bash
25
+ # Auto-detect active session
26
+ /workflow:replan "添加双因素认证支持"
27
+
28
+ # Explicit session
29
+ /workflow:replan --session WFS-oauth "添加双因素认证支持"
30
+
31
+ # File-based input
32
+ /workflow:replan --session WFS-oauth requirements-update.md
33
+
34
+ # Interactive mode
35
+ /workflow:replan --interactive
36
+ ```
37
+
38
+ ### Task Replan Mode
39
+
40
+ ```bash
41
+ # Direct task update
42
+ /workflow:replan IMPL-1 "修改为使用 OAuth2.0 标准"
43
+
44
+ # Task with explicit session
45
+ /workflow:replan --session WFS-oauth IMPL-2 "增加单元测试覆盖率到 90%"
46
+
47
+ # Interactive mode
48
+ /workflow:replan IMPL-1 --interactive
49
+ ```
50
+
51
+ ## Execution Process
52
+
53
+ ```
54
+ Input Parsing:
55
+ ├─ Parse flags: --session, --interactive
56
+ └─ Detect mode: task-id present → Task mode | Otherwise → Session mode
57
+
58
+ Phase 1: Mode Detection & Session Discovery
59
+ ├─ Detect operation mode (Task vs Session)
60
+ ├─ Discover/validate session (--session flag or auto-detect)
61
+ └─ Load session context (workflow-session.json, IMPL_PLAN.md, TODO_LIST.md)
62
+
63
+ Phase 2: Interactive Requirement Clarification
64
+ └─ Decision (by mode):
65
+ ├─ Session mode → 3-4 questions (scope, modules, changes, dependencies)
66
+ └─ Task mode → 2 questions (update type, ripple effect)
67
+
68
+ Phase 3: Impact Analysis & Planning
69
+ ├─ Analyze required changes
70
+ ├─ Generate modification plan
71
+ └─ User confirmation (Execute / Adjust / Cancel)
72
+
73
+ Phase 4: Backup Creation
74
+ └─ Backup all affected files with manifest
75
+
76
+ Phase 5: Apply Modifications
77
+ ├─ Update IMPL_PLAN.md (if needed)
78
+ ├─ Update TODO_LIST.md (if needed)
79
+ ├─ Update/Create/Delete task JSONs
80
+ └─ Update session metadata
81
+
82
+ Phase 6: Verification & Summary
83
+ ├─ Validate consistency (JSON validity, task limits, acyclic dependencies)
84
+ └─ Generate change summary
85
+ ```
86
+
87
+ ## Execution Lifecycle
88
+
89
+ ### Input Parsing
90
+
91
+ **Parse flags**:
92
+ ```javascript
93
+ const sessionFlag = $ARGUMENTS.match(/--session\s+(\S+)/)?.[1]
94
+ const interactive = $ARGUMENTS.includes('--interactive')
95
+ const taskIdMatch = $ARGUMENTS.match(/\b(IMPL-\d+(?:\.\d+)?)\b/)
96
+ const taskId = taskIdMatch?.[1]
97
+ ```
98
+
99
+ ### Phase 1: Mode Detection & Session Discovery
100
+
101
+ **Process**:
102
+ 1. **Detect Operation Mode**:
103
+ - Check if task ID provided (IMPL-N or IMPL-N.M format) → Task mode
104
+ - Otherwise → Session mode
105
+
106
+ 2. **Discover/Validate Session**:
107
+ - Use `--session` flag if provided
108
+ - Otherwise auto-detect from `.workflow/active/`
109
+ - Validate session exists
110
+
111
+ 3. **Load Session Context**:
112
+ - Read `workflow-session.json`
113
+ - List existing tasks
114
+ - Read `IMPL_PLAN.md` and `TODO_LIST.md`
115
+
116
+ **Output**: Session validated, context loaded, mode determined
117
+
118
+ ---
119
+
120
+ ### Auto Mode Support
121
+
122
+ When `--yes` or `-y` flag is used, the command skips interactive clarification and uses safe defaults:
123
+
124
+ ```javascript
125
+ const autoYes = $ARGUMENTS.includes('--yes') || $ARGUMENTS.includes('-y')
126
+ ```
127
+
128
+ **Auto Mode Defaults**:
129
+ - **Modification Scope**: `tasks_only` (safest - only update task details)
130
+ - **Affected Modules**: All modules related to the task
131
+ - **Task Changes**: `update_only` (no structural changes)
132
+ - **Dependency Changes**: `no` (preserve existing dependencies)
133
+ - **User Confirmation**: Auto-confirm execution
134
+
135
+ **Note**: `--interactive` flag overrides `--yes` flag (forces interactive mode).
136
+
137
+ ---
138
+
139
+ ### Phase 2: Interactive Requirement Clarification
140
+
141
+ **Purpose**: Define modification scope through guided questioning
142
+
143
+ **Auto Mode Check**:
144
+ ```javascript
145
+ if (autoYes && !interactive) {
146
+ // Use defaults and skip to Phase 3
147
+ console.log(`[--yes] Using safe defaults for replan:`)
148
+ console.log(` - Scope: tasks_only`)
149
+ console.log(` - Changes: update_only`)
150
+ console.log(` - Dependencies: preserve existing`)
151
+
152
+ userSelections = {
153
+ scope: 'tasks_only',
154
+ modules: 'all_affected',
155
+ task_changes: 'update_only',
156
+ dependency_changes: false
157
+ }
158
+ // Proceed to Phase 3
159
+ }
160
+ ```
161
+
162
+ #### Session Mode Questions
163
+
164
+ **Q1: Modification Scope**
165
+ ```javascript
166
+ Options:
167
+ - 仅更新任务细节 (tasks_only)
168
+ - 修改规划方案 (plan_update)
169
+ - 重构任务结构 (task_restructure)
170
+ - 全面重规划 (comprehensive)
171
+ ```
172
+
173
+ **Q2: Affected Modules** (if scope >= plan_update)
174
+ ```javascript
175
+ Options: Dynamically generated from existing tasks' focus_paths
176
+ - 认证模块 (src/auth)
177
+ - 用户管理 (src/user)
178
+ - 全部模块
179
+ ```
180
+
181
+ **Q3: Task Changes** (if scope >= task_restructure)
182
+ ```javascript
183
+ Options:
184
+ - 添加/删除任务 (add_remove)
185
+ - 合并/拆分任务 (merge_split)
186
+ - 仅更新内容 (update_only)
187
+ // Note: Max 4 options for AskUserQuestion
188
+ ```
189
+
190
+ **Q4: Dependency Changes**
191
+ ```javascript
192
+ Options:
193
+ - 是,需要重新梳理依赖
194
+ - 否,保持现有依赖
195
+ ```
196
+
197
+ #### Task Mode Questions
198
+
199
+ **Q1: Update Type**
200
+ ```javascript
201
+ Options:
202
+ - 需求和验收标准 (requirements & acceptance)
203
+ - 实现方案 (implementation_approach)
204
+ - 文件范围 (focus_paths)
205
+ - 依赖关系 (depends_on)
206
+ - 全部更新
207
+ ```
208
+
209
+ **Q2: Ripple Effect**
210
+ ```javascript
211
+ Options:
212
+ - 是,需要同步更新依赖任务
213
+ - 否,仅影响当前任务
214
+ - 不确定,请帮我分析
215
+ ```
216
+
217
+ **Output**: User selections stored, modification boundaries defined
218
+
219
+ ---
220
+
221
+ ### Phase 3: Impact Analysis & Planning
222
+
223
+ **Step 3.1: Analyze Required Changes**
224
+
225
+ Determine affected files based on clarification:
226
+
227
+ ```typescript
228
+ interface ImpactAnalysis {
229
+ affected_files: {
230
+ impl_plan: boolean;
231
+ todo_list: boolean;
232
+ session_meta: boolean;
233
+ tasks: string[];
234
+ };
235
+
236
+ operations: {
237
+ type: 'create' | 'update' | 'delete' | 'merge' | 'split';
238
+ target: string;
239
+ reason: string;
240
+ }[];
241
+
242
+ backup_strategy: {
243
+ timestamp: string;
244
+ files: string[];
245
+ };
246
+ }
247
+ ```
248
+
249
+ **Step 3.2: Generate Modification Plan**
250
+
251
+ ```markdown
252
+ ## 修改计划
253
+
254
+ ### 影响范围
255
+ - [ ] IMPL_PLAN.md: 更新技术方案第 3 节
256
+ - [ ] TODO_LIST.md: 添加 2 个新任务,删除 1 个废弃任务
257
+ - [ ] IMPL-001.json: 更新实现方案
258
+ - [ ] workflow-session.json: 更新任务计数
259
+
260
+ ### 变更操作
261
+ 1. **创建**: IMPL-004.json (双因素认证实现)
262
+ 2. **更新**: IMPL-001.json (添加 2FA 准备工作)
263
+ 3. **删除**: IMPL-003.json (已被新方案替代)
264
+ ```
265
+
266
+ **Step 3.3: User Confirmation**
267
+
268
+ ```javascript
269
+ // Parse --yes flag
270
+ const autoYes = $ARGUMENTS.includes('--yes') || $ARGUMENTS.includes('-y')
271
+
272
+ if (autoYes) {
273
+ // Auto mode: Auto-confirm execution
274
+ console.log(`[--yes] Auto-confirming replan execution`)
275
+ userConfirmation = '确认执行'
276
+ // Proceed to Phase 4
277
+ } else {
278
+ // Interactive mode: Ask user
279
+ AskUserQuestion({
280
+ questions: [{
281
+ question: "修改计划已生成,请确认操作:",
282
+ header: "Confirm",
283
+ options: [
284
+ { label: "确认执行", description: "开始应用所有修改" },
285
+ { label: "调整计划", description: "重新回答问题调整范围" },
286
+ { label: "取消操作", description: "放弃本次重规划" }
287
+ ],
288
+ multiSelect: false
289
+ }]
290
+ })
291
+ }
292
+ ```
293
+
294
+ **Output**: Modification plan confirmed or adjusted
295
+
296
+ ---
297
+
298
+ ### Phase 4: Backup Creation
299
+
300
+ **Process**:
301
+
302
+ 1. **Create Backup Directory**:
303
+ ```bash
304
+ timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S")
305
+ backup_dir=".workflow/active/$SESSION_ID/.process/backup/replan-$timestamp"
306
+ mkdir -p "$backup_dir"
307
+ ```
308
+
309
+ 2. **Backup All Affected Files**:
310
+ - IMPL_PLAN.md
311
+ - TODO_LIST.md
312
+ - workflow-session.json
313
+ - Affected task JSONs
314
+
315
+ 3. **Create Backup Manifest**:
316
+ ```markdown
317
+ # Replan Backup Manifest
318
+
319
+ **Timestamp**: {timestamp}
320
+ **Reason**: {replan_reason}
321
+ **Scope**: {modification_scope}
322
+
323
+ ## Restoration Command
324
+ cp {backup_dir}/* .workflow/active/{session}/
325
+ ```
326
+
327
+ **Output**: All files safely backed up with manifest
328
+
329
+ ---
330
+
331
+ ### Phase 5: Apply Modifications
332
+
333
+ **Step 5.1: Update IMPL_PLAN.md** (if needed)
334
+
335
+ Use Edit tool to modify specific sections:
336
+ - Update affected technical sections
337
+ - Update modification date
338
+
339
+ **Step 5.2: Update TODO_LIST.md** (if needed)
340
+
341
+ - Add new tasks with `[ ]` checkbox
342
+ - Mark deleted tasks as `[x] ~~task~~ (已废弃)`
343
+ - Update modified task descriptions
344
+
345
+ **Step 5.3: Update Task JSONs**
346
+
347
+ For each affected task:
348
+ ```typescript
349
+ const updated_task = {
350
+ ...task,
351
+ context: {
352
+ ...task.context,
353
+ requirements: [...updated_requirements],
354
+ acceptance: [...updated_acceptance]
355
+ },
356
+ flow_control: {
357
+ ...task.flow_control,
358
+ implementation_approach: [...updated_steps]
359
+ }
360
+ };
361
+
362
+ Write({
363
+ file_path: `.workflow/active/${SESSION_ID}/.task/${task_id}.json`,
364
+ content: JSON.stringify(updated_task, null, 2)
365
+ });
366
+ ```
367
+
368
+ **Step 5.4: Create New Tasks** (if needed)
369
+
370
+ Generate complete task JSON with all required fields:
371
+ - id, title, status
372
+ - meta (type, agent)
373
+ - context (requirements, focus_paths, acceptance)
374
+ - flow_control (pre_analysis, implementation_approach, target_files)
375
+
376
+ **Step 5.5: Delete Obsolete Tasks** (if needed)
377
+
378
+ Move to backup instead of hard delete:
379
+ ```bash
380
+ mv ".workflow/active/$SESSION_ID/.task/{task-id}.json" "$backup_dir/"
381
+ ```
382
+
383
+ **Step 5.6: Update Session Metadata**
384
+
385
+ Update workflow-session.json:
386
+ - progress.current_tasks
387
+ - progress.last_replan
388
+ - replan_history array
389
+
390
+ **Output**: All modifications applied, artifacts updated
391
+
392
+ ---
393
+
394
+ ### Phase 6: Verification & Summary
395
+
396
+ **Step 6.1: Verify Consistency**
397
+
398
+ 1. Validate all task JSONs are valid JSON
399
+ 2. Check task count within limits (max 10)
400
+ 3. Verify dependency graph is acyclic
401
+
402
+ **Step 6.2: Generate Change Summary**
403
+
404
+ ```markdown
405
+ ## 重规划完成
406
+
407
+ ### 会话信息
408
+ - **Session**: {session-id}
409
+ - **时间**: {timestamp}
410
+ - **备份**: {backup-path}
411
+
412
+ ### 变更摘要
413
+ **范围**: {scope}
414
+ **原因**: {reason}
415
+
416
+ ### 修改的文件
417
+ - IMPL_PLAN.md: {changes}
418
+ - ✓ TODO_LIST.md: {changes}
419
+ - ✓ Task JSONs: {count} files updated
420
+
421
+ ### 任务变更
422
+ - **新增**: {task-ids}
423
+ - **删除**: {task-ids}
424
+ - **更新**: {task-ids}
425
+
426
+ ### 回滚方法
427
+ cp {backup-path}/* .workflow/active/{session}/
428
+ ```
429
+
430
+ **Output**: Summary displayed, replan complete
431
+
432
+ ---
433
+
434
+ ## TodoWrite Progress Tracking
435
+
436
+ ### Session Mode Progress
437
+
438
+ ```json
439
+ [
440
+ {"content": "检测模式和发现会话", "status": "completed", "activeForm": "检测模式和发现会话"},
441
+ {"content": "交互式需求明确", "status": "completed", "activeForm": "交互式需求明确"},
442
+ {"content": "影响分析和计划生成", "status": "completed", "activeForm": "影响分析和计划生成"},
443
+ {"content": "创建备份", "status": "completed", "activeForm": "创建备份"},
444
+ {"content": "更新会话产出文件", "status": "completed", "activeForm": "更新会话产出文件"},
445
+ {"content": "验证一致性", "status": "completed", "activeForm": "验证一致性"}
446
+ ]
447
+ ```
448
+
449
+ ### Task Mode Progress
450
+
451
+ ```json
452
+ [
453
+ {"content": "检测会话和加载任务", "status": "completed", "activeForm": "检测会话和加载任务"},
454
+ {"content": "交互式更新确认", "status": "completed", "activeForm": "交互式更新确认"},
455
+ {"content": "应用任务修改", "status": "completed", "activeForm": "应用任务修改"}
456
+ ]
457
+ ```
458
+
459
+ ## Error Handling
460
+
461
+ ### Session Errors
462
+
463
+ ```bash
464
+ # No active session found
465
+ ERROR: No active session found
466
+ Run /workflow:session:start to create a session
467
+
468
+ # Session not found
469
+ ERROR: Session WFS-invalid not found
470
+ Available sessions: [list]
471
+
472
+ # No changes specified
473
+ WARNING: No modifications specified
474
+ Use --interactive mode or provide requirements
475
+ ```
476
+
477
+ ### Task Errors
478
+
479
+ ```bash
480
+ # Task not found
481
+ ERROR: Task IMPL-999 not found in session
482
+ Available tasks: [list]
483
+
484
+ # Task completed
485
+ WARNING: Task IMPL-001 is completed
486
+ Consider creating new task for additional work
487
+
488
+ # Circular dependency
489
+ ERROR: Circular dependency detected
490
+ Resolve dependency conflicts before proceeding
491
+ ```
492
+
493
+ ### Validation Errors
494
+
495
+ ```bash
496
+ # Task limit exceeded
497
+ ERROR: Replan would create 12 tasks (limit: 10)
498
+ Consider: combining tasks, splitting sessions, or removing tasks
499
+
500
+ # Invalid JSON
501
+ ERROR: Generated invalid JSON
502
+ Backup preserved, rolling back changes
503
+ ```
504
+
505
+ ## File Structure
506
+
507
+ ```
508
+ .workflow/active/WFS-session-name/
509
+ ├── workflow-session.json
510
+ ├── IMPL_PLAN.md
511
+ ├── TODO_LIST.md
512
+ ├── .task/
513
+ │ ├── IMPL-001.json
514
+ │ ├── IMPL-002.json
515
+ │ └── IMPL-003.json
516
+ └── .process/
517
+ ├── context-package.json
518
+ └── backup/
519
+ └── replan-{timestamp}/
520
+ ├── MANIFEST.md
521
+ ├── IMPL_PLAN.md
522
+ ├── TODO_LIST.md
523
+ ├── workflow-session.json
524
+ └── IMPL-*.json
525
+ ```
526
+
527
+ ## Examples
528
+
529
+ ### Session Replan - Add Feature
530
+
531
+ ```bash
532
+ /workflow:replan "添加双因素认证支持"
533
+
534
+ # Interactive clarification
535
+ Q: 修改范围?
536
+ A: 全面重规划
537
+
538
+ Q: 受影响模块?
539
+ A: 认证模块, API接口
540
+
541
+ Q: 任务变更?
542
+ A: 添加新任务, 更新内容
543
+
544
+ # Execution
545
+ ✓ 创建备份
546
+ ✓ 更新 IMPL_PLAN.md
547
+ ✓ 更新 TODO_LIST.md
548
+ ✓ 创建 IMPL-004.json
549
+ ✓ 更新 IMPL-001.json, IMPL-002.json
550
+
551
+ 重规划完成! 新增 1 任务,更新 2 任务
552
+ ```
553
+
554
+ ### Task Replan - Update Requirements
555
+
556
+ ```bash
557
+ /workflow:replan IMPL-001 "支持 OAuth2.0 标准"
558
+
559
+ # Interactive clarification
560
+ Q: 更新部分?
561
+ A: 需求和验收标准, 实现方案
562
+
563
+ Q: 影响其他任务?
564
+ A: 是,需要同步更新依赖任务
565
+
566
+ # Execution
567
+ ✓ 创建备份
568
+ ✓ 更新 IMPL-001.json
569
+ ✓ 更新 IMPL-002.json (依赖任务)
570
+
571
+ 任务重规划完成! 更新 2 个任务
572
+ ```