mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-10 02:24:35 +08:00
369bfa8a08
**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>
3.1 KiB
3.1 KiB
name, description, examples
| name | description | examples | ||
|---|---|---|---|---|
| complete | Mark the active workflow session as complete and remove active flag |
|
Complete Workflow Session (/workflow:session:complete)
Overview
Mark the currently active workflow session as complete, update its status, and remove the active flag marker.
Usage
/workflow:session:complete # Complete current active session
/workflow:session:complete --detailed # Show detailed completion summary
Implementation Flow
Step 1: Find Active Session
ls .workflow/.active-* 2>/dev/null | head -1
Step 2: Get Session Name
basename .workflow/.active-WFS-session-name | sed 's/^\.active-//'
Step 3: Update Session Status
jq '.status = "completed"' .workflow/WFS-session/workflow-session.json > temp.json
mv temp.json .workflow/WFS-session/workflow-session.json
Step 4: Add Completion Timestamp
jq '.completed_at = "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"' .workflow/WFS-session/workflow-session.json > temp.json
mv temp.json .workflow/WFS-session/workflow-session.json
Step 5: Count Final Statistics
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 6: Remove Active Marker
rm .workflow/.active-WFS-session-name
Simple Bash Commands
Basic Operations
- Find active session:
find .workflow/ -name ".active-*" -type f - Get session name:
basename marker | sed 's/^\.active-//' - Update status:
jq '.status = "completed"' session.json > temp.json - Add timestamp:
jq '.completed_at = "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"' - Count tasks:
find .task/ -name "*.json" -type f | wc -l - Count completed:
find .summaries/ -name "*.md" -type f 2>/dev/null | wc -l - Remove marker:
rm .workflow/.active-session
Completion Result
Session WFS-user-auth completed
- Status: completed
- Started: 2025-09-15T10:00:00Z
- Completed: 2025-09-15T16:30:00Z
- Duration: 6h 30m
- Total tasks: 8
- Completed tasks: 8
- Success rate: 100%
Detailed Summary (--detailed flag)
Session Completion Summary:
├── Session: WFS-user-auth
├── Project: User authentication system
├── Total time: 6h 30m
├── Tasks completed: 8/8 (100%)
├── Files generated: 24 files
├── Summaries created: 8 summaries
├── Status: All tasks completed successfully
└── Location: .workflow/WFS-user-auth/
Error Handling
# No active session
find .workflow/ -name ".active-*" -type f 2>/dev/null || echo "No active session found"
# Incomplete tasks
task_count=$(find .task/ -name "*.json" -type f | wc -l)
summary_count=$(find .summaries/ -name "*.md" -type f 2>/dev/null | wc -l)
test $task_count -eq $summary_count || echo "Warning: Not all tasks completed"
Related Commands
/workflow:session:list- View all sessions including completed/workflow:session:start- Start new session/workflow:status- Check completion status before completing