Files
Claude-Code-Workflow/.claude/commands/cli/execute.md
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

6.4 KiB

name, description, usage, argument-hint, allowed-tools
name description usage argument-hint allowed-tools
execute Auto-execution of implementation tasks with YOLO permissions and intelligent context inference /cli:execute [--tool <codex|gemini|qwen>] [--enhance] <description|task-id> [--tool codex|gemini|qwen] [--enhance] description or task-id SlashCommand(*), Bash(*)

CLI Execute Command (/cli:execute)

Purpose

Execute implementation tasks with YOLO permissions (auto-approves all confirmations). MODIFIES CODE.

Intent: Autonomous code implementation, modification, and generation Supported Tools: codex, gemini (default), qwen Key Feature: Automatic context inference and file pattern detection

Core Behavior

  1. Code Modification: This command MODIFIES, CREATES, and DELETES code files
  2. Auto-Approval: YOLO mode bypasses confirmation prompts for all operations
  3. Implementation Focus: Executes actual code changes, not just recommendations
  4. Requires Explicit Intent: Use only when implementation is intended

Core Concepts

YOLO Permissions

Auto-approves: file pattern inference, execution, file modifications, summary generation

⚠️ WARNING: This command will make actual code changes without manual confirmation

Execution Modes

1. Description Mode (supports --enhance):

  • Input: Natural language description
  • Process: [Optional: Enhance] → Keyword analysis → Pattern inference → Execute

2. Task ID Mode (no --enhance):

  • Input: Workflow task identifier (e.g., IMPL-001)
  • Process: Task JSON parsing → Scope analysis → Execute

Context Inference

Auto-selects files based on keywords and technology:

  • "auth" → @{**/*auth*,**/*user*}
  • "React" → @{src/**/*.{jsx,tsx}}
  • "api" → @{**/api/**/*,**/routes/**/*}
  • Always includes: @{CLAUDE.md,**/*CLAUDE.md}

For precise file targeting, use rg or MCP tools to discover files first.

Codex Session Continuity

Resume Pattern for related tasks:

# First task - establish session
codex -C [dir] --full-auto exec "[task]" --skip-git-repo-check -s danger-full-access

# Related task - continue session
codex --full-auto exec "[related-task]" resume --last --skip-git-repo-check -s danger-full-access

Use resume --last when current task extends/relates to previous execution. See intelligent-tools-strategy.md for auto-resume rules.

Parameters

  • --tool <codex|gemini|qwen> - Select CLI tool (default: gemini)
  • --enhance - Enhance input with /enhance-prompt first (Description Mode only)
  • <description|task-id> - Natural language description or task identifier
  • --debug - Verbose logging
  • --save-session - Save execution to workflow session

Workflow Integration

Session Management: Auto-detects .workflow/.active-* marker

  • Active session: Save to .workflow/WFS-[id]/.chat/execute-[timestamp].md
  • No session: Create new session or save to scratchpad

Task Integration: Load from .task/[TASK-ID].json, update status, generate summary

Output Routing

Execution Log Destination:

  • IF active workflow session exists:
    • Save to .workflow/WFS-[id]/.chat/execute-[timestamp].md
    • Update task status in .task/[TASK-ID].json (if task ID provided)
    • Generate summary in .workflow/WFS-[id]/.summaries/[TASK-ID]-summary.md
  • ELSE (no active session):
    • Option 1: Create new workflow session for task
    • Option 2: Save to .workflow/.scratchpad/execute-[description]-[timestamp].md

Output Files (when active session exists):

  • Execution log: .workflow/WFS-[id]/.chat/execute-[timestamp].md
  • Task summary: .workflow/WFS-[id]/.summaries/[TASK-ID]-summary.md (if task ID)
  • Modified code: Project files per implementation

Examples:

  • During session WFS-auth-system, executing IMPL-001:
    • Log: .workflow/WFS-auth-system/.chat/execute-20250105-143022.md
    • Summary: .workflow/WFS-auth-system/.summaries/IMPL-001-summary.md
  • No session, ad-hoc implementation:
    • Log: .workflow/.scratchpad/execute-jwt-auth-20250105-143045.md

Command Template

# Gemini/Qwen: MODE=write with --approval-mode yolo
cd . && ~/.claude/scripts/gemini-wrapper --approval-mode yolo -p "
PURPOSE: [implementation goal]
TASK: [specific implementation]
MODE: write
CONTEXT: @{CLAUDE.md} [auto-detected files]
EXPECTED: Working implementation with code changes
RULES: [constraints] | Auto-approve all changes
"

# Codex: MODE=auto with danger-full-access
codex -C . --full-auto exec "
PURPOSE: [implementation goal]
TASK: [specific implementation]
MODE: auto
CONTEXT: [auto-detected files]
EXPECTED: Complete implementation with tests
" --skip-git-repo-check -s danger-full-access

Examples

Basic Implementation (⚠️ modifies code):

/cli:execute "implement JWT authentication with middleware"
# Executes: Creates auth middleware, updates routes, modifies config
# Result: NEW/MODIFIED code files with JWT implementation

Enhanced Implementation (⚠️ modifies code):

/cli:execute --enhance "implement JWT authentication"
# Step 1: Enhance to expand requirements
# Step 2: Execute implementation with auto-approval
# Result: Complete auth system with MODIFIED code files

Task Execution (⚠️ modifies code):

/cli:execute IMPL-001
# Reads: .task/IMPL-001.json for requirements
# Executes: Implementation based on task spec
# Result: Code changes per task definition

Codex Implementation (⚠️ modifies code):

/cli:execute --tool codex "optimize database queries"
# Executes: Codex with full file access
# Result: MODIFIED query code, new indexes, updated tests

Qwen Code Generation (⚠️ modifies code):

/cli:execute --tool qwen --enhance "refactor auth module"
# Step 1: Enhanced refactoring plan
# Step 2: Execute with MODE=write
# Result: REFACTORED auth code with structural changes

Comparison with Analysis Commands

Command Intent Code Changes Auto-Approve
/cli:analyze Understand code NO N/A
/cli:chat Ask questions NO N/A
/cli:execute Implement YES YES

Notes

  • Command templates, YOLO mode details, and session management: see intelligent-tools-strategy.md (loaded in memory)
  • Output routing and scratchpad details: see workflow-architecture.md
  • ⚠️ Code Modification: This command modifies code - execution logs document changes made