Update CLAUDE.md content with complete collaboration framework

Enhanced content includes: - Core collaboration instructions (4-step workflow) - Complete Codex tool specification - Mandatory rules and recommended practices - Preserved original MCP prompt structure Changes: - Add "需求分析阶段", "方案设计阶段", "代码审查阶段" steps - Include "批判性思维" principle - Complete tool parameter reference - Must-follow rules for safe collaboration Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-11 18:17:35 +08:00
parent e1f56ae793
commit c8989efc0c
2 changed files with 111 additions and 50 deletions
--- a/install.ps1
+++ b/install.ps1
@@ -7,41 +7,71 @@ $RepoUrl = "https://git.let5see.xyz/let5see/skills.git"
 $TempDir = Join-Path $env:TEMP "skills-install-$(Get-Random)"
 $SkillsDir = Join-Path $env:USERPROFILE ".claude\skills"

-$ClaudeMdContent = @"
-## Codex 协作配置
+$ClaudeMdContent = @'
+## Codex 协作框架

 本项目使用 `codex-collab` skill 进行 Codex CLI 协作。

+### 核心协作指令
+
+在任何时刻，你必须思考当前过程可以如何与 codex 进行协作，如何调用 Codex MCP 工具作为你客观全面分析的保障。
+
+**务必执行**以下几个步骤：
+
+1. **需求分析阶段**：在形成初步分析后，将用户需求、初始思路告知 codex，并要求其完善需求分析和实施计划。
+
+2. **方案设计阶段**：在实施具体编码任务前，**必须向 codex 索要代码实现原型**（要求 codex 仅给出 unified diff patch，严禁对代码做任何真实修改）。在获取代码原型后，你**只能以此为逻辑参考，重新编写代码**，形成企业生产级别、高可读性、高可维护性的代码后，才能实施具体编程修改任务。
+
+3. **代码审查阶段**：无论何时，只要完成编码行为后，**必须立即使用 codex review 代码改动和需求完成程度**。
+
+4. **批判性思维**：codex 只能提供参考，你**必须有独立思考，甚至需要对 codex 的回答提出质疑**。"尽信书则不如无书"，你与 codex 的最终使命都是达成统一、全面、精准的结论，所以你们必须不断辩论以找到通向真理的唯一途径。
+
+### Codex Tool 调用规范
+
+#### 必选参数
+- `PROMPT` (string): 发送给 codex 的任务指令
+- `cd` (Path): codex 执行任务的工作目录根路径
+
+#### 可选参数
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `sandbox` | string | "read-only" | 沙箱策略：read-only / workspace-write / danger-full-access |
+| `SESSION_ID` | UUID | None | 会话ID（None=新会话） |
+| `skip_git_repo_check` | bool | False | 是否允许在非Git仓库运行 |
+| `return_all_messages` | bool | False | 是否返回完整推理信息 |
+
+#### 返回值
+```json
+{
+  "success": true,
+  "SESSION_ID": "uuid-string",
+  "agent_messages": "Codex响应内容"
+}
+```
+
+#### 必须遵守
+- 每次调用必须保存返回的 `SESSION_ID`，以便后续继续对话
+- `cd` 参数必须指向存在的目录
+- 严禁 codex 对代码进行实际修改，使用 `sandbox="read-only"`
+- 要求 codex 仅给出 unified diff patch
+
+#### 推荐用法
+- 对于精准定位、debug、代码原型编写等任务，优先使用 codex
+- 详细追踪推理过程时，设置 `return_all_messages=True`
+
 ### 快速安装

 ```powershell
 irm https://git.let5see.xyz/let5see/skills/raw/main/install.ps1 | iex
 ```

