diff --git a/.claude/commands/task/replan.md b/.claude/commands/task/replan.md index 28158fcb..8cb2c2d5 100644 --- a/.claude/commands/task/replan.md +++ b/.claude/commands/task/replan.md @@ -7,6 +7,14 @@ allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*) # Task Replan Command (/task:replan) +> **⚠️ DEPRECATION NOTICE**: This command is maintained for backward compatibility. For new workflows, use `/workflow:replan` which provides: +> - Session-level replanning with comprehensive artifact updates +> - Interactive boundary clarification +> - Updates to IMPL_PLAN.md, TODO_LIST.md, and session metadata +> - Better integration with workflow sessions +> +> **Migration**: Replace `/task:replan IMPL-1 "changes"` with `/workflow:replan IMPL-1 "changes"` + ## Overview Replans individual tasks or batch processes multiple tasks with change tracking and backup management. @@ -14,9 +22,6 @@ Replans individual tasks or batch processes multiple tasks with change tracking - **Single Task Mode**: Replan one task with specific changes - **Batch Mode**: Process multiple tasks from action-plan verification report -## Core Principles -**Task System:** @~/.claude/workflows/task-core.md - ## Key Features - **Single/Batch Operations**: Single task or multiple tasks from verification report - **Multiple Input Sources**: Text, files, or verification report diff --git a/.claude/commands/workflow/replan.md b/.claude/commands/workflow/replan.md new file mode 100644 index 00000000..b1c4fdbe --- /dev/null +++ b/.claude/commands/workflow/replan.md @@ -0,0 +1,470 @@ +--- +name: replan +description: Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning +argument-hint: "[--session session-id] [task-id] \"requirements\"|file.md [--interactive]" +allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*) +--- + +# Workflow Replan Command + +## Overview +Intelligently replans workflow sessions or individual tasks with interactive boundary clarification and comprehensive artifact updates. + +**Core Capabilities**: +- **Session Replan**: Updates multiple artifacts (IMPL_PLAN.md, TODO_LIST.md, task JSONs) +- **Task Replan**: Focused updates within session context +- **Interactive Clarification**: Guided questioning to define modification boundaries +- **Impact Analysis**: Automatic detection of affected files and dependencies +- **Backup Management**: Preserves previous versions with restore capability + +## Operation Modes + +### Session Replan Mode + +```bash +# Auto-detect active session +/workflow:replan "添加双因素认证支持" + +# Explicit session +/workflow:replan --session WFS-oauth "添加双因素认证支持" + +# File-based input +/workflow:replan --session WFS-oauth requirements-update.md + +# Interactive mode +/workflow:replan --interactive +``` + +### Task Replan Mode + +```bash +# Direct task update +/workflow:replan IMPL-1 "修改为使用 OAuth2.0 标准" + +# Task with explicit session +/workflow:replan --session WFS-oauth IMPL-2 "增加单元测试覆盖率到 90%" + +# Interactive mode +/workflow:replan IMPL-1 --interactive +``` + +## Execution Lifecycle + +### Phase 1: Mode Detection & Session Discovery + +**Process**: +1. **Detect Operation Mode**: + - Check if task ID provided (IMPL-N or IMPL-N.M format) → Task mode + - Otherwise → Session mode + +2. **Discover/Validate Session**: + - Use `--session` flag if provided + - Otherwise auto-detect from `.workflow/active/` + - Validate session exists + +3. **Load Session Context**: + - Read `workflow-session.json` + - List existing tasks + - Read `IMPL_PLAN.md` and `TODO_LIST.md` + +**Output**: Session validated, context loaded, mode determined + +--- + +### Phase 2: Interactive Requirement Clarification + +**Purpose**: Define modification scope through guided questioning + +#### Session Mode Questions + +**Q1: Modification Scope** +```javascript +Options: +- 仅更新任务细节 (tasks_only) +- 修改规划方案 (plan_update) +- 重构任务结构 (task_restructure) +- 全面重规划 (comprehensive) +``` + +**Q2: Affected Modules** (if scope >= plan_update) +```javascript +Options: Dynamically generated from existing tasks' focus_paths +- 认证模块 (src/auth) +- 用户管理 (src/user) +- 全部模块 +``` + +**Q3: Task Changes** (if scope >= task_restructure) +```javascript +Options: +- 添加新任务 +- 删除现有任务 +- 合并任务 +- 拆分任务 +- 仅更新内容 +``` + +**Q4: Dependency Changes** +```javascript +Options: +- 是,需要重新梳理依赖 +- 否,保持现有依赖 +``` + +#### Task Mode Questions + +**Q1: Update Type** +```javascript +Options: +- 需求和验收标准 (requirements & acceptance) +- 实现方案 (implementation_approach) +- 文件范围 (focus_paths) +- 依赖关系 (depends_on) +- 全部更新 +``` + +**Q2: Ripple Effect** +```javascript +Options: +- 是,需要同步更新依赖任务 +- 否,仅影响当前任务 +- 不确定,请帮我分析 +``` + +**Output**: User selections stored, modification boundaries defined + +--- + +### Phase 3: Impact Analysis & Planning + +**Step 3.1: Analyze Required Changes** + +Determine affected files based on clarification: + +```typescript +interface ImpactAnalysis { + affected_files: { + impl_plan: boolean; + todo_list: boolean; + session_meta: boolean; + tasks: string[]; + }; + + operations: { + type: 'create' | 'update' | 'delete' | 'merge' | 'split'; + target: string; + reason: string; + }[]; + + backup_strategy: { + timestamp: string; + files: string[]; + }; +} +``` + +**Step 3.2: Generate Modification Plan** + +```markdown +## 修改计划 + +### 影响范围 +- [ ] IMPL_PLAN.md: 更新技术方案第 3 节 +- [ ] TODO_LIST.md: 添加 2 个新任务,删除 1 个废弃任务 +- [ ] IMPL-001.json: 更新实现方案 +- [ ] workflow-session.json: 更新任务计数 + +### 变更操作 +1. **创建**: IMPL-004.json (双因素认证实现) +2. **更新**: IMPL-001.json (添加 2FA 准备工作) +3. **删除**: IMPL-003.json (已被新方案替代) +``` + +**Step 3.3: User Confirmation** + +```javascript +Options: +- 确认执行: 开始应用所有修改 +- 调整计划: 重新回答问题调整范围 +- 取消操作: 放弃本次重规划 +``` + +**Output**: Modification plan confirmed or adjusted + +--- + +### Phase 4: Backup Creation + +**Process**: + +1. **Create Backup Directory**: +```bash +timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S") +backup_dir=".workflow/active/$SESSION_ID/.process/backup/replan-$timestamp" +mkdir -p "$backup_dir" +``` + +2. **Backup All Affected Files**: + - IMPL_PLAN.md + - TODO_LIST.md + - workflow-session.json + - Affected task JSONs + +3. **Create Backup Manifest**: +```markdown +# Replan Backup Manifest + +**Timestamp**: {timestamp} +**Reason**: {replan_reason} +**Scope**: {modification_scope} + +## Restoration Command +cp {backup_dir}/* .workflow/active/{session}/ +``` + +**Output**: All files safely backed up with manifest + +--- + +### Phase 5: Apply Modifications + +**Step 5.1: Update IMPL_PLAN.md** (if needed) + +Use Edit tool to modify specific sections: +- Update affected technical sections +- Update modification date + +**Step 5.2: Update TODO_LIST.md** (if needed) + +- Add new tasks with `[ ]` checkbox +- Mark deleted tasks as `[x] ~~task~~ (已废弃)` +- Update modified task descriptions + +**Step 5.3: Update Task JSONs** + +For each affected task: +```typescript +const updated_task = { + ...task, + context: { + ...task.context, + requirements: [...updated_requirements], + acceptance: [...updated_acceptance] + }, + flow_control: { + ...task.flow_control, + implementation_approach: [...updated_steps] + } +}; + +Write({ + file_path: `.workflow/active/${SESSION_ID}/.task/${task_id}.json`, + content: JSON.stringify(updated_task, null, 2) +}); +``` + +**Step 5.4: Create New Tasks** (if needed) + +Generate complete task JSON with all required fields: +- id, title, status +- meta (type, agent) +- context (requirements, focus_paths, acceptance) +- flow_control (pre_analysis, implementation_approach, target_files) + +**Step 5.5: Delete Obsolete Tasks** (if needed) + +Move to backup instead of hard delete: +```bash +mv ".workflow/active/$SESSION_ID/.task/{task-id}.json" "$backup_dir/" +``` + +**Step 5.6: Update Session Metadata** + +Update workflow-session.json: +- progress.current_tasks +- progress.last_replan +- replan_history array + +**Output**: All modifications applied, artifacts updated + +--- + +### Phase 6: Verification & Summary + +**Step 6.1: Verify Consistency** + +1. Validate all task JSONs are valid JSON +2. Check task count within limits (max 10) +3. Verify dependency graph is acyclic + +**Step 6.2: Generate Change Summary** + +```markdown +## 重规划完成 + +### 会话信息 +- **Session**: {session-id} +- **时间**: {timestamp} +- **备份**: {backup-path} + +### 变更摘要 +**范围**: {scope} +**原因**: {reason} + +### 修改的文件 +- ✓ IMPL_PLAN.md: {changes} +- ✓ TODO_LIST.md: {changes} +- ✓ Task JSONs: {count} files updated + +### 任务变更 +- **新增**: {task-ids} +- **删除**: {task-ids} +- **更新**: {task-ids} + +### 回滚方法 +cp {backup-path}/* .workflow/active/{session}/ +``` + +**Output**: Summary displayed, replan complete + +--- + +## TodoWrite Progress Tracking + +### Session Mode Progress + +```json +[ + {"content": "检测模式和发现会话", "status": "completed", "activeForm": "检测模式和发现会话"}, + {"content": "交互式需求明确", "status": "completed", "activeForm": "交互式需求明确"}, + {"content": "影响分析和计划生成", "status": "completed", "activeForm": "影响分析和计划生成"}, + {"content": "创建备份", "status": "completed", "activeForm": "创建备份"}, + {"content": "更新会话产出文件", "status": "completed", "activeForm": "更新会话产出文件"}, + {"content": "验证一致性", "status": "completed", "activeForm": "验证一致性"} +] +``` + +### Task Mode Progress + +```json +[ + {"content": "检测会话和加载任务", "status": "completed", "activeForm": "检测会话和加载任务"}, + {"content": "交互式更新确认", "status": "completed", "activeForm": "交互式更新确认"}, + {"content": "应用任务修改", "status": "completed", "activeForm": "应用任务修改"} +] +``` + +## Error Handling + +### Session Errors + +```bash +# No active session found +ERROR: No active session found +Run /workflow:session:start to create a session + +# Session not found +ERROR: Session WFS-invalid not found +Available sessions: [list] + +# No changes specified +WARNING: No modifications specified +Use --interactive mode or provide requirements +``` + +### Task Errors + +```bash +# Task not found +ERROR: Task IMPL-999 not found in session +Available tasks: [list] + +# Task completed +WARNING: Task IMPL-001 is completed +Consider creating new task for additional work + +# Circular dependency +ERROR: Circular dependency detected +Resolve dependency conflicts before proceeding +``` + +### Validation Errors + +```bash +# Task limit exceeded +ERROR: Replan would create 12 tasks (limit: 10) +Consider: combining tasks, splitting sessions, or removing tasks + +# Invalid JSON +ERROR: Generated invalid JSON +Backup preserved, rolling back changes +``` + +## File Structure + +``` +.workflow/active/WFS-session-name/ +├── workflow-session.json +├── IMPL_PLAN.md +├── TODO_LIST.md +├── .task/ +│ ├── IMPL-001.json +│ ├── IMPL-002.json +│ └── IMPL-003.json +└── .process/ + ├── context-package.json + └── backup/ + └── replan-{timestamp}/ + ├── MANIFEST.md + ├── IMPL_PLAN.md + ├── TODO_LIST.md + ├── workflow-session.json + └── IMPL-*.json +``` + +## Examples + +### Session Replan - Add Feature + +```bash +/workflow:replan "添加双因素认证支持" + +# Interactive clarification +Q: 修改范围? +A: 全面重规划 + +Q: 受影响模块? +A: 认证模块, API接口 + +Q: 任务变更? +A: 添加新任务, 更新内容 + +# Execution +✓ 创建备份 +✓ 更新 IMPL_PLAN.md +✓ 更新 TODO_LIST.md +✓ 创建 IMPL-004.json +✓ 更新 IMPL-001.json, IMPL-002.json + +重规划完成! 新增 1 任务,更新 2 任务 +``` + +### Task Replan - Update Requirements + +```bash +/workflow:replan IMPL-001 "支持 OAuth2.0 标准" + +# Interactive clarification +Q: 更新部分? +A: 需求和验收标准, 实现方案 + +Q: 影响其他任务? +A: 是,需要同步更新依赖任务 + +# Execution +✓ 创建备份 +✓ 更新 IMPL-001.json +✓ 更新 IMPL-002.json (依赖任务) + +任务重规划完成! 更新 2 个任务 +``` diff --git a/.claude/skills/command-guide/reference/commands/task/replan.md b/.claude/skills/command-guide/reference/commands/task/replan.md index 3fb26830..8cb2c2d5 100644 --- a/.claude/skills/command-guide/reference/commands/task/replan.md +++ b/.claude/skills/command-guide/reference/commands/task/replan.md @@ -7,6 +7,14 @@ allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*) # Task Replan Command (/task:replan) +> **⚠️ DEPRECATION NOTICE**: This command is maintained for backward compatibility. For new workflows, use `/workflow:replan` which provides: +> - Session-level replanning with comprehensive artifact updates +> - Interactive boundary clarification +> - Updates to IMPL_PLAN.md, TODO_LIST.md, and session metadata +> - Better integration with workflow sessions +> +> **Migration**: Replace `/task:replan IMPL-1 "changes"` with `/workflow:replan IMPL-1 "changes"` + ## Overview Replans individual tasks or batch processes multiple tasks with change tracking and backup management. @@ -14,9 +22,6 @@ Replans individual tasks or batch processes multiple tasks with change tracking - **Single Task Mode**: Replan one task with specific changes - **Batch Mode**: Process multiple tasks from action-plan verification report -## Core Principles -**Task System:** @~/.claude/workflows/task-core.md - ## Key Features - **Single/Batch Operations**: Single task or multiple tasks from verification report - **Multiple Input Sources**: Text, files, or verification report @@ -274,7 +279,7 @@ Backup saved to .task/backup/IMPL-2-v1.0.json ### Batch Mode - From Verification Report ```bash -/task:replan --batch .workflow/WFS-{session}/.process/ACTION_PLAN_VERIFICATION.md +/task:replan --batch .workflow/active/WFS-{session}/.process/ACTION_PLAN_VERIFICATION.md Parsing verification report... Found 4 tasks requiring replanning: diff --git a/.claude/skills/command-guide/reference/commands/workflow/replan.md b/.claude/skills/command-guide/reference/commands/workflow/replan.md new file mode 100644 index 00000000..b1c4fdbe --- /dev/null +++ b/.claude/skills/command-guide/reference/commands/workflow/replan.md @@ -0,0 +1,470 @@ +--- +name: replan +description: Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning +argument-hint: "[--session session-id] [task-id] \"requirements\"|file.md [--interactive]" +allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*) +--- + +# Workflow Replan Command + +## Overview +Intelligently replans workflow sessions or individual tasks with interactive boundary clarification and comprehensive artifact updates. + +**Core Capabilities**: +- **Session Replan**: Updates multiple artifacts (IMPL_PLAN.md, TODO_LIST.md, task JSONs) +- **Task Replan**: Focused updates within session context +- **Interactive Clarification**: Guided questioning to define modification boundaries +- **Impact Analysis**: Automatic detection of affected files and dependencies +- **Backup Management**: Preserves previous versions with restore capability + +## Operation Modes + +### Session Replan Mode + +```bash +# Auto-detect active session +/workflow:replan "添加双因素认证支持" + +# Explicit session +/workflow:replan --session WFS-oauth "添加双因素认证支持" + +# File-based input +/workflow:replan --session WFS-oauth requirements-update.md + +# Interactive mode +/workflow:replan --interactive +``` + +### Task Replan Mode + +```bash +# Direct task update +/workflow:replan IMPL-1 "修改为使用 OAuth2.0 标准" + +# Task with explicit session +/workflow:replan --session WFS-oauth IMPL-2 "增加单元测试覆盖率到 90%" + +# Interactive mode +/workflow:replan IMPL-1 --interactive +``` + +## Execution Lifecycle + +### Phase 1: Mode Detection & Session Discovery + +**Process**: +1. **Detect Operation Mode**: + - Check if task ID provided (IMPL-N or IMPL-N.M format) → Task mode + - Otherwise → Session mode + +2. **Discover/Validate Session**: + - Use `--session` flag if provided + - Otherwise auto-detect from `.workflow/active/` + - Validate session exists + +3. **Load Session Context**: + - Read `workflow-session.json` + - List existing tasks + - Read `IMPL_PLAN.md` and `TODO_LIST.md` + +**Output**: Session validated, context loaded, mode determined + +--- + +### Phase 2: Interactive Requirement Clarification + +**Purpose**: Define modification scope through guided questioning + +#### Session Mode Questions + +**Q1: Modification Scope** +```javascript +Options: +- 仅更新任务细节 (tasks_only) +- 修改规划方案 (plan_update) +- 重构任务结构 (task_restructure) +- 全面重规划 (comprehensive) +``` + +**Q2: Affected Modules** (if scope >= plan_update) +```javascript +Options: Dynamically generated from existing tasks' focus_paths +- 认证模块 (src/auth) +- 用户管理 (src/user) +- 全部模块 +``` + +**Q3: Task Changes** (if scope >= task_restructure) +```javascript +Options: +- 添加新任务 +- 删除现有任务 +- 合并任务 +- 拆分任务 +- 仅更新内容 +``` + +**Q4: Dependency Changes** +```javascript +Options: +- 是,需要重新梳理依赖 +- 否,保持现有依赖 +``` + +#### Task Mode Questions + +**Q1: Update Type** +```javascript +Options: +- 需求和验收标准 (requirements & acceptance) +- 实现方案 (implementation_approach) +- 文件范围 (focus_paths) +- 依赖关系 (depends_on) +- 全部更新 +``` + +**Q2: Ripple Effect** +```javascript +Options: +- 是,需要同步更新依赖任务 +- 否,仅影响当前任务 +- 不确定,请帮我分析 +``` + +**Output**: User selections stored, modification boundaries defined + +--- + +### Phase 3: Impact Analysis & Planning + +**Step 3.1: Analyze Required Changes** + +Determine affected files based on clarification: + +```typescript +interface ImpactAnalysis { + affected_files: { + impl_plan: boolean; + todo_list: boolean; + session_meta: boolean; + tasks: string[]; + }; + + operations: { + type: 'create' | 'update' | 'delete' | 'merge' | 'split'; + target: string; + reason: string; + }[]; + + backup_strategy: { + timestamp: string; + files: string[]; + }; +} +``` + +**Step 3.2: Generate Modification Plan** + +```markdown +## 修改计划 + +### 影响范围 +- [ ] IMPL_PLAN.md: 更新技术方案第 3 节 +- [ ] TODO_LIST.md: 添加 2 个新任务,删除 1 个废弃任务 +- [ ] IMPL-001.json: 更新实现方案 +- [ ] workflow-session.json: 更新任务计数 + +### 变更操作 +1. **创建**: IMPL-004.json (双因素认证实现) +2. **更新**: IMPL-001.json (添加 2FA 准备工作) +3. **删除**: IMPL-003.json (已被新方案替代) +``` + +**Step 3.3: User Confirmation** + +```javascript +Options: +- 确认执行: 开始应用所有修改 +- 调整计划: 重新回答问题调整范围 +- 取消操作: 放弃本次重规划 +``` + +**Output**: Modification plan confirmed or adjusted + +--- + +### Phase 4: Backup Creation + +**Process**: + +1. **Create Backup Directory**: +```bash +timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S") +backup_dir=".workflow/active/$SESSION_ID/.process/backup/replan-$timestamp" +mkdir -p "$backup_dir" +``` + +2. **Backup All Affected Files**: + - IMPL_PLAN.md + - TODO_LIST.md + - workflow-session.json + - Affected task JSONs + +3. **Create Backup Manifest**: +```markdown +# Replan Backup Manifest + +**Timestamp**: {timestamp} +**Reason**: {replan_reason} +**Scope**: {modification_scope} + +## Restoration Command +cp {backup_dir}/* .workflow/active/{session}/ +``` + +**Output**: All files safely backed up with manifest + +--- + +### Phase 5: Apply Modifications + +**Step 5.1: Update IMPL_PLAN.md** (if needed) + +Use Edit tool to modify specific sections: +- Update affected technical sections +- Update modification date + +**Step 5.2: Update TODO_LIST.md** (if needed) + +- Add new tasks with `[ ]` checkbox +- Mark deleted tasks as `[x] ~~task~~ (已废弃)` +- Update modified task descriptions + +**Step 5.3: Update Task JSONs** + +For each affected task: +```typescript +const updated_task = { + ...task, + context: { + ...task.context, + requirements: [...updated_requirements], + acceptance: [...updated_acceptance] + }, + flow_control: { + ...task.flow_control, + implementation_approach: [...updated_steps] + } +}; + +Write({ + file_path: `.workflow/active/${SESSION_ID}/.task/${task_id}.json`, + content: JSON.stringify(updated_task, null, 2) +}); +``` + +**Step 5.4: Create New Tasks** (if needed) + +Generate complete task JSON with all required fields: +- id, title, status +- meta (type, agent) +- context (requirements, focus_paths, acceptance) +- flow_control (pre_analysis, implementation_approach, target_files) + +**Step 5.5: Delete Obsolete Tasks** (if needed) + +Move to backup instead of hard delete: +```bash +mv ".workflow/active/$SESSION_ID/.task/{task-id}.json" "$backup_dir/" +``` + +**Step 5.6: Update Session Metadata** + +Update workflow-session.json: +- progress.current_tasks +- progress.last_replan +- replan_history array + +**Output**: All modifications applied, artifacts updated + +--- + +### Phase 6: Verification & Summary + +**Step 6.1: Verify Consistency** + +1. Validate all task JSONs are valid JSON +2. Check task count within limits (max 10) +3. Verify dependency graph is acyclic + +**Step 6.2: Generate Change Summary** + +```markdown +## 重规划完成 + +### 会话信息 +- **Session**: {session-id} +- **时间**: {timestamp} +- **备份**: {backup-path} + +### 变更摘要 +**范围**: {scope} +**原因**: {reason} + +### 修改的文件 +- ✓ IMPL_PLAN.md: {changes} +- ✓ TODO_LIST.md: {changes} +- ✓ Task JSONs: {count} files updated + +### 任务变更 +- **新增**: {task-ids} +- **删除**: {task-ids} +- **更新**: {task-ids} + +### 回滚方法 +cp {backup-path}/* .workflow/active/{session}/ +``` + +**Output**: Summary displayed, replan complete + +--- + +## TodoWrite Progress Tracking + +### Session Mode Progress + +```json +[ + {"content": "检测模式和发现会话", "status": "completed", "activeForm": "检测模式和发现会话"}, + {"content": "交互式需求明确", "status": "completed", "activeForm": "交互式需求明确"}, + {"content": "影响分析和计划生成", "status": "completed", "activeForm": "影响分析和计划生成"}, + {"content": "创建备份", "status": "completed", "activeForm": "创建备份"}, + {"content": "更新会话产出文件", "status": "completed", "activeForm": "更新会话产出文件"}, + {"content": "验证一致性", "status": "completed", "activeForm": "验证一致性"} +] +``` + +### Task Mode Progress + +```json +[ + {"content": "检测会话和加载任务", "status": "completed", "activeForm": "检测会话和加载任务"}, + {"content": "交互式更新确认", "status": "completed", "activeForm": "交互式更新确认"}, + {"content": "应用任务修改", "status": "completed", "activeForm": "应用任务修改"} +] +``` + +## Error Handling + +### Session Errors + +```bash +# No active session found +ERROR: No active session found +Run /workflow:session:start to create a session + +# Session not found +ERROR: Session WFS-invalid not found +Available sessions: [list] + +# No changes specified +WARNING: No modifications specified +Use --interactive mode or provide requirements +``` + +### Task Errors + +```bash +# Task not found +ERROR: Task IMPL-999 not found in session +Available tasks: [list] + +# Task completed +WARNING: Task IMPL-001 is completed +Consider creating new task for additional work + +# Circular dependency +ERROR: Circular dependency detected +Resolve dependency conflicts before proceeding +``` + +### Validation Errors + +```bash +# Task limit exceeded +ERROR: Replan would create 12 tasks (limit: 10) +Consider: combining tasks, splitting sessions, or removing tasks + +# Invalid JSON +ERROR: Generated invalid JSON +Backup preserved, rolling back changes +``` + +## File Structure + +``` +.workflow/active/WFS-session-name/ +├── workflow-session.json +├── IMPL_PLAN.md +├── TODO_LIST.md +├── .task/ +│ ├── IMPL-001.json +│ ├── IMPL-002.json +│ └── IMPL-003.json +└── .process/ + ├── context-package.json + └── backup/ + └── replan-{timestamp}/ + ├── MANIFEST.md + ├── IMPL_PLAN.md + ├── TODO_LIST.md + ├── workflow-session.json + └── IMPL-*.json +``` + +## Examples + +### Session Replan - Add Feature + +```bash +/workflow:replan "添加双因素认证支持" + +# Interactive clarification +Q: 修改范围? +A: 全面重规划 + +Q: 受影响模块? +A: 认证模块, API接口 + +Q: 任务变更? +A: 添加新任务, 更新内容 + +# Execution +✓ 创建备份 +✓ 更新 IMPL_PLAN.md +✓ 更新 TODO_LIST.md +✓ 创建 IMPL-004.json +✓ 更新 IMPL-001.json, IMPL-002.json + +重规划完成! 新增 1 任务,更新 2 任务 +``` + +### Task Replan - Update Requirements + +```bash +/workflow:replan IMPL-001 "支持 OAuth2.0 标准" + +# Interactive clarification +Q: 更新部分? +A: 需求和验收标准, 实现方案 + +Q: 影响其他任务? +A: 是,需要同步更新依赖任务 + +# Execution +✓ 创建备份 +✓ 更新 IMPL-001.json +✓ 更新 IMPL-002.json (依赖任务) + +任务重规划完成! 更新 2 个任务 +``` diff --git a/COMMAND_REFERENCE.md b/COMMAND_REFERENCE.md index 5229ec42..4f5c92ca 100644 --- a/COMMAND_REFERENCE.md +++ b/COMMAND_REFERENCE.md @@ -39,6 +39,7 @@ These commands orchestrate complex, multi-phase development processes, from plan |---|---| | `/workflow:plan` | Orchestrate 5-phase planning workflow with quality gate, executing commands and passing context between phases. | | `/workflow:lite-plan` | ⚡ **NEW** Lightweight interactive planning and execution workflow with in-memory planning, smart code exploration, three-dimensional multi-select confirmation (task approval + execution method + code review), and parallel task execution support. | +| `/workflow:replan` | ⚡ **NEW** Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning. Supports both session-wide and task-specific modifications. | | `/workflow:execute` | Coordinate agents for existing workflow tasks with automatic discovery. | | `/workflow:resume` | Intelligent workflow session resumption with automatic progress analysis. | | `/workflow:review` | Optional specialized review (security, architecture, docs) for completed implementation. | @@ -122,7 +123,7 @@ Commands for managing individual tasks within a workflow session. | `/task:create` | Create implementation tasks with automatic context awareness. | | `/task:breakdown` | Intelligent task decomposition with context-aware subtask generation. | | `/task:execute` | Execute tasks with appropriate agents and context-aware orchestration. | -| `/task:replan` | Replan individual tasks with detailed user input and change tracking. | +| `/task:replan` | ⚠️ **DEPRECATED** Use `/workflow:replan` instead. Legacy command for task replanning (maintained for backward compatibility). | ## Memory and Versioning Commands