From c8989efc0ce36983ffeaed4c213c3309c6cb0306 Mon Sep 17 00:00:00 2001 From: empty Date: Sun, 11 Jan 2026 18:17:35 +0800 Subject: [PATCH] Update CLAUDE.md content with complete collaboration framework MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- install.ps1 | 76 ++++++++++++++++++++++++++++++++--------------- install.sh | 85 ++++++++++++++++++++++++++++++++++++----------------- 2 files changed, 111 insertions(+), 50 deletions(-) diff --git a/install.ps1 b/install.ps1 index 760d7a6..f813f2c 100644 --- 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 { # 追加配置 diff --git a/install.sh b/install.sh index 0413d00..36ebcf0 100755 --- 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 # 追加配置