From d6a2e0de59ecc1e9f9b390bf55cd625ce59004d1 Mon Sep 17 00:00:00 2001
From: catlog22 <catlog22@github.com>
Date: Sat, 17 Jan 2026 11:01:29 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E8=AF=AD=E4=B9=89?=
 =?UTF-8?q?=E5=8C=96=20CLI=20=E8=B0=83=E7=94=A8=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 用户语义指定 CLI 工具，系统自动调用
- 支持协同、并行、迭代、流水线等编排模式
- 示例：'使用 Gemini 和 Codex 协同分析'
---
 README.md    | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 README_CN.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 94 insertions(+)

diff --git a/README.md b/README.md
index ec5ef24c..8a7b2cb8 100644
--- a/README.md
+++ b/README.md
@@ -138,6 +138,53 @@ qwen --version
 
 ---
 
+## 🎭 Semantic CLI Invocation
+
+Users can **semantically specify CLI tools** in prompts - the system automatically invokes the corresponding CLI for analysis.
+
+### Basic Invocation
+
+| User Prompt | System Action |
+|-------------|---------------|
+| "Use Gemini to analyze the auth module" | Auto-invoke `gemini` CLI for analysis |
+| "Let Codex review this code" | Auto-invoke `codex` CLI for review |
+| "Ask Qwen about performance optimization" | Auto-invoke `qwen` CLI for consultation |
+
+### Multi-CLI Orchestration
+
+Users can semantically orchestrate multiple CLIs in a single prompt:
+
+| Pattern | User Prompt Example |
+|---------|---------------------|
+| 🔄 **Collaborative** | "Use Gemini and Codex to collaboratively analyze security vulnerabilities" |
+| ⚡ **Parallel** | "Have Gemini, Codex, and Qwen analyze the architecture in parallel" |
+| 🔁 **Iterative** | "Use Gemini to diagnose, then Codex to fix, iterate until resolved" |
+| 🔗 **Pipeline** | "Gemini designs the solution, Codex implements, Claude reviews" |
+
+### Examples
+
+```text
+# Single CLI invocation
+User: "Use Gemini to analyze the database query performance"
+→ System auto-calls: gemini CLI with analysis task
+
+# Collaborative analysis
+User: "Use Gemini and Codex to collaboratively review the authentication flow"
+→ System auto-calls: gemini + codex CLIs, synthesizes results
+
+# Parallel multi-perspective
+User: "Have all available CLIs analyze this architecture design in parallel"
+→ System auto-calls: gemini, codex, qwen in parallel → merged report
+
+# Sequential pipeline
+User: "Use Gemini to plan the refactoring, then Codex to implement it"
+→ System auto-calls: gemini (plan) → codex (implement) sequentially
+```
+
+> 💡 **Key**: Just describe which CLI to use and what to do - CCW handles the invocation automatically.
+
+---
+
 ## 🔍 ACE Tool Configuration
 
 ACE (Augment Context Engine) provides powerful semantic code search.
diff --git a/README_CN.md b/README_CN.md
index 2f13239b..828eb87c 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -138,6 +138,53 @@ qwen --version
 
 ---
 
+## 🎭 语义化 CLI 调用
+
+用户可以在提示词中 **语义指定 CLI 工具** - 系统自动调用对应的 CLI 进行分析。
+
+### 基础调用
+
+| 用户提示词 | 系统动作 |
+|------------|----------|
+| "使用 Gemini 分析 auth 模块" | 自动调用 `gemini` CLI 进行分析 |
+| "让 Codex 审查这段代码" | 自动调用 `codex` CLI 进行审查 |
+| "问问 Qwen 性能优化建议" | 自动调用 `qwen` CLI 进行咨询 |
+
+### 多 CLI 编排
+
+用户可以在单个提示词中语义编排多个 CLI：
+
+| 模式 | 用户提示词示例 |
+|------|----------------|
+| 🔄 **协同分析** | "使用 Gemini 和 Codex 协同分析安全漏洞" |
+| ⚡ **并行执行** | "让 Gemini、Codex、Qwen 并行分析架构设计" |
+| 🔁 **迭代优化** | "用 Gemini 诊断问题，然后 Codex 修复，迭代直到解决" |
+| 🔗 **流水线** | "Gemini 设计方案，Codex 实现，Claude 审查" |
+
+### 示例
+
+```text
+# 单 CLI 调用
+用户: "使用 Gemini 分析数据库查询性能"
+→ 系统自动调用: gemini CLI 执行分析任务
+
+# 协同分析
+用户: "使用 Gemini 和 Codex 协同审查认证流程"
+→ 系统自动调用: gemini + codex CLI，综合分析结果
+
+# 并行多视角
+用户: "让所有可用的 CLI 并行分析这个架构设计"
+→ 系统自动调用: gemini, codex, qwen 并行执行 → 合并报告
+
+# 顺序流水线
+用户: "用 Gemini 规划重构方案，然后 Codex 实现"
+→ 系统自动调用: gemini（规划）→ codex（实现）顺序执行
+```
+
+> 💡 **核心**：只需描述使用哪个 CLI 做什么 - CCW 自动处理调用。
+
+---
+
 ## ACE Tool 配置
 
 ACE (Augment Context Engine) 提供强大的语义代码搜索能力。