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

2.2 KiB

name, description, usage, argument-hint, examples, allowed-tools
name description usage argument-hint examples allowed-tools
bug-index Bug analysis and fix suggestions using CLI tools /cli:mode:bug-index [--tool <codex|gemini|qwen>] [--enhance] [--cd "path"] "bug description" [--tool codex|gemini|qwen] [--enhance] [--cd path] bug description
/cli:mode:bug-index "authentication null pointer error"
/cli:mode:bug-index --tool qwen --enhance "login not working"
/cli:mode:bug-index --tool codex --cd "src/auth" "token validation fails"
SlashCommand(*), Bash(*)

CLI Mode: Bug Index (/cli:mode:bug-index)

Purpose

Systematic bug analysis with diagnostic template (~/.claude/prompt-templates/bug-fix.md).

Supported Tools: codex, gemini (default), qwen Key Feature: --cd flag for directory-scoped analysis

Parameters

  • --tool <codex|gemini|qwen> - Tool selection (default: gemini)
  • --enhance - Enhance bug description with /enhance-prompt first
  • --cd "path" - Target directory for focused analysis
  • <bug-description> (Required) - Bug description or error message

Execution Flow

  1. Parse tool and directory options
  2. If --enhance: Execute /enhance-prompt to expand bug context
  3. Use bug-fix template: ~/.claude/prompt-templates/bug-fix.md
  4. Execute with --all-files in target directory
  5. Save to .workflow/WFS-[id]/.chat/bug-index-[timestamp].md

Analysis Focus (via Template)

  • Root cause investigation
  • Code path tracing
  • Targeted minimal fixes
  • Impact assessment

Examples

# Basic bug analysis
/cli:mode:bug-index "null pointer in authentication"

# Directory-specific
/cli:mode:bug-index --cd "src/auth" "token validation fails"

# Enhanced description
/cli:mode:bug-index --enhance "login broken"

# Qwen for architecture-related bugs
/cli:mode:bug-index --tool qwen "circular dependency in modules"

Bug Investigation Workflow

# 1. Find bug-related files
rg "error_keyword" --files-with-matches

# 2. Execute bug analysis with focused context
/cli:mode:bug-index --cd "src/module" "specific error description"

Notes

  • Command templates and file patterns: see intelligent-tools-strategy.md (loaded in memory)
  • Template path: ~/.claude/prompt-templates/bug-fix.md
  • Always uses --all-files for comprehensive codebase context