mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-11 02:33:51 +08:00

Files

catlog22 467963eee2 docs: refactor CLI command docs to eliminate redundancy

Streamlined 7 CLI command documentation files by removing duplicate
content that's already comprehensively covered in intelligent-tools-strategy.md
(loaded in memory). Established single source of truth (SSOT) pattern.

Changes:
- Removed duplicate command templates (→ strategy lines 51-118)
- Removed file pattern reference lists (→ strategy lines 324-329)
- Removed complex pattern discovery steps (→ strategy lines 331-355)
- Removed MODE field definitions (→ strategy lines 128-143)
- Removed tool feature descriptions (→ strategy lines 283-322)

Files streamlined:
- analyze.md: 117→61 lines (48% reduction)
- chat.md: 118→62 lines (47% reduction)
- execute.md: 180→100 lines (44% reduction)
- codex-execute.md: 481→473 lines (2% - preserved unique content)
- mode/bug-index.md: 144→75 lines (48% reduction)
- mode/code-analysis.md: 188→76 lines (60% reduction)
- mode/plan.md: 100→76 lines (24% reduction)

Total reduction: 681 lines removed across all files

Each doc now contains only:
- Unique purpose and parameters
- Command-specific execution flow
- Practical examples
- Brief reference to intelligent-tools-strategy.md

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

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

2025-10-05 10:35:27 +08:00

3.2 KiB

Raw Blame History

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

name

description

usage

argument-hint

examples

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

/cli:execute "implement user authentication system"

/cli:execute --tool qwen --enhance "optimize React component"

/cli:execute --tool codex IMPL-001

/cli:execute --enhance "fix API performance issues"

SlashCommand(*), Bash(*)

CLI Execute Command (/cli:execute)

Purpose

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

Supported Tools: codex, gemini (default), qwen Key Feature: Automatic context inference and file pattern detection

Core Concepts

YOLO Permissions

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

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

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

Examples

# Description mode with auto-detection
/cli:execute "implement JWT authentication with middleware"

# Enhanced prompt
/cli:execute --enhance "implement JWT authentication"

# Task ID mode
/cli:execute IMPL-001

# Codex execution
/cli:execute --tool codex "optimize database queries"

# Qwen with enhancement
/cli:execute --tool qwen --enhance "refactor auth module"

Notes

Command templates, YOLO mode details, and session management: see intelligent-tools-strategy.md (loaded in memory)
Auto-generated outputs: .summaries/[TASK-ID]-summary.md, .chat/execute-[timestamp].md

3.2 KiB Raw Blame History