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.0 KiB
3.0 KiB
name, description, usage, argument-hint
| name | description | usage | argument-hint |
|---|---|---|---|
| workflow:status | Generate on-demand views from JSON task data | /workflow:status [task-id] | [optional: task-id] |
Workflow Status Command (/workflow:status)
Overview
Generates on-demand views from JSON task data. No synchronization needed - all views are calculated from the current state of JSON files.
Usage
/workflow:status # Show current workflow overview
/workflow:status impl-1 # Show specific task details
/workflow:status --validate # Validate workflow integrity
Implementation Flow
Step 1: Find Active Session
find .workflow/ -name ".active-*" -type f 2>/dev/null | head -1
Step 2: Load Session Data
cat .workflow/WFS-session/workflow-session.json
Step 3: Scan Task Files
find .workflow/WFS-session/.task/ -name "*.json" -type f 2>/dev/null
Step 4: Generate Task Status
cat .workflow/WFS-session/.task/impl-1.json | jq -r '.status'
Step 5: Count Task Progress
find .workflow/WFS-session/.task/ -name "*.json" -type f | wc -l
find .workflow/WFS-session/.summaries/ -name "*.md" -type f 2>/dev/null | wc -l
Step 6: Display Overview
# Workflow Overview
**Session**: WFS-session-name
**Progress**: 3/8 tasks completed
## Active Tasks
- [⚠️] impl-1: Current task in progress
- [ ] impl-2: Next pending task
## Completed Tasks
- [✅] impl-0: Setup completed
Simple Bash Commands
Basic Operations
- Find active session:
find .workflow/ -name ".active-*" -type f - Read session info:
cat .workflow/session/workflow-session.json - List tasks:
find .workflow/session/.task/ -name "*.json" -type f - Check task status:
cat task.json | jq -r '.status' - Count completed:
find .summaries/ -name "*.md" -type f | wc -l
Task Status Check
- pending: Not started yet
- active: Currently in progress
- completed: Finished with summary
- blocked: Waiting for dependencies
Validation Commands
# Check session exists
test -f .workflow/.active-* && echo "Session active"
# Validate task files
for f in .workflow/session/.task/*.json; do jq empty "$f" && echo "Valid: $f"; done
# Check summaries match
find .task/ -name "*.json" -type f | wc -l
find .summaries/ -name "*.md" -type f 2>/dev/null | wc -l
Simple Output Format
Default Overview
Session: WFS-user-auth
Status: ACTIVE
Progress: 5/12 tasks
Current: impl-3 (Building API endpoints)
Next: impl-4 (Adding authentication)
Completed: impl-1, impl-2
Task Details
Task: impl-1
Title: Build authentication module
Status: completed
Agent: code-developer
Created: 2025-09-15
Completed: 2025-09-15
Summary: .summaries/impl-1-summary.md
Validation Results
✅ Session file valid
✅ 8 task files found
✅ 3 summaries found
⚠️ 5 tasks pending completion
Related Commands
/workflow:execute- Uses this for task discovery/workflow:resume- Uses this for progress analysis/workflow:session:status- Shows session metadata