mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-12 02:37:45 +08:00
docs: Distinguish command syntax differences between Gemini and Codex tools
- Add critical warnings in codex-unified.md that no wrapper script exists - Clarify in intelligent-tools.md that Gemini has wrapper, Codex uses direct commands - Prevent confusion about non-existent ~/.claude/scripts/codex - Emphasize correct usage: gemini-wrapper vs codex --full-auto exec - Clean up CLAUDE.md tool references for consistency 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -4,9 +4,10 @@ description: Comprehensive Codex CLI guidelines - core rules, syntax, patterns,
|
|||||||
type: technical-guideline
|
type: technical-guideline
|
||||||
---
|
---
|
||||||
|
|
||||||
### 🚀 Command Overview: Bash(codex *)
|
### 🚀 Command Overview: Bash(codex *)
|
||||||
|
|
||||||
- **Purpose**: An AI-powered CLI tool for automated codebase analysis, intelligent code generation, and autonomous development workflows.
|
- **Purpose**: An AI-powered CLI tool for automated codebase analysis, intelligent code generation, and autonomous development workflows.
|
||||||
|
- **⚠️ CRITICAL**: **NO wrapper script exists** - always use direct `codex` command, never `~/.claude/scripts/codex`
|
||||||
- **Key Characteristic**: **No `--all-files` flag** - requires explicit `@` pattern references for file inclusion.
|
- **Key Characteristic**: **No `--all-files` flag** - requires explicit `@` pattern references for file inclusion.
|
||||||
- **Directory Analysis Rule**: When user intends to analyze specific directory (cd XXX), use: `bash(codex --cd XXX --full-auto exec "prompt")` or `bash(cd XXX && codex --full-auto exec "@{**/*} prompt")`
|
- **Directory Analysis Rule**: When user intends to analyze specific directory (cd XXX), use: `bash(codex --cd XXX --full-auto exec "prompt")` or `bash(cd XXX && codex --full-auto exec "@{**/*} prompt")`
|
||||||
- **Default Mode**: `--full-auto exec` autonomous development mode (RECOMMENDED for all tasks).
|
- **Default Mode**: `--full-auto exec` autonomous development mode (RECOMMENDED for all tasks).
|
||||||
@@ -42,8 +43,10 @@ type: technical-guideline
|
|||||||
- **Basic Structure** (Priority Order):
|
- **Basic Structure** (Priority Order):
|
||||||
```bash
|
```bash
|
||||||
bash(codex --full-auto exec "autonomous development task") # DEFAULT & RECOMMENDED
|
bash(codex --full-auto exec "autonomous development task") # DEFAULT & RECOMMENDED
|
||||||
bash(codex --full-auto exec "prompt with @{patterns}") # For specific control needs
|
bash(codex --full-auto exec "prompt with @{patterns}") # For specific control needs
|
||||||
```
|
```
|
||||||
|
|
||||||
|
**⚠️ NEVER use**: `~/.claude/scripts/codex` - this wrapper script does not exist!
|
||||||
- **Key Commands** (In Order of Preference):
|
- **Key Commands** (In Order of Preference):
|
||||||
- `bash(codex --full-auto exec "...")` ⭐ **PRIMARY MODE** - Full autonomous development
|
- `bash(codex --full-auto exec "...")` ⭐ **PRIMARY MODE** - Full autonomous development
|
||||||
- `bash(codex --full-auto exec "...")` - Controlled execution when you need specific patterns
|
- `bash(codex --full-auto exec "...")` - Controlled execution when you need specific patterns
|
||||||
|
|||||||
@@ -16,6 +16,7 @@ This document provides strategic guidance for selecting the appropriate analysis
|
|||||||
## Tool Characteristics Comparison
|
## Tool Characteristics Comparison
|
||||||
|
|
||||||
### Gemini
|
### Gemini
|
||||||
|
- **Command Syntax**: `bash(~/.claude/scripts/gemini-wrapper -p "prompt")` (HAS wrapper script)
|
||||||
- **Strengths**:
|
- **Strengths**:
|
||||||
- Large context window for analyzing many files simultaneously
|
- Large context window for analyzing many files simultaneously
|
||||||
- Excellent pattern recognition across modules
|
- Excellent pattern recognition across modules
|
||||||
@@ -27,6 +28,7 @@ This document provides strategic guidance for selecting the appropriate analysis
|
|||||||
- Refactoring with broad dependencies
|
- Refactoring with broad dependencies
|
||||||
|
|
||||||
### Codex
|
### Codex
|
||||||
|
- **Command Syntax**: `bash(codex --full-auto exec "prompt")` (NO wrapper script - direct command only)
|
||||||
- **Strengths**:
|
- **Strengths**:
|
||||||
- Superior mathematical and algorithmic reasoning
|
- Superior mathematical and algorithmic reasoning
|
||||||
- Deeper technical knowledge base
|
- Deeper technical knowledge base
|
||||||
@@ -82,6 +84,20 @@ Task(subagent_type="general-purpose",
|
|||||||
Commands should reference this strategy guide for tool selection decisions.
|
Commands should reference this strategy guide for tool selection decisions.
|
||||||
Specific tool usage syntax and examples are documented in their respective unified guides.
|
Specific tool usage syntax and examples are documented in their respective unified guides.
|
||||||
|
|
||||||
|
## ⚠️ CRITICAL Command Syntax Differences
|
||||||
|
|
||||||
|
**Gemini** (HAS intelligent wrapper):
|
||||||
|
```bash
|
||||||
|
bash(~/.claude/scripts/gemini-wrapper -p "analyze patterns")
|
||||||
|
```
|
||||||
|
|
||||||
|
**Codex** (NO wrapper - direct command only):
|
||||||
|
```bash
|
||||||
|
bash(codex --full-auto exec "implement feature")
|
||||||
|
```
|
||||||
|
|
||||||
|
**❌ NEVER use**: `~/.claude/scripts/codex` - this does not exist!
|
||||||
|
|
||||||
**See also**:
|
**See also**:
|
||||||
- Gemini detailed usage: @~/.claude/workflows/gemini-unified.md
|
- Gemini detailed usage: @~/.claude/workflows/gemini-unified.md
|
||||||
- Codex detailed usage: @~/.claude/workflows/codex-unified.md
|
- Codex detailed usage: @~/.claude/workflows/codex-unified.md
|
||||||
@@ -5,8 +5,6 @@
|
|||||||
This document defines project-specific coding standards and development principles.
|
This document defines project-specific coding standards and development principles.
|
||||||
### CLI Tool Context Protocols
|
### CLI Tool Context Protocols
|
||||||
For all CLI tool usage, command syntax, and integration guidelines:
|
For all CLI tool usage, command syntax, and integration guidelines:
|
||||||
- **Gemini (Analysis)**: @~/.claude/workflows/gemini-unified.md
|
|
||||||
- **Codex (Development)**: @~/.claude/workflows/codex-unified.md
|
|
||||||
- **Tool Selection Strategy**: @~/.claude/workflows/intelligent-tools.md
|
- **Tool Selection Strategy**: @~/.claude/workflows/intelligent-tools.md
|
||||||
|
|
||||||
### Intelligent Context Acquisition
|
### Intelligent Context Acquisition
|
||||||
|
|||||||
Reference in New Issue
Block a user