-### 核心原则
-
-**指导原则**：
- Codex 是协作伙伴，而非唯一真理来源
- 必须有独立思考，对 Codex 的建议保持批判性审视
- 通过辩论和讨论达成最优方案
-
-**职责分工**：
- **Claude Code**：代码编写、文档编写、简单任务直接执行
- **Codex**：代码查找定位、逻辑梳理、代码审查、方案设计、问题诊断
-
-**关键规范**：
- 查找/搜索任务 → 必须调用 Codex
- 方案设计阶段 → 使用 `sandbox="read-only"`
- 代码实现 → Claude Code 基于方案重写生产级代码
- 完成编码后 → 立即让 Codex 审查
-
 ### 详细文档

 参考：`$env:USERPROFILE\.claude\skills\codex-collab\SKILL.md`
 或在线查看：https://git.let5see.xyz/let5see/skills

 ---
-"@
+'@

 Write-Host "🚀 正在安装 Claude Code Skills..." -ForegroundColor Green
 Write-Host ""
@@ -114,7 +144,7 @@ Write-Host ""
 Write-Host "────────────────────────────────────────" -ForegroundColor Cyan
 Write-Host "📝 是否要配置 Codex 协作规则到 CLAUDE.md？" -ForegroundColor Yellow
 Write-Host ""
-Write-Host "这将帮助 Claude Code 更好地与 Codex 协作。" -ForegroundColor Gray
+Write-Host "这将写入完整的协作框架指导，帮助 Claude Code 更好地与 Codex 协作。" -ForegroundColor Gray
 Write-Host "不会被覆盖现有内容，只会追加配置。" -ForegroundColor Gray
 Write-Host ""
 Write-Host "  [1] 用户级配置 (~/.claude/CLAUDE.md) - 所有项目生效" -ForegroundColor White
