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>
This commit is contained in:
empty
2026-01-11 18:17:35 +08:00
parent e1f56ae793
commit c8989efc0c
2 changed files with 111 additions and 50 deletions

View File

@@ -7,41 +7,71 @@ $RepoUrl = "https://git.let5see.xyz/let5see/skills.git"
$TempDir = Join-Path $env:TEMP "skills-install-$(Get-Random)" $TempDir = Join-Path $env:TEMP "skills-install-$(Get-Random)"
$SkillsDir = Join-Path $env:USERPROFILE ".claude\skills" $SkillsDir = Join-Path $env:USERPROFILE ".claude\skills"
$ClaudeMdContent = @" $ClaudeMdContent = @'
## Codex ## Codex 协作框架
本项目使用 `codex-collab` skill 进行 Codex CLI 协作。 本项目使用 `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 | 会话IDNone=新会话) |
| `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 ```powershell
irm https://git.let5see.xyz/let5see/skills/raw/main/install.ps1 | iex 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` 参考:`$env:USERPROFILE\.claude\skills\codex-collab\SKILL.md`
或在线查看https://git.let5see.xyz/let5see/skills 或在线查看https://git.let5see.xyz/let5see/skills
--- ---
"@ '@
Write-Host "🚀 正在安装 Claude Code Skills..." -ForegroundColor Green Write-Host "🚀 正在安装 Claude Code Skills..." -ForegroundColor Green
Write-Host "" Write-Host ""
@@ -114,7 +144,7 @@ Write-Host ""
Write-Host "────────────────────────────────────────" -ForegroundColor Cyan Write-Host "────────────────────────────────────────" -ForegroundColor Cyan
Write-Host "📝 是否要配置 Codex 协作规则到 CLAUDE.md" -ForegroundColor Yellow Write-Host "📝 是否要配置 Codex 协作规则到 CLAUDE.md" -ForegroundColor Yellow
Write-Host "" Write-Host ""
Write-Host "这将帮助 Claude Code 更好地与 Codex 协作。" -ForegroundColor Gray Write-Host "这将写入完整的协作框架指导,帮助 Claude Code 更好地与 Codex 协作。" -ForegroundColor Gray
Write-Host "不会被覆盖现有内容,只会追加配置。" -ForegroundColor Gray Write-Host "不会被覆盖现有内容,只会追加配置。" -ForegroundColor Gray
Write-Host "" Write-Host ""
Write-Host " [1] 用户级配置 (~/.claude/CLAUDE.md) - 所有项目生效" -ForegroundColor White Write-Host " [1] 用户级配置 (~/.claude/CLAUDE.md) - 所有项目生效" -ForegroundColor White
@@ -142,7 +172,7 @@ switch ($choice) {
if (Test-Path $ClaudeMdPath) { if (Test-Path $ClaudeMdPath) {
# 检查是否已包含配置标记 # 检查是否已包含配置标记
$content = Get-Content $ClaudeMdPath -Raw $content = Get-Content $ClaudeMdPath -Raw
if ($content -match "## Codex 协作配置") { if ($content -match "## Codex 协作框架") {
Write-Host " ⚠ 检测到已存在 Codex 协作配置,跳过写入" -ForegroundColor Yellow Write-Host " ⚠ 检测到已存在 Codex 协作配置,跳过写入" -ForegroundColor Yellow
} else { } else {
# 追加配置 # 追加配置
@@ -197,7 +227,7 @@ switch ($choice) {
if (Test-Path $ClaudeMdPath) { if (Test-Path $ClaudeMdPath) {
# 检查是否已包含配置标记 # 检查是否已包含配置标记
$content = Get-Content $ClaudeMdPath -Raw $content = Get-Content $ClaudeMdPath -Raw
if ($content -match "## Codex 协作配置") { if ($content -match "## Codex 协作框架") {
Write-Host " ⚠ 检测到已存在 Codex 协作配置,跳过写入" -ForegroundColor Yellow Write-Host " ⚠ 检测到已存在 Codex 协作配置,跳过写入" -ForegroundColor Yellow
} else { } else {
# 追加配置 # 追加配置

View File

@@ -8,41 +8,72 @@ set -e
REPO_URL="https://git.let5see.xyz/let5see/skills.git" REPO_URL="https://git.let5see.xyz/let5see/skills.git"
TEMP_DIR="/tmp/skills-install-$$" TEMP_DIR="/tmp/skills-install-$$"
SKILLS_DIR="$HOME/.claude/skills" 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 | 会话IDNone=新会话) |
| `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) 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 或在线查看https://git.let5see.xyz/let5see/skills
--- ---
" '
echo "🚀 正在安装 Claude Code Skills..." echo "🚀 正在安装 Claude Code Skills..."
echo "" echo ""
@@ -82,7 +113,7 @@ echo ""
echo "────────────────────────────────────────" echo "────────────────────────────────────────"
echo "📝 是否要配置 Codex 协作规则到 CLAUDE.md" echo "📝 是否要配置 Codex 协作规则到 CLAUDE.md"
echo "" echo ""
echo "这将帮助 Claude Code 更好地与 Codex 协作。" echo "这将写入完整的协作框架指导,帮助 Claude Code 更好地与 Codex 协作。"
echo "不会被覆盖现有内容,只会追加配置。" echo "不会被覆盖现有内容,只会追加配置。"
echo "" echo ""
echo " [1] 用户级配置 (~/.claude/CLAUDE.md) - 所有项目生效" echo " [1] 用户级配置 (~/.claude/CLAUDE.md) - 所有项目生效"
@@ -105,7 +136,7 @@ case $choice in
# 检查文件是否已存在 # 检查文件是否已存在
if [ -f "$CLAUDE_MD_PATH" ]; then if [ -f "$CLAUDE_MD_PATH" ]; then
# 检查是否已包含配置标记 # 检查是否已包含配置标记
if grep -q "## Codex 协作配置" "$CLAUDE_MD_PATH"; then if grep -q "## Codex 协作框架" "$CLAUDE_MD_PATH"; then
echo " ⚠ 检测到已存在 Codex 协作配置,跳过写入" echo " ⚠ 检测到已存在 Codex 协作配置,跳过写入"
else else
# 追加配置 # 追加配置
@@ -160,7 +191,7 @@ EOF
# 检查文件是否已存在 # 检查文件是否已存在
if [ -f "$CLAUDE_MD_PATH" ]; then if [ -f "$CLAUDE_MD_PATH" ]; then
# 检查是否已包含配置标记 # 检查是否已包含配置标记
if grep -q "## Codex 协作配置" "$CLAUDE_MD_PATH"; then if grep -q "## Codex 协作框架" "$CLAUDE_MD_PATH"; then
echo " ⚠ 检测到已存在 Codex 协作配置,跳过写入" echo " ⚠ 检测到已存在 Codex 协作配置,跳过写入"
else else
# 追加配置 # 追加配置