refactor: Streamline Gemini commands documentation and reduce duplication

- Simplify analyze.md, execute.md, bug-index.md, and plan.md command documentation - Remove redundant content and focus on essential usage patterns - Reduce total lines by 503 while maintaining core functionality - Improve documentation clarity and reduce maintenance overhead 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-14 02:42:04 +08:00 · 2025-09-09 22:55:02 +08:00
parent e9cd438144
commit 47493a4db5
4 changed files with 283 additions and 526 deletions
--- a/.claude/commands/gemini/pre/bug-index.md
+++ b/.claude/commands/gemini/pre/bug-index.md
@@ -1,6 +1,5 @@
 ---
 name: bug-index
-
 description: Bug analysis and fix suggestions using specialized template
 usage: /gemini:pre:bug-index "bug description"
 argument-hint: "description of the bug or error you're experiencing"
@@ -12,102 +11,63 @@ allowed-tools: Bash(gemini:*)
 model: sonnet
 ---

-### 🐛 **Command Overview: `/gemini:pre:bug-index`**
+# Bug Analysis Command (/gemini:pre:bug-index)

-   **Type**: Template-based Gemini CLI Wrapper
-   **Purpose**: Specialized bug analysis and fix suggestions using expert diagnostic template
-   **Template**: Bug fix analysis template for systematic problem diagnosis
-   **Core Tool**: `Bash(gemini:*)` - Executes Gemini CLI with bug-fix template
+## Overview
+Systematic bug analysis and fix suggestions using expert diagnostic template.

-### 📥 **Parameters & Usage**
+## Usage

-   **`<bug description>` (Required)**: Description of the bug, error, or unexpected behavior
-   **`--all-files` (Optional)**: Includes entire codebase for comprehensive analysis
-   **`--save-session` (Optional)**: Saves the bug analysis to current workflow session
-
-### 🔄 **Execution Workflow**
-
-`Parse Bug Description` **->** `Load Bug-Fix Template` **->** `Assemble Context` **->** `Execute Gemini CLI` **->** `(Optional) Save Session`
-
-### 📋 **Bug Analysis Focus**
-
-The bug-fix template provides structured analysis covering:
- **Root Cause Analysis**: Systematic investigation of underlying issues
- **Code Path Tracing**: Following execution flow to identify failure points
- **Hypothesis Validation**: Testing theories about bug origins
- **Targeted Solutions**: Specific, minimal fixes rather than broad refactoring
- **Impact Assessment**: Understanding side effects of proposed fixes
-
-### 📚 **Context Assembly**
-
-Context includes:
-1. **Bug-Fix Template**: @~/.claude/prompt-templates/bug-fix.md
-2. **Project Guidelines**: @{CLAUDE.md,**/*CLAUDE.md}
-3. **Relevant Files**: User-specified files or all files if `--all-files` used
-
-### 📝 **Prompt Structure**
-
-```
-=== SYSTEM PROMPT ===
-@~/.claude/prompt-templates/bug-fix.md
-
-=== CONTEXT ===
-@{CLAUDE.md,**/*CLAUDE.md}
-@{target_files}
-
-=== USER INPUT ===
-[Bug description and any relevant details]
+### Basic Bug Analysis
+```bash
+/gemini:pre:bug-index "authentication error during login"
 ```

-### ⚙️ **Implementation**
-
-```pseudo
-FUNCTION execute_bug_fix_analysis(bug_description, flags):
-  // Load bug-fix template
-  template = load_file(@~/.claude/prompt-templates/bug-fix.md)
-  
-  // Construct prompt with template
-  prompt = "=== SYSTEM PROMPT ===\n" + template + "\n\n"
-  prompt += "=== CONTEXT ===\n"
-  prompt += "@{CLAUDE.md,**/*CLAUDE.md}\n"
-  
-  // Execute with appropriate context
-  IF flags contain "--all-files":
-    result = execute_tool("Bash(gemini:*)", "--all-files", "-p", prompt + bug_description)
-  ELSE:
-    prompt += "\n=== USER INPUT ===\n" + bug_description
-    result = execute_tool("Bash(gemini:*)", "-p", prompt)
-  
-  // Save session if requested
-  IF flags contain "--save-session":
-    save_bug_analysis_session(bug_description, result)
-  
-  RETURN result
-END FUNCTION
+### With All Files Context
+```bash
+/gemini:pre:bug-index "React state not updating" --all-files
 ```

-### 💾 **Session Integration**
+### Save to Workflow Session
+```bash
+/gemini:pre:bug-index "API timeout issues" --save-session
+```

-When `--save-session` is used:
- Saves to `.workflow/WFS-[topic]/.chat/` directory
- File named: `bug-index-YYYYMMDD-HHMMSS.md`
- Includes template used, bug description, analysis, and recommendations
+## Command Execution

-**Session Template:**
-```markdown
-# Bug Fix Analysis: [Timestamp]
+**Template Used**: `~/.claude/prompt-templates/bug-fix.md`

-## Bug Description
-[Original bug description]
+**Executes**:
+```bash
+gemini --all-files -p "$(cat ~/.claude/prompt-templates/bug-fix.md)

-## Template Used
-bug-fix.md - Expert diagnostic analysis template
+Context: @{CLAUDE.md,**/*CLAUDE.md}

-## Analysis Results
-[Complete Gemini response with root cause analysis and fix suggestions]
+Bug Description: [user_description]"
+```

-## Recommended Actions
- [Immediate fixes]
- [Prevention measures]
- [Testing recommendations]
-```
+## Analysis Focus
+
+The bug-fix template provides:
+- **Root Cause Analysis**: Systematic investigation
+- **Code Path Tracing**: Following execution flow  
+- **Targeted Solutions**: Specific, minimal fixes
+- **Impact Assessment**: Understanding side effects
+
+## Options
+
+| Option | Purpose |
+|--------|---------|
+| `--all-files` | Include entire codebase for analysis |
+| `--save-session` | Save analysis to workflow session |
+
+## Session Output
+
+When `--save-session` used, saves to:
+`.workflow/WFS-[topic]/.chat/bug-index-[timestamp].md`
+
+**Includes:**
+- Bug description
+- Template used  
+- Analysis results
+- Recommended actions