@@ -142,7 +172,7 @@ switch ($choice) {
        if (Test-Path $ClaudeMdPath) {
            # 检查是否已包含配置标记
            $content = Get-Content $ClaudeMdPath -Raw
-            if ($content -match "## Codex 协作配置") {
+            if ($content -match "## Codex 协作框架") {
                Write-Host "  ⚠ 检测到已存在 Codex 协作配置，跳过写入" -ForegroundColor Yellow
            } else {
                # 追加配置
@@ -197,7 +227,7 @@ switch ($choice) {
        if (Test-Path $ClaudeMdPath) {
            # 检查是否已包含配置标记
            $content = Get-Content $ClaudeMdPath -Raw
-            if ($content -match "## Codex 协作配置") {
+            if ($content -match "## Codex 协作框架") {
                Write-Host "  ⚠ 检测到已存在 Codex 协作配置，跳过写入" -ForegroundColor Yellow
            } else {
                # 追加配置
--- a/install.sh
+++ b/install.sh
@@ -8,41 +8,72 @@ set -e
 REPO_URL="https://git.let5see.xyz/let5see/skills.git"
 TEMP_DIR="/tmp/skills-install-$$"
 SKILLS_DIR="$HOME/.claude/skills"
-CLAUDE_MD_CONTENT="
-## Codex 协作配置

-本项目使用 \`codex-collab\` skill 进行 Codex CLI 协作。
+CLAUDE_MD_CONTENT='
+## Codex 协作框架
+
+本项目使用 `codex-collab` skill 进行 Codex CLI 协作。
+
+### 核心协作指令
+
+在任何时刻，你必须思考当前过程可以如何与 codex 进行协作，如何调用 Codex MCP 工具作为你客观全面分析的保障。
+
+**务必执行**以下几个步骤：
+
+1. **需求分析阶段**：在形成初步分析后，将用户需求、初始思路告知 codex，并要求其完善需求分析和实施计划。
+
+2. **方案设计阶段**：在实施具体编码任务前，**必须向 codex 索要代码实现原型**（要求 codex 仅给出 unified diff patch，严禁对代码做任何真实修改）。在获取代码原型后，你**只能以此为逻辑参考，重新编写代码**，形成企业生产级别、高可读性、高可维护性的代码后，才能实施具体编程修改任务。
+
+3. **代码审查阶段**：无论何时，只要完成编码行为后，**必须立即使用 codex review 代码改动和需求完成程度**。
+
+4. **批判性思维**：codex 只能提供参考，你**必须有独立思考，甚至需要对 codex 的回答提出质疑**。"尽信书则不如无书"，你与 codex 的最终使命都是达成统一、全面、精准的结论，所以你们必须不断辩论以找到通向真理的唯一途径。
+
+### Codex Tool 调用规范
+
+#### 必选参数
+- `PROMPT` (string): 发送给 codex 的任务指令
+- `cd` (Path): codex 执行任务的工作目录根路径
+
+#### 可选参数
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `sandbox` | string | "read-only" | 沙箱策略：read-only / workspace-write / danger-full-access |
+| `SESSION_ID` | UUID \| None | None | 会话ID（None=新会话） |
+| `skip_git_repo_check` | bool | False | 是否允许在非Git仓库运行 |
+| `return_all_messages` | bool | False | 是否返回完整推理信息 |
+
+#### 返回值
+```json
+{
+  "success": true,
+  "SESSION_ID": "uuid-string",
+  "agent_messages": "Codex响应内容"
+}
+```
+
+#### 必须遵守
+- 每次调用必须保存返回的 `SESSION_ID`，以便后续继续对话
+- `cd` 参数必须指向存在的目录
+- 严禁 codex 对代码进行实际修改，使用 `sandbox="read-only"`
+- 要求 codex 仅给出 unified diff patch
+
+#### 推荐用法
+- 对于精准定位、debug、代码原型编写等任务，优先使用 codex
+- 详细追踪推理过程时，设置 `return_all_messages=True`

 ### 快速安装

-\`\`\`bash
+```bash
 bash <(curl -s https://git.let5see.xyz/let5see/skills/raw/main/install.sh)
-\`\`\`
-
-### 核心原则
-
-**指导原则**：
- Codex 是协作伙伴，而非唯一真理来源
- 必须有独立思考，对 Codex 的建议保持批判性审视
- 通过辩论和讨论达成最优方案
-
-**职责分工**：
- **Claude Code**：代码编写、文档编写、简单任务直接执行
- **Codex**：代码查找定位、逻辑梳理、代码审查、方案设计、问题诊断
-
-**关键规范**：
- 查找/搜索任务 → 必须调用 Codex
- 方案设计阶段 → 使用 \`sandbox=\"read-only\"\`
- 代码实现 → Claude Code 基于方案重写生产级代码
- 完成编码后 → 立即让 Codex 审查
+```

 ### 详细文档

-参考：\`~/.claude/skills/codex-collab/SKILL.md\`
+参考：`~/.claude/skills/codex-collab/SKILL.md`
 或在线查看：https://git.let5see.xyz/let5see/skills

 ---
-"
+'

 echo "🚀 正在安装 Claude Code Skills..."
 echo ""
@@ -82,7 +113,7 @@ echo ""
 echo "────────────────────────────────────────"
 echo "📝 是否要配置 Codex 协作规则到 CLAUDE.md？"
 echo ""
-echo "这将帮助 Claude Code 更好地与 Codex 协作。"
+echo "这将写入完整的协作框架指导，帮助 Claude Code 更好地与 Codex 协作。"
 echo "不会被覆盖现有内容，只会追加配置。"
 echo ""
 echo "  [1] 用户级配置 (~/.claude/CLAUDE.md) - 所有项目生效"
@@ -105,7 +136,7 @@ case $choice in
        # 检查文件是否已存在
        if [ -f "$CLAUDE_MD_PATH" ]; then
            # 检查是否已包含配置标记
-            if grep -q "## Codex 协作配置" "$CLAUDE_MD_PATH"; then
+            if grep -q "## Codex 协作框架" "$CLAUDE_MD_PATH"; then
                echo "  ⚠ 检测到已存在 Codex 协作配置，跳过写入"
            else
                # 追加配置
@@ -160,7 +191,7 @@ EOF
        # 检查文件是否已存在
        if [ -f "$CLAUDE_MD_PATH" ]; then
            # 检查是否已包含配置标记
-            if grep -q "## Codex 协作配置" "$CLAUDE_MD_PATH"; then
+            if grep -q "## Codex 协作框架" "$CLAUDE_MD_PATH"; then
                echo "  ⚠ 检测到已存在 Codex 协作配置，跳过写入"
            else
                # 追加配置