From 9fe8d28218ded98091cdc0310292be5605d894c4 Mon Sep 17 00:00:00 2001
From: catlog22 <catlog22@github.com>
Date: Mon, 13 Oct 2025 11:21:56 +0800
Subject: [PATCH] docs: clarify semantic tool invocation concept in Getting
 Started guides
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixed the "Semantic Tool Invocation" concept to accurately reflect its meaning:

**Before**: "Gemini 工具语义调用" referred to direct script usage
**After**: Properly describes semantic invocation as natural language interaction

Changes:
- Added "Semantic Tool Invocation" section explaining natural language usage
  - Example: User says "Use gemini to analyze architecture"
  - Claude understands and automatically executes appropriate commands
  - Highlighted advantages: natural interaction, intelligent understanding, auto optimization

- Renamed previous section to "Direct Gemini Wrapper Script Usage"
  - Clarified this is for scenarios requiring precise control
  - Maintained all existing script usage examples

Structure now clearly distinguishes:
1. Semantic invocation (natural language → Claude → tool execution)
2. Direct script usage (manual command execution)

Updated both:
- GETTING_STARTED.md (English)
- GETTING_STARTED_CN.md (Chinese)

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

Co-Authored-By: Claude <noreply@anthropic.com>
---
 GETTING_STARTED.md    | 36 ++++++++++++++++++++++++++++++++++--
 GETTING_STARTED_CN.md | 36 ++++++++++++++++++++++++++++++++++--
 2 files changed, 68 insertions(+), 4 deletions(-)

diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md
index 7b6c2c78..23563143 100644
--- a/GETTING_STARTED.md
+++ b/GETTING_STARTED.md
@@ -169,9 +169,41 @@ Use specific analysis modes for in-depth exploration:
 /cli:mode:bug-index --tool gemini "Analyze potential causes of memory leak"
 ```
 
-### Semantic Gemini Tool Invocation
+### Semantic Tool Invocation
 
-CCW provides a convenient Gemini Wrapper script for semantic project analysis and document generation.
+Users can tell Claude to use specific tools through natural language, and Claude will understand the intent and automatically execute the appropriate commands.
+
+#### Semantic Invocation Examples
+
+Describe needs directly in conversation using natural language:
+
+**Example 1: Code Analysis**
+```
+User: "Use gemini to analyze the modular architecture of this project"
+→ Claude will automatically execute gemini-wrapper for analysis
+```
+
+**Example 2: Document Generation**
+```
+User: "Use gemini to generate API documentation with all endpoint descriptions"
+→ Claude will understand the need and automatically invoke gemini's write mode
+```
+
+**Example 3: Code Implementation**
+```
+User: "Use codex to implement user login functionality"
+→ Claude will invoke the codex tool for autonomous development
+```
+
+#### Advantages of Semantic Invocation
+
+- **Natural Interaction**: No need to memorize complex command syntax
+- **Intelligent Understanding**: Claude selects appropriate tools and parameters based on context
+- **Automatic Optimization**: Claude automatically adds necessary context and configuration
+
+### Direct Gemini Wrapper Script Usage
+
+For scenarios requiring precise control, the Gemini Wrapper script can be used directly.
 
 #### Basic Analysis (Read-only Mode)
 
diff --git a/GETTING_STARTED_CN.md b/GETTING_STARTED_CN.md
index 391ed46a..31da9c51 100644
--- a/GETTING_STARTED_CN.md
+++ b/GETTING_STARTED_CN.md
@@ -169,9 +169,41 @@ CCW 支持通过统一的 CLI 接口直接调用外部 AI 工具（Gemini、Qwen
 /cli:mode:bug-index --tool gemini "分析内存泄漏问题的可能原因"
 ```
 
-### Gemini 工具语义调用
+### 工具语义调用
 
-CCW 提供便捷的 Gemini Wrapper 脚本，支持语义化的项目分析和文档生成。
+用户可以通过自然语言告诉 Claude 使用特定工具完成任务，Claude 会理解意图并自动执行相应的命令。
+
+#### 语义调用示例
+
+直接在对话中使用自然语言描述需求：
+
+**示例 1：代码分析**
+```
+用户："使用 gemini 分析一下这个项目的模块化架构"
+→ Claude 会自动执行 gemini-wrapper 进行分析
+```
+
+**示例 2：文档生成**
+```
+用户："用 gemini 生成 API 文档，包含所有端点的说明"
+→ Claude 会理解需求，自动调用 gemini 的写入模式生成文档
+```
+
+**示例 3：代码实现**
+```
+用户："使用 codex 实现用户登录功能"
+→ Claude 会调用 codex 工具进行自主开发
+```
+
+#### 语义调用的优势
+
+- **自然交互**：无需记忆复杂的命令语法
+- **智能理解**：Claude 会根据上下文选择合适的工具和参数
+- **自动优化**：Claude 会自动添加必要的上下文和配置
+
+### Gemini Wrapper 脚本直接使用
+
+对于需要精确控制的场景，也可以直接使用 Gemini Wrapper 脚本。
 
 #### 基础分析（只读模式）