mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-10 02:24:35 +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

2.5 KiB

Raw Blame History

name, description, examples

name

description

examples

list

List all workflow sessions with status

/workflow:session:list

List Workflow Sessions (/workflow:session:list)

Overview

Display all workflow sessions with their current status, progress, and metadata.

Usage

/workflow:session:list       # Show all sessions with status

Implementation Flow

Step 1: Find All Sessions

ls .workflow/WFS-* 2>/dev/null

Step 2: Check Active Session

ls .workflow/.active-* 2>/dev/null | head -1

Step 3: Read Session Metadata

jq -r '.session_id, .status, .project' .workflow/WFS-session/workflow-session.json

Step 4: Count Task Progress

find .workflow/WFS-session/.task/ -name "*.json" -type f 2>/dev/null | wc -l
find .workflow/WFS-session/.summaries/ -name "*.md" -type f 2>/dev/null | wc -l

Step 5: Get Creation Time

jq -r '.created_at // "unknown"' .workflow/WFS-session/workflow-session.json

Simple Bash Commands

Basic Operations

List sessions: find .workflow/ -maxdepth 1 -type d -name "WFS-*"
Find active: find .workflow/ -name ".active-*" -type f
Read session data: jq -r '.session_id, .status' session.json
Count tasks: find .task/ -name "*.json" -type f | wc -l
Count completed: find .summaries/ -name "*.md" -type f 2>/dev/null | wc -l
Get timestamp: jq -r '.created_at' session.json

Simple Output Format

Session List Display

Workflow Sessions:

✅ WFS-oauth-integration (ACTIVE)
   Project: OAuth2 authentication system
   Status: active
   Progress: 3/8 tasks completed
   Created: 2025-09-15T10:30:00Z

⏸️ WFS-user-profile (PAUSED)
   Project: User profile management
   Status: paused
   Progress: 1/5 tasks completed
   Created: 2025-09-14T14:15:00Z

📁 WFS-database-migration (COMPLETED)
   Project: Database schema migration
   Status: completed
   Progress: 4/4 tasks completed
   Created: 2025-09-13T09:00:00Z

Total: 3 sessions (1 active, 1 paused, 1 completed)

Status Indicators

✅: Active session
⏸️: Paused session
📁: Completed session
❌: Error/corrupted session

Quick Commands

# Count all sessions
ls .workflow/WFS-* | wc -l

# Show only active
ls .workflow/.active-* | basename | sed 's/^\.active-//'

# Show recent sessions
ls -t .workflow/WFS-*/workflow-session.json | head -3

/workflow:session:start - Create new session
/workflow:session:switch - Switch to different session
/workflow:session:status - Detailed session info

2.5 KiB Raw Blame History