From e8a5980c88356bf44c58a7906be850e6c064909f Mon Sep 17 00:00:00 2001 From: catlog22 Date: Thu, 6 Nov 2025 16:52:31 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=AD=A3=20CLI=20=E5=B7=A5?= =?UTF-8?q?=E5=85=B7=E8=AF=AD=E4=B9=89=E8=B0=83=E7=94=A8=E6=A6=82=E5=BF=B5?= =?UTF-8?q?=E5=B9=B6=E7=B2=BE=E7=AE=80=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 核心修改： 1. 修正语义调用触发方式：用户必须明确说"使用 gemini"、"用 qwen"、"让 codex" 2. 区分两种调用方式： - CLI 工具语义调用：用户明确指定工具 → Claude 生成 CLI 命令 - Slash 命令调用：用户输入 /workflow:* 或 /cli:* → 执行预定义流程 3. 精简文档结构： - 删除过多的重复示例和详细步骤 - 简化能力特性清单 - 删除进阶技巧和避免做法部分 - 添加常用工作流程指南 4. 更新所有使用场景示例，确保触发方式正确 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../command-guide/guides/cli-tools-guide.md | 692 ++++++++---------- 1 file changed, 307 insertions(+), 385 deletions(-) diff --git a/.claude/skills/command-guide/guides/cli-tools-guide.md b/.claude/skills/command-guide/guides/cli-tools-guide.md index f75429ef..95e29760 100644 --- a/.claude/skills/command-guide/guides/cli-tools-guide.md +++ b/.claude/skills/command-guide/guides/cli-tools-guide.md @@ -1,12 +1,21 @@ # CLI 工具使用指南 -> 从用户视角理解和使用 Gemini、Qwen、Codex 三大 CLI 工具 +> **SKILL 参考文档**：用于回答用户关于 CLI 工具（Gemini、Qwen、Codex）的使用问题 +> +> **用途**：当用户询问 CLI 工具的能力、使用方法、调用方式时，从本文档中提取相关信息，根据用户具体需求加工后返回 ## 🎯 快速理解：CLI 工具是什么？ -CLI 工具是集成在 Claude DMS3 中的**智能分析和执行助手**。你不需要记忆复杂的命令格式，只需用自然语言描述你想做什么，工具会自动完成。 +CLI 工具是集成在 Claude DMS3 中的**智能分析和执行助手**。 -**核心理念**：用自然语言描述需求 → CLI 工具理解并执行 → 返回结果 +**工作流程**： +1. **用户** → 用自然语言向 Claude Code 描述需求（如"分析认证模块的安全性"） +2. **Claude Code** → 识别用户意图，决定使用哪种方式： + - **CLI 工具语义调用**：生成并执行 `gemini`/`qwen`/`codex` 命令 + - **Slash 命令调用**：执行预定义的工作流命令（如 `/workflow:plan`） +3. **工具** → 自动完成任务并返回结果 + +**核心理念**：用户用自然语言描述需求 → Claude Code 选择最佳方式 → 工具执行 → 返回结果 --- @@ -24,191 +33,239 @@ CLI 工具是集成在 Claude DMS3 中的**智能分析和执行助手**。你 --- -## 🚀 如何调用：两种方式 +## 🚀 Claude Code 的两种响应方式 -### 方式 1：语义调用（推荐，最优雅） +当用户用自然语言描述需求时，Claude Code 会根据任务特性选择最佳方式： -**通过 workflow 命令**，用自然语言描述需求，系统自动选择合适的 CLI 工具： +### 方式 1：CLI 工具语义调用（灵活、强大） +**用户明确指示使用 CLI 工具**，Claude Code 生成并执行相应命令。 + +#### 示例 1：Gemini 语义分析 + +**用户输入**（必须明确提到工具）： +``` +使用 gemini 分析认证模块的安全性，识别潜在的安全漏洞， +关注 JWT 令牌处理、密码存储、会话管理等方面， +提供具体的修复建议 +``` + +**Claude Code 生成并执行**（CLI 命令）： ```bash -# 自动规划和分析 -/workflow:plan "实现用户认证功能" +cd src/auth && gemini -p " +分析认证模块的安全性，识别潜在的安全漏洞， +关注 JWT 令牌处理、密码存储、会话管理等方面， +提供具体的修复建议 +" -m gemini-3-pro-preview-11-2025 +``` -# 自动执行实现 +**工具输出**：Gemini 自动理解任务，组合多个分析步骤，返回结构化报告 + +--- + +#### 示例 2：Qwen 语义分析（Gemini 的备选） + +**用户输入**： +``` +用 qwen 追踪用户登录的完整执行流程， +从 API 入口到数据库查询， +列出所有调用的函数和依赖关系 +``` + +**Claude Code 生成并执行**： +```bash +cd src/auth && qwen -p " +追踪用户登录的完整执行流程， +从 API 入口到数据库查询， +列出所有调用的函数和依赖关系 +" -m coder-model +``` + +**工具输出**：Qwen 理解需求，自动追踪执行路径 + +--- + +#### 示例 3：Codex 语义实现 + +**用户输入**： +``` +让 codex 实现 JWT 令牌刷新机制： +1. 添加 refreshToken 端点 +2. 验证旧令牌的有效性 +3. 生成新的访问令牌 +4. 确保安全性（防重放攻击） +``` + +**Claude Code 生成并执行**： +```bash +codex -C src/auth --full-auto exec " +实现 JWT 令牌刷新机制： +1. 添加 refreshToken 端点 +2. 验证旧令牌的有效性 +3. 生成新的访问令牌 +4. 确保安全性（防重放攻击） +" -m gpt-5 --skip-git-repo-check -s danger-full-access +``` + +**工具输出**：Codex 理解需求，自动生成代码并集成到现有系统 + +--- + +**核心特点**： +- ✅ **用户明确指定工具**：必须说"使用 gemini"、"用 qwen"、"让 codex"等触发工具调用 +- ✅ **Claude 生成命令**：识别工具名称后，自动构造最优的 CLI 工具调用 +- ✅ **工具自动理解**：CLI 工具解析需求，组合分析/实现步骤 +- ✅ **灵活强大**：不受预定义工作流限制 +- ✅ **精确控制**：Claude 可指定工作目录、文件范围、模型参数 + +**触发方式**： +- "使用 gemini ..." +- "用 qwen ..." +- "让 codex ..." +- "通过 gemini 工具..." + +**Claude Code 何时选择此方式**： +- 用户明确指定使用某个 CLI 工具 +- 复杂分析任务（跨模块、多维度） +- 自定义工作流需求 +- 需要精确控制上下文范围 + +--- + +### 方式 2：Slash 命令调用（标准工作流） + +**用户直接输入 Slash 命令**，或 **Claude Code 建议使用 Slash 命令**，系统执行预定义工作流（内部调用 CLI 工具）。 + +#### Workflow 类命令（系统自动选择工具） + +**示例 1：规划任务** + +**用户输入**： +``` +/workflow:plan --agent "实现用户认证功能" +``` + +**系统执行**：内部调用 gemini/qwen 分析 + action-planning-agent 生成任务 + +--- + +**示例 2：执行任务** + +**用户输入**： +``` /workflow:execute +``` -# 自动生成测试 +**系统执行**：内部调用 codex 实现代码 + +--- + +**示例 3：生成测试** + +**用户输入**： +``` /workflow:test-gen WFS-xxx ``` -**优点**： -- ✅ 无需指定工具，系统自动选择 -- ✅ 自然语言描述，无需记忆格式 -- ✅ 集成完整工作流 - -**适用场景**：日常开发任务、标准工作流 +**系统执行**：内部调用 gemini 分析 + codex 生成测试 --- -### 方式 2：直接命令调用（精确控制） +#### CLI 类命令（指定工具） -**直接调用特定 CLI 工具**，适合需要精确控制的场景： +**示例 1：封装的分析命令** -#### Gemini/Qwen（分析类） - -```bash -# 基础格式 -/cli:analyze --tool gemini "分析认证模块的安全性" - -# 带增强模式 -/cli:analyze --tool gemini --enhance "代码执行流程追踪" - -# 指定工作目录 -/cli:analyze --tool gemini --cd src/auth "分析当前模块" +**用户输入**： +``` +/cli:analyze --tool gemini "分析认证模块" ``` -#### Codex（实现类） - -```bash -# 基础执行 -/cli:execute --tool codex "实现 JWT 令牌刷新机制" - -# 自动化执行（YOLO 模式） -/cli:codex-execute "实现用户登录功能" - -# 使用 agent 模式 -/cli:execute --agent --tool codex "重构认证服务" -``` - -**优点**： -- ✅ 精确指定工具和模式 -- ✅ 灵活的参数控制 -- ✅ 适合高级用户 - -**适用场景**：特定工具需求、自定义参数、高级控制 +**系统执行**：使用 gemini 工具进行分析 --- -## 💡 能力特性清单 +**示例 2：封装的执行命令** -### Gemini 能力 - -**🔍 深度分析** -- 执行流程追踪 -- 依赖关系分析 -- 代码模式识别 -- 架构评审 - -**🎯 规划设计** -- 架构设计 -- 技术方案评估 -- 任务分解 -- 迁移策略 - -**📚 文档生成** -- API 文档 -- 模块说明 -- 使用指南 - -**使用示例**： -```bash -# 追踪代码执行流程 -/cli:analyze --tool gemini "追踪用户登录的完整流程" - -# 架构设计 -/cli:mode:plan --tool gemini "设计微服务通信架构" - -# 代码模式分析 -/cli:analyze --tool gemini "识别项目中的设计模式" +**用户输入**： ``` +/cli:execute --tool codex "实现 JWT 刷新" +``` + +**系统执行**：使用 codex 工具实现功能 --- -### Qwen 能力 +**示例 3：快速执行（YOLO 模式）** -**作为 Gemini 的备选方案**，能力基本相同： -- 代码分析 -- 模式识别 -- 架构评审 - -**何时使用**： -- Gemini 不可用 -- 需要第二意见 -- 特定领域分析 - -**使用示例**： -```bash -# Gemini 不可用时的备选 -/cli:analyze --tool qwen "分析数据处理模块" - -# 并行使用获取多角度分析 -/cli:analyze --tool gemini "分析认证模块" & -/cli:analyze --tool qwen "分析认证模块" +**用户输入**： ``` +/cli:codex-execute "添加用户头像上传" +``` + +**系统执行**：使用 codex 快速实现 --- -### Codex 能力 +**核心特点**： +- ✅ **用户可直接输入**：Slash 命令格式固定，用户可以直接输入（如 `/workflow:plan`） +- ✅ **Claude 可建议**：Claude Code 也可以识别需求后建议或执行 Slash 命令 +- ✅ **预定义流程**：标准化的工作流模板 +- ✅ **自动工具选择**：workflow 命令内部自动选择合适的 CLI 工具 +- ✅ **集成完整**：包含规划、执行、测试、文档等环节 +- ✅ **简单易用**：无需了解底层 CLI 工具细节 -**⚡ 代码实现** -- 功能开发 -- 组件实现 -- API 创建 -- UI 组件 - -**🧪 测试生成** -- 单元测试 -- 集成测试 -- 测试用例 -- TDD 支持 - -**🔧 代码重构** -- 结构优化 -- 性能改进 -- 代码清理 - -**🤖 自动化执行** -- 完整功能实现 -- Bug 修复 -- 批量操作 - -**使用示例**： -```bash -# 功能实现 -/cli:execute --tool codex "实现用户注册功能，包含邮箱验证" - -# 测试生成 -/workflow:test-gen WFS-session-id - -# 自动化执行（YOLO 模式） -/cli:codex-execute --verify-git "重构认证服务，使用依赖注入" - -# Bug 修复 -/cli:mode:bug-diagnosis --tool codex "修复登录超时问题" -``` +**Claude Code 何时选择此方式**： +- 标准开发任务（功能开发、测试、重构） +- 团队协作（统一工作流） +- 适合新手（降低学习曲线） +- 快速开发（减少配置时间） --- -## 🎓 使用场景决策树 +## 🔄 两种方式对比 -```mermaid -graph TD - A[我想...] --> B{是分析还是实现?} - B -->|分析理解| C[使用 Gemini/Qwen] - B -->|实现开发| D[使用 Codex] +| 维度 | CLI 工具语义调用 | Slash 命令调用 | +|------|------------------|----------------| +| **用户输入** | 纯自然语言描述需求 | `/` 开头的固定命令格式 | +| **Claude Code 行为** | 生成并执行 `gemini`/`qwen`/`codex` 命令 | 执行预定义工作流（内部调用 CLI 工具） | +| **灵活性** | 完全自定义任务和执行方式 | 固定工作流模板 | +| **学习曲线** | 用户无需学习（纯自然语言） | 需要知道 Slash 命令名称 | +| **适用复杂度** | 复杂、探索性、定制化任务 | 标准、重复性、工作流化任务 | +| **工具选择** | Claude 自动选择最佳 CLI 工具 | 系统自动选择（workflow 类）
或用户指定（cli 类） | +| **典型场景** | 深度分析、自定义流程、探索研究 | 日常开发、团队协作、标准流程 | - C --> C1{具体需求?} - C1 -->|理解代码流程| C2[/cli:mode:code-analysis] - C1 -->|诊断bug| C3[/cli:mode:bug-diagnosis] - C1 -->|设计架构| C4[/cli:mode:plan] - C1 -->|一般分析| C5[/cli:analyze] +**使用建议**： +- **日常开发** → 优先使用 Slash 命令（标准化、快速） +- **复杂分析** → Claude 自动选择 CLI 工具语义调用（灵活、强大） +- **用户角度** → 只需用自然语言描述需求，Claude Code 会选择最佳方式 - D --> D1{具体需求?} - D1 -->|完整功能| D2[/cli:codex-execute] - D1 -->|精确控制| D3[/cli:execute] - D1 -->|生成测试| D4[/workflow:test-gen] - D1 -->|标准流程| D5[/workflow:execute] -``` +--- + +## 💡 工具能力速查 + +### Gemini - 分析与规划 +- 执行流程追踪、依赖分析、代码模式识别 +- 架构设计、技术方案评估、任务分解 +- 文档生成（API 文档、模块说明） + +**触发示例**：`使用 gemini 追踪用户登录的完整流程` + +--- + +### Qwen - Gemini 的备选 +- 代码分析、模式识别、架构评审 +- 作为 Gemini 不可用时的备选方案 + +**触发示例**：`用 qwen 分析数据处理模块` + +--- + +### Codex - 实现与执行 +- 功能开发、组件实现、API 创建 +- 单元测试、集成测试、TDD 支持 +- 代码重构、性能改进、Bug 修复 + +**触发示例**：`让 codex 实现用户注册功能，包含邮箱验证` --- @@ -218,17 +275,13 @@ graph TD **需求**：接手新项目，需要快速理解代码结构 -**推荐方式**： -```bash -# 1. 整体架构分析 -/cli:analyze --tool gemini "分析整个项目的架构设计和模块关系" +**方式 1：CLI 工具语义调用**（推荐，灵活） -# 2. 关键流程追踪 -/cli:mode:code-analysis --tool gemini "追踪用户注册的完整流程" +- **用户输入**：`使用 gemini 分析这个项目的架构设计，识别主要模块、依赖关系和架构模式` +- **Claude Code 生成并执行**：`cd project-root && gemini -p "..." -m gemini-3-pro-preview-11-2025` -# 3. 识别技术栈 -/cli:analyze --tool gemini "识别项目使用的技术栈和设计模式" -``` +**方式 2：Slash 命令** +- **用户输入**：`/cli:analyze --tool gemini "分析项目架构"` --- @@ -236,24 +289,12 @@ graph TD **需求**：实现用户认证功能 -**推荐方式**（语义调用）： -```bash -# 完整工作流 -/workflow:plan --agent "实现用户认证功能，包括注册、登录、JWT 令牌" -/workflow:execute -/workflow:test-gen WFS-xxx -``` +**方式 1：CLI 工具语义调用** +- **用户输入**：`让 codex 实现用户认证功能：注册（邮箱+密码+验证）、登录（JWT token）、刷新令牌，技术栈 Node.js + Express` +- **Claude Code 生成并执行**：`codex -C src/auth --full-auto exec "..." -m gpt-5 --skip-git-repo-check -s danger-full-access` -**或直接调用**（精确控制）： -```bash -# 直接实现 -/cli:codex-execute "实现用户认证功能： -- 用户注册（邮箱+密码） -- 登录验证 -- JWT 令牌生成和刷新 -- 密码加密存储 -" -``` +**方式 2：Slash 命令**（工作流化） +- **用户输入**：`/workflow:plan --agent "实现用户认证功能"` → `/workflow:execute` --- @@ -261,227 +302,108 @@ graph TD **需求**：登录功能偶尔超时 -**推荐方式**： -```bash -# 1. 诊断问题 -/cli:mode:bug-diagnosis --tool gemini "诊断登录超时问题" +**方式 1：CLI 工具语义调用** +- **用户输入**：`使用 gemini 诊断登录超时问题，分析处理流程、性能瓶颈、数据库查询效率` +- **Claude Code 生成并执行**：`cd src/auth && gemini -p "..." -m gemini-3-pro-preview-11-2025` +- **用户输入**：`让 codex 根据上述分析修复登录超时，优化查询、添加缓存` +- **Claude Code 生成并执行**：`codex -C src/auth --full-auto exec "..." -m gpt-5 --skip-git-repo-check -s danger-full-access` -# 2. 分析执行流程 -/cli:mode:code-analysis --tool gemini "追踪登录请求的完整执行路径" +**方式 2：Slash 命令** +- **用户输入**：`/cli:mode:bug-diagnosis --tool gemini "诊断登录超时"` → `/cli:execute --tool codex "修复登录超时"` -# 3. 修复问题（如果需要） -/cli:execute --tool codex "修复登录超时问题，基于上述分析结果" +--- + +### 场景 4：生成文档 + +**需求**：为 API 模块生成完整文档 + +**方式 1：CLI 工具语义调用** +- **用户输入**：`使用 gemini 为 API 模块生成技术文档，包含端点说明、数据模型、使用示例` +- **Claude Code 生成并执行**：`cd src/api && gemini -p "..." -m gemini-3-pro-preview-11-2025 --approval-mode yolo` + +**方式 2：Slash 命令** +- **用户输入**：`/memory:docs src/api --tool gemini --mode full` + +--- + +## 🎯 常用工作流程 + +### 简单 Bug 修复 +``` +使用 gemini 诊断问题（可选其他 cli 工具） +→ Claude 分析 +→ Claude 直接执行修复 +``` + +### 复杂 Bug 修复 +``` +/cli:mode:plan 或 /cli:mode:bug-diagnosis +→ Claude 分析 +→ Claude 执行修复 +``` + +### 简单功能增加 +``` +/cli:mode:plan +→ Claude 执行 +``` + +### 复杂功能增加 +``` +/cli:mode:plan --agent +→ Claude 执行 或 /cli:codex-execute + +或 + +/cli:mode:plan +→ 进入工作流模式（/workflow:execute） +``` + +### 项目内存管理 + +**建立技术栈文档**（为项目提供技术参考） +``` +/memory:tech-research [session-id | tech-stack-name] +``` + +**为项目重建多级结构的 CLAUDE.md 内存** +``` +/memory:docs [path] [--tool gemini|qwen|codex] [--mode full|partial] ``` --- -### 场景 4：代码重构 +## 📚 常用命令速查 -**需求**：重构认证模块，提高可维护性 - -**推荐方式**： -```bash -# 1. 分析现状 -/cli:analyze --tool gemini "评估当前认证模块的代码质量和可维护性" - -# 2. 制定计划 -/cli:mode:plan --tool gemini "制定认证模块重构方案" - -# 3. 执行重构 -/cli:execute --tool codex "重构认证模块，按照上述计划执行" - -# 4. 生成测试 -/workflow:test-gen WFS-xxx -``` +| 需求 | 推荐命令 | +|------|----------| +| **代码分析** | `使用 gemini 分析...` 或 `/cli:analyze --tool gemini` | +| **Bug 诊断** | `/cli:mode:bug-diagnosis` | +| **功能实现** | `/cli:codex-execute` 或 `让 codex 实现...` | +| **架构规划** | `/cli:mode:plan` | +| **生成测试** | `/workflow:test-gen WFS-xxx` | +| **完整工作流** | `/workflow:plan` → `/workflow:execute` | +| **技术文档** | `/memory:tech-research [tech-name]` | +| **项目文档** | `/memory:docs [path]` | --- -### 场景 5：生成文档 +## 🆘 快速提示 -**需求**：为 API 模块生成文档 +**触发 CLI 工具语义调用**： +- "使用 gemini ..." +- "用 qwen ..." +- "让 codex ..." -**推荐方式**： -```bash -# 自动生成文档 -/memory:docs src/api --tool gemini --mode full -``` +**选择工具**： +- **理解/分析/规划** → Gemini +- **实现/测试/执行** → Codex +- **不确定** → 使用 Slash 命令让系统选择 ---- - -## 🎯 最佳实践 - -### ✅ 推荐做法 - -1. **默认使用语义调用** - - 通过 `/workflow:*` 命令描述需求 - - 让系统自动选择合适的工具 - -2. **分析用 Gemini，实现用 Codex** - - 理解问题 → Gemini - - 解决问题 → Codex - -3. **善用 --enhance 参数** - - 让提示自动优化，提高结果质量 - ```bash - /cli:analyze --enhance "分析认证模块" - ``` - -4. **指定工作目录减少噪音** - ```bash - /cli:analyze --cd src/auth "分析当前模块" - ``` - -5. **并行使用获得多角度** - ```bash - /cli:analyze --tool gemini "分析方案A" - /cli:analyze --tool qwen "分析方案A" # 对比结果 - ``` - ---- - -### ❌ 避免做法 - -1. **不要混淆工具职责** - - ❌ 用 Gemini 实现功能 - - ❌ 用 Codex 做架构分析 - -2. **不要忽略工作目录** - - ❌ 在项目根目录分析单个模块 - - ✅ 使用 `--cd` 切换到目标目录 - -3. **不要直接编写技术规范** - - ❌ 手动构造复杂的 RULES 模板 - - ✅ 使用 `--enhance` 让系统优化 - ---- - -## 🔍 进阶技巧 - -### 技巧 1：链式分析 - -```bash -# 步骤 1：理解现状 -/cli:analyze --tool gemini "分析当前认证实现" > analysis.md - -# 步骤 2：基于分析结果制定计划 -/cli:mode:plan --tool gemini "基于 analysis.md，制定改进方案" - -# 步骤 3：执行改进 -/cli:execute --tool codex "按照改进方案执行" -``` - ---- - -### 技巧 2：使用 Agent 模式 - -Agent 模式让 CLI 工具更自主地执行任务： - -```bash -# 标准模式（需要明确指令） -/cli:execute --tool codex "实现用户登录" - -# Agent 模式（更自主，可自行决策） -/cli:execute --agent --tool codex "实现用户认证系统" -``` - -**何时使用 Agent**： -- 任务复杂，需要多步决策 -- 需要工具自主探索代码库 -- 信任工具的判断 - ---- - -### 技巧 3：自定义提示增强 - -```bash -# 使用预定义模板增强 -/cli:analyze --enhance "分析认证模块安全性" - -# 系统会自动： -# 1. 识别任务类型（安全分析） -# 2. 选择合适模板 -# 3. 优化提示词 -# 4. 执行分析 -``` - ---- - -## 📚 快速参考 - -### 常用命令速查 - -| 需求 | 命令 | 示例 | -|------|------|------| -| 代码分析 | `/cli:analyze` | `/cli:analyze --tool gemini "分析auth模块"` | -| Bug 诊断 | `/cli:mode:bug-diagnosis` | `/cli:mode:bug-diagnosis "登录超时"` | -| 功能实现 | `/cli:codex-execute` | `/cli:codex-execute "实现用户注册"` | -| 架构规划 | `/cli:mode:plan` | `/cli:mode:plan "设计微服务架构"` | -| 生成测试 | `/workflow:test-gen` | `/workflow:test-gen WFS-xxx` | -| 完整工作流 | `/workflow:plan` + `/workflow:execute` | 最推荐的标准流程 | - ---- - -### 参数速查 - -| 参数 | 作用 | 示例 | -|------|------|------| -| `--tool ` | 指定CLI工具 | `--tool gemini` | -| `--enhance` | 自动优化提示 | `--enhance` | -| `--agent` | 启用Agent模式 | `--agent` | -| `--cd <路径>` | 切换工作目录 | `--cd src/auth` | -| `--verify-git` | Git状态验证 | `--verify-git` | - ---- - -## 🆘 常见问题 - -### Q: 我该用哪个工具？ - -**A**: 记住简单规则： -- 想**理解/分析/规划** → Gemini -- 想**实现/测试/执行** → Codex -- 不确定 → 用 `/workflow:*` 让系统选 - ---- - -### Q: 语义调用和命令调用有什么区别？ - -**A**: -- **语义调用**（`/workflow:*`）：自然语言描述，系统自动选工具，适合日常 -- **命令调用**（`/cli:*`）：手动指定工具和参数，适合高级控制 - ---- - -### Q: 什么时候用 Agent 模式？ - -**A**: Agent 模式更自主，适合： -- 复杂任务需要多步决策 -- 信任工具的判断 -- 想让工具自主探索 - -**不适合**： -- 精确控制每一步 -- 不确定工具行为 -- 简单任务 - ---- - -### Q: 如何提高结果质量？ - -**A**: -1. 使用 `--enhance` 自动优化提示 -2. 明确描述需求和期望 -3. 指定工作目录减少噪音（`--cd`） -4. 提供上下文（已有的分析、相关代码） - ---- - -## 📖 相关文档 - -- [Intelligent Tools Strategy](../../workflows/intelligent-tools-strategy.md) - 技术规范和高级配置 -- [Workflow Patterns](workflow-patterns.md) - 标准工作流模式 -- [Getting Started](getting-started.md) - 快速入门指南 -- [Troubleshooting](troubleshooting.md) - 问题排查 +**提升质量**： +- 清晰描述需求和期望 +- 提供上下文信息 +- 使用 `--agent` 处理复杂任务 ---