mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-12 02:37:45 +08:00

Files

catlog22 369bfa8a08 Refactor command YAML headers: replace examples with argument-hint

**Summary:**
Updated all 62 command files in `.claude/commands` directory to improve parameter documentation clarity by replacing `examples` field with descriptive `argument-hint` field.

**Changes:**
- Added/improved `argument-hint` for all commands based on usage patterns
- Removed `examples` field and all example items from YAML headers
- Maintained all other YAML fields (name, description, usage, allowed-tools)
- Deleted obsolete commands: workflow/issue/*, workflow/session/pause.md, workflow/session/switch.md
- Cleaned up temporary analysis files

**Rationale:**
The `argument-hint` field provides clearer, more concise parameter documentation than example lists, improving command discoverability and usability in the Claude Code interface.

**Files Modified:** 62 command files
**Lines Changed:** -1570 insertions, +192 deletions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-11 23:45:55 +08:00

3.3 KiB

Raw Blame History

name, description, usage, argument-hint, allowed-tools

name	description	usage	argument-hint	allowed-tools
resume	Intelligent workflow session resumption with automatic progress analysis	/workflow:resume "<session-id>"	session-id for workflow session to resume	SlashCommand(), TodoWrite(), Read(), Bash()

Sequential Workflow Resume Command

Usage

/workflow:resume "<session-id>"

Purpose

Sequential command coordination for workflow resumption by first analyzing current session status, then continuing execution with special resume context. This command orchestrates intelligent session resumption through two-step process.

Command Coordination Workflow

Phase 1: Status Analysis

Call status command: Execute /workflow:status to analyze current session state
Verify session information: Check session ID, progress, and current task status
Identify resume point: Determine where workflow was interrupted

Phase 2: Resume Execution

Call execute with resume flag: Execute /workflow:execute --resume-session="{session-id}"
Pass session context: Provide analyzed session information to execute command
Direct agent execution: Skip discovery phase, directly enter TodoWrite and agent execution

Implementation Protocol

Sequential Command Execution

# Phase 1: Analyze current session status
SlashCommand(command="/workflow:status")

# Phase 2: Resume execution with special flag
SlashCommand(command="/workflow:execute --resume-session=\"{session-id}\"")

Progress Tracking

TodoWrite({
  todos: [
    {
      content: "Analyze current session status and progress",
      status: "in_progress",
      activeForm: "Analyzing session status"
    },
    {
      content: "Resume workflow execution with session context",
      status: "pending",
      activeForm: "Resuming workflow execution"
    }
  ]
});

Resume Information Flow

Status Analysis Results

The /workflow:status command provides:

Session ID: Current active session identifier
Current Progress: Completed, in-progress, and pending tasks
Interruption Point: Last executed task and next pending task
Session State: Overall workflow status

Execute Command Context

The special --resume-session flag tells /workflow:execute:

Skip Discovery: Don't search for sessions, use provided session ID
Direct Execution: Go straight to TodoWrite generation and agent launching
Context Restoration: Use existing session state and summaries
Resume Point: Continue from identified interruption point

Error Handling

Session Validation Failures

Session not found: Report missing session, suggest available sessions
Session inactive: Recommend activating session first
Status command fails: Retry once, then report analysis failure

Execute Resumption Failures

No pending tasks: Report workflow completion status
Execute command fails: Report resumption failure, suggest manual intervention

Success Criteria

Status analysis complete: Session state properly analyzed and reported
Execute command launched: Resume execution started with proper context
Agent coordination: TodoWrite and agent execution initiated successfully
Context preservation: Session state and progress properly maintained

Sequential command coordination for workflow session resumption

3.3 KiB Raw Blame History