mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
feat: Add workflow resume command and remove deprecated gemini_required
- Add comprehensive /workflow:resume command with intelligent interruption detection - Support multiple recovery strategies: automatic, targeted, retry, skip, force - Implement context reconstruction and status synchronization - Remove deprecated "gemini_required": true from task JSON examples - Replace with pre_analysis multi-step approach for better workflow control 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
@@ -148,8 +148,7 @@ For each executable task:
|
||||
"phase": "IMPLEMENT",
|
||||
"plan_context": "Authentication system with OAuth2 support"
|
||||
},
|
||||
"focus_modules": ["src/auth/", "tests/auth/"],
|
||||
"gemini_required": true
|
||||
"focus_modules": ["src/auth/", "tests/auth/"]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
382
.claude/commands/workflow/resume.md
Normal file
382
.claude/commands/workflow/resume.md
Normal file
@@ -0,0 +1,382 @@
|
||||
---
|
||||
name: resume
|
||||
description: Intelligent workflow resumption with automatic interruption point detection
|
||||
usage: /workflow:resume [options]
|
||||
argument-hint: [--from TASK-ID] [--retry] [--skip TASK-ID] [--force]
|
||||
examples:
|
||||
- /workflow:resume
|
||||
- /workflow:resume --from impl-1.2
|
||||
- /workflow:resume --retry impl-1.1
|
||||
- /workflow:resume --skip impl-2.1 --from impl-2.2
|
||||
---
|
||||
|
||||
# Workflow Resume Command (/workflow:resume)
|
||||
|
||||
## Overview
|
||||
Intelligently resumes interrupted workflows with automatic detection of interruption points, context restoration, and flexible recovery strategies. Maintains execution continuity while adapting to various interruption scenarios.
|
||||
|
||||
## Core Principles
|
||||
**File Structure:** @~/.claude/workflows/workflow-architecture.md
|
||||
|
||||
## Usage
|
||||
```bash
|
||||
/workflow:resume [--from TASK-ID] [--retry] [--skip TASK-ID] [--force]
|
||||
```
|
||||
|
||||
### Recovery Options
|
||||
|
||||
#### Automatic Recovery (Default)
|
||||
```bash
|
||||
/workflow:resume
|
||||
```
|
||||
**Behavior**:
|
||||
- Auto-detects interruption point from task statuses
|
||||
- Resumes from first incomplete task in dependency order
|
||||
- Rebuilds agent context automatically
|
||||
|
||||
#### Targeted Recovery
|
||||
```bash
|
||||
/workflow:resume --from impl-1.2
|
||||
```
|
||||
**Behavior**:
|
||||
- Resumes from specific task ID
|
||||
- Validates dependencies are met
|
||||
- Updates subsequent task readiness
|
||||
|
||||
#### Retry Failed Tasks
|
||||
```bash
|
||||
/workflow:resume --retry impl-1.1
|
||||
```
|
||||
**Behavior**:
|
||||
- Retries previously failed task
|
||||
- Analyzes failure context
|
||||
- Applies enhanced error handling
|
||||
|
||||
#### Skip Blocked Tasks
|
||||
```bash
|
||||
/workflow:resume --skip impl-2.1 --from impl-2.2
|
||||
```
|
||||
**Behavior**:
|
||||
- Marks specified task as skipped
|
||||
- Continues execution from target task
|
||||
- Adjusts dependency chain
|
||||
|
||||
#### Force Recovery
|
||||
```bash
|
||||
/workflow:resume --force
|
||||
```
|
||||
**Behavior**:
|
||||
- Bypasses dependency validation
|
||||
- Forces execution regardless of task states
|
||||
- For emergency recovery scenarios
|
||||
|
||||
## Interruption Detection Logic
|
||||
|
||||
### Session State Analysis
|
||||
```
|
||||
Interruption Analysis:
|
||||
├── Load active session from .workflow/.active-* marker
|
||||
├── Read workflow-session.json for last execution state
|
||||
├── Scan .task/ directory for task statuses
|
||||
├── Analyze TODO_LIST.md progress markers
|
||||
├── Check .summaries/ for completion records
|
||||
└── Detect interruption point and failure patterns
|
||||
```
|
||||
|
||||
**Detection Criteria**:
|
||||
- **Normal Interruption**: Last task marked as "in_progress" without completion
|
||||
- **Failure Interruption**: Task marked as "failed" with error context
|
||||
- **Dependency Interruption**: Tasks blocked due to failed dependencies
|
||||
- **Agent Interruption**: Agent execution terminated without status update
|
||||
|
||||
### Context Restoration Process
|
||||
```json
|
||||
{
|
||||
"interruption_analysis": {
|
||||
"session_id": "WFS-user-auth",
|
||||
"last_active_task": "impl-1.2",
|
||||
"interruption_type": "agent_timeout",
|
||||
"interruption_time": "2025-09-15T14:30:00Z",
|
||||
"affected_tasks": ["impl-1.2", "impl-1.3"],
|
||||
"pending_dependencies": [],
|
||||
"recovery_strategy": "retry_with_enhanced_context"
|
||||
},
|
||||
"execution_state": {
|
||||
"completed_tasks": ["impl-1.1"],
|
||||
"failed_tasks": [],
|
||||
"in_progress_tasks": ["impl-1.2"],
|
||||
"pending_tasks": ["impl-1.3", "impl-2.1"],
|
||||
"skipped_tasks": [],
|
||||
"blocked_tasks": []
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Resume Execution Flow
|
||||
|
||||
### 1. Session Discovery & Validation
|
||||
```
|
||||
Session Validation:
|
||||
├── Verify active session exists (.workflow/.active-*)
|
||||
├── Load session metadata (workflow-session.json)
|
||||
├── Validate task files integrity (.task/*.json)
|
||||
├── Check IMPL_PLAN.md consistency
|
||||
└── Rebuild execution context
|
||||
```
|
||||
|
||||
**Validation Checks**:
|
||||
- **Session Integrity**: All required files present and readable
|
||||
- **Task Consistency**: Task JSON files match TODO_LIST.md entries
|
||||
- **Dependency Chain**: Task dependencies are logically consistent
|
||||
- **Agent Context**: Previous agent outputs available in .summaries/
|
||||
|
||||
### 2. Interruption Point Analysis
|
||||
```pseudo
|
||||
function detect_interruption():
|
||||
last_execution = read_session_state()
|
||||
task_statuses = scan_task_files()
|
||||
|
||||
for task in dependency_order:
|
||||
if task.status == "in_progress" and no_completion_summary():
|
||||
return InterruptionPoint(task, "agent_interruption")
|
||||
elif task.status == "failed":
|
||||
return InterruptionPoint(task, "task_failure")
|
||||
elif task.status == "pending" and dependencies_met(task):
|
||||
return InterruptionPoint(task, "ready_to_execute")
|
||||
|
||||
return InterruptionPoint(null, "workflow_complete")
|
||||
```
|
||||
|
||||
### 3. Context Reconstruction
|
||||
**Agent Context Rebuilding**:
|
||||
```bash
|
||||
# Reconstruct complete agent context from interruption point
|
||||
Task(subagent_type="code-developer",
|
||||
prompt="[RESUME_CONTEXT] [MULTI_STEP_ANALYSIS] Resume impl-1.2: Implement JWT authentication
|
||||
|
||||
RESUMPTION CONTEXT:
|
||||
- Interruption Type: agent_timeout
|
||||
- Previous Attempt: 2025-09-15T14:30:00Z
|
||||
- Completed Tasks: impl-1.1 (auth schema design)
|
||||
- Current Task State: in_progress
|
||||
- Recovery Strategy: retry_with_enhanced_context
|
||||
|
||||
AVAILABLE CONTEXT:
|
||||
- Completed Task Summaries: .workflow/WFS-user-auth/.summaries/impl-1.1-summary.md
|
||||
- Previous Progress: Check .workflow/WFS-user-auth/TODO_LIST.md for partial completion
|
||||
- Task Definition: .workflow/WFS-user-auth/.task/impl-1.2.json
|
||||
- Session State: .workflow/WFS-user-auth/workflow-session.json
|
||||
|
||||
PRE-ANALYSIS REQUIREMENTS:
|
||||
$(cat .workflow/WFS-user-auth/.task/impl-1.2.json | jq -r '.implementation.pre_analysis[] | "- " + .action + " (" + .method + "): " + .template')
|
||||
|
||||
CONTINUATION INSTRUCTIONS:
|
||||
1. Review previous completion summaries for context
|
||||
2. Check current codebase state against expected progress
|
||||
3. Identify any changes since last execution
|
||||
4. Resume from detected interruption point
|
||||
5. Complete remaining task objectives
|
||||
|
||||
Focus Paths: $(~/.claude/scripts/read-task-paths.sh .workflow/WFS-user-auth/.task/impl-1.2.json)
|
||||
Analysis Command: ~/.claude/scripts/gemini-wrapper -p \"$(~/.claude/scripts/read-task-paths.sh .workflow/WFS-user-auth/.task/impl-1.2.json) @{CLAUDE.md}\"",
|
||||
|
||||
description="Resume interrupted task with complete context reconstruction")
|
||||
```
|
||||
|
||||
### 4. Resume Coordination with TodoWrite
|
||||
**Always First**: Update TodoWrite with resumption plan
|
||||
```markdown
|
||||
# Workflow Resume Coordination
|
||||
*Session: WFS-[topic-slug] - RESUMPTION*
|
||||
|
||||
## Interruption Analysis
|
||||
- **Interruption Point**: impl-1.2 (JWT implementation)
|
||||
- **Interruption Type**: agent_timeout
|
||||
- **Last Activity**: 2025-09-15T14:30:00Z
|
||||
- **Recovery Strategy**: retry_with_enhanced_context
|
||||
|
||||
## Resume Execution Plan
|
||||
- [x] **TASK-001**: [Completed] Design auth schema (impl-1.1)
|
||||
- [ ] **TASK-002**: [RESUME] [Agent: code-developer] [MULTI_STEP_ANALYSIS] Implement JWT authentication (impl-1.2)
|
||||
- [ ] **TASK-003**: [Pending] [Agent: code-review-agent] Review implementations (impl-1.3)
|
||||
- [ ] **TASK-004**: Update session state and mark workflow complete
|
||||
|
||||
**Resume Markers**:
|
||||
- [RESUME] = Task being resumed from interruption point
|
||||
- [RETRY] = Task being retried after failure
|
||||
- [SKIP] = Task marked as skipped in recovery
|
||||
```
|
||||
|
||||
## Recovery Strategies
|
||||
|
||||
### Strategy Selection Matrix
|
||||
| Interruption Type | Default Strategy | Alternative Options |
|
||||
|------------------|------------------|-------------------|
|
||||
| Agent Timeout | retry_with_enhanced_context | skip_and_continue, manual_review |
|
||||
| Task Failure | analyze_and_retry | skip_task, force_continue |
|
||||
| Dependency Block | resolve_dependencies | skip_blockers, manual_intervention |
|
||||
| Context Loss | rebuild_full_context | partial_recovery, restart_from_checkpoint |
|
||||
|
||||
### Enhanced Context Recovery
|
||||
```bash
|
||||
# For agent timeout or context loss scenarios
|
||||
1. Load all completion summaries
|
||||
2. Analyze current codebase state
|
||||
3. Compare against expected task progress
|
||||
4. Rebuild comprehensive agent context
|
||||
5. Resume with enhanced error handling
|
||||
```
|
||||
|
||||
### Failure Analysis Recovery
|
||||
```bash
|
||||
# For task failure scenarios
|
||||
1. Parse failure logs and error context
|
||||
2. Identify root cause (code, dependency, logic)
|
||||
3. Apply targeted recovery strategy
|
||||
4. Retry with failure-specific enhancements
|
||||
5. Escalate to manual review if repeated failures
|
||||
```
|
||||
|
||||
### Dependency Resolution Recovery
|
||||
```bash
|
||||
# For dependency block scenarios
|
||||
1. Analyze blocked dependency chain
|
||||
2. Identify minimum viable completion set
|
||||
3. Offer skip options for non-critical dependencies
|
||||
4. Resume with adjusted execution plan
|
||||
```
|
||||
|
||||
## Status Synchronization
|
||||
|
||||
### Task Status Updates
|
||||
```json
|
||||
// Before resumption
|
||||
{
|
||||
"id": "impl-1.2",
|
||||
"status": "in_progress",
|
||||
"execution": {
|
||||
"attempts": 1,
|
||||
"last_attempt": "2025-09-15T14:30:00Z",
|
||||
"interruption_reason": "agent_timeout"
|
||||
}
|
||||
}
|
||||
|
||||
// After successful resumption
|
||||
{
|
||||
"id": "impl-1.2",
|
||||
"status": "completed",
|
||||
"execution": {
|
||||
"attempts": 2,
|
||||
"last_attempt": "2025-09-15T15:45:00Z",
|
||||
"completion_time": "2025-09-15T15:45:00Z",
|
||||
"recovery_strategy": "retry_with_enhanced_context"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Session State Updates
|
||||
```json
|
||||
{
|
||||
"current_phase": "EXECUTE",
|
||||
"last_execute_run": "2025-09-15T15:45:00Z",
|
||||
"resume_count": 1,
|
||||
"interruption_history": [
|
||||
{
|
||||
"timestamp": "2025-09-15T14:30:00Z",
|
||||
"reason": "agent_timeout",
|
||||
"affected_task": "impl-1.2",
|
||||
"recovery_strategy": "retry_with_enhanced_context"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## Error Handling & Recovery
|
||||
|
||||
### Detection Failures
|
||||
```bash
|
||||
# No active session
|
||||
❌ No active workflow session found
|
||||
→ Use: /workflow:session:start or /workflow:plan first
|
||||
|
||||
# Corrupted session state
|
||||
⚠️ Session state corrupted or inconsistent
|
||||
→ Use: /workflow:resume --force for emergency recovery
|
||||
|
||||
# Task dependency conflicts
|
||||
❌ Task dependency chain has conflicts
|
||||
→ Use: /workflow:resume --skip [task-id] to bypass blockers
|
||||
```
|
||||
|
||||
### Recovery Failures
|
||||
```bash
|
||||
# Repeated task failures
|
||||
❌ Task impl-1.2 failed 3 times
|
||||
→ Manual Review Required: Check .summaries/impl-1.2-failure-analysis.md
|
||||
→ Use: /workflow:resume --skip impl-1.2 to continue
|
||||
|
||||
# Agent context reconstruction failures
|
||||
⚠️ Cannot rebuild agent context for impl-1.2
|
||||
→ Use: /workflow:resume --force --from impl-1.3 to skip problematic task
|
||||
|
||||
# Critical dependency failures
|
||||
❌ Critical dependency impl-1.1 failed validation
|
||||
→ Use: /workflow:plan to regenerate tasks or manual intervention required
|
||||
```
|
||||
|
||||
## Advanced Resume Features
|
||||
|
||||
### Checkpoint System
|
||||
- **Automatic Checkpoints**: Created after each successful task completion
|
||||
- **Checkpoint Validation**: Verify codebase state matches expected progress
|
||||
- **Rollback Capability**: Option to resume from previous valid checkpoint
|
||||
|
||||
### Parallel Task Recovery
|
||||
```bash
|
||||
# Resume multiple independent tasks simultaneously
|
||||
/workflow:resume --parallel --from impl-2.1,impl-3.1
|
||||
```
|
||||
|
||||
### Resume with Analysis Refresh
|
||||
```bash
|
||||
# Resume with updated project analysis
|
||||
/workflow:resume --refresh-analysis --from impl-1.2
|
||||
```
|
||||
|
||||
### Conditional Resume
|
||||
```bash
|
||||
# Resume only if specific conditions are met
|
||||
/workflow:resume --if-dependencies-met --from impl-1.3
|
||||
```
|
||||
|
||||
## Integration Points
|
||||
|
||||
### Automatic Behaviors
|
||||
- **Interruption Detection**: Continuous monitoring during execution
|
||||
- **Context Preservation**: Automatic context saving at task boundaries
|
||||
- **Recovery Planning**: Dynamic strategy selection based on interruption type
|
||||
- **Progress Restoration**: Seamless continuation of TodoWrite coordination
|
||||
|
||||
### Next Actions
|
||||
```bash
|
||||
# After successful resumption
|
||||
/context # View updated workflow status
|
||||
/workflow:execute # Continue normal execution
|
||||
/workflow:review # Move to review phase when complete
|
||||
```
|
||||
|
||||
## Resume Command Workflow Integration
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A[/workflow:resume] --> B[Detect Active Session]
|
||||
B --> C[Analyze Interruption Point]
|
||||
C --> D[Select Recovery Strategy]
|
||||
D --> E[Rebuild Agent Context]
|
||||
E --> F[Update TodoWrite Plan]
|
||||
F --> G[Execute Resume Coordination]
|
||||
G --> H[Monitor & Update Status]
|
||||
H --> I[Continue Normal Workflow]
|
||||
```
|
||||
|
||||
**System ensures**: Robust workflow continuity with intelligent interruption handling and seamless recovery integration.
|
||||
Reference in New Issue
Block a user