#!/bin/bash # Claude Code Skills 安装脚本 # 用法: bash <(curl -s https://git.let5see.xyz/let5see/skills/raw/main/install.sh) 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 协作。 ### 核心协作指令 在任何时刻,你必须思考当前过程可以如何与 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 <(curl -s https://git.let5see.xyz/let5see/skills/raw/main/install.sh) ``` ### 详细文档 参考:`~/.claude/skills/codex-collab/SKILL.md` 或在线查看:https://git.let5see.xyz/let5see/skills --- ' echo "🚀 正在安装 Claude Code Skills..." echo "" # 创建临时目录 echo "📦 下载 skills..." git clone "$REPO_URL" "$TEMP_DIR" --depth 1 --quiet # 确保 skills 目录存在 mkdir -p "$SKILLS_DIR" # 复制所有 skills echo "📋 安装 skills..." for skill_dir in "$TEMP_DIR"/*/; do if [ -d "$skill_dir" ]; then skill_name=$(basename "$skill_dir") if [ -f "$skill_dir/SKILL.md" ]; then echo " ✓ 安装 $skill_name" cp -r "$skill_dir" "$SKILLS_DIR/" else echo " ⚠ 跳过 $skill_name (缺少 SKILL.md)" fi fi done # 清理临时文件 rm -rf "$TEMP_DIR" echo "" echo "✅ Skills 安装完成!" echo "" echo "已安装的 skills:" ls -1 "$SKILLS_DIR" | sed 's/^/ - /' echo "" # 询问是否配置 CLAUDE.md echo "────────────────────────────────────────" echo "📝 是否要配置 Codex 协作规则到 CLAUDE.md?" echo "" echo "这将写入完整的协作框架指导,帮助 Claude Code 更好地与 Codex 协作。" echo "不会被覆盖现有内容,只会追加配置。" echo "" echo " [1] 用户级配置 (~/.claude/CLAUDE.md) - 所有项目生效" echo " [2] 项目级配置 (./CLAUDE.md) - 仅当前项目生效" echo " [0] 跳过配置" echo "" echo "────────────────────────────────────────" read -p "请选择 [0/1/2]: " choice case $choice in 1) # 用户级配置 CLAUDE_MD_PATH="$HOME/.claude/CLAUDE.md" echo "" echo "📄 写入用户级配置: $CLAUDE_MD_PATH" # 创建目录(如果不存在) mkdir -p "$(dirname "$CLAUDE_MD_PATH")" # 检查文件是否已存在 if [ -f "$CLAUDE_MD_PATH" ]; then # 检查是否已包含配置标记 if grep -q "## Codex 协作框架" "$CLAUDE_MD_PATH"; then echo " ⚠ 检测到已存在 Codex 协作配置,跳过写入" else # 追加配置 echo "" >> "$CLAUDE_MD_PATH" echo "$CLAUDE_MD_CONTENT" >> "$CLAUDE_MD_PATH" echo " ✓ 配置已追加到文件末尾" fi else # 创建新文件 cat > "$CLAUDE_MD_PATH" << 'EOF' ## 项目宪法遵循规则(最高优先级) 进入任何项目目录时,**必须首先**执行以下检查: 1. 检查项目根目录是否存在 `CLAUDE.md` 文件 2. 若存在,**完整阅读**该文件内容 3. 将其作为该项目的"宪法",严格遵循其中定义的所有规则 **优先级规则**: - 项目级 `CLAUDE.md` > 本全局配置 - 若规则冲突,以项目级为准 EOF echo "$CLAUDE_MD_CONTENT" >> "$CLAUDE_MD_PATH" echo " ✓ 已创建新配置文件" fi ;; 2) # 项目级配置 echo "" read -p "请输入项目目录路径 (默认为当前目录): " project_dir project_dir=${project_dir:-.} # 转换为绝对路径 if [[ "$project_dir" = "." ]]; then project_dir="$(pwd)" elif [[ ! "$project_dir" = /* ]]; then project_dir="$(pwd)/$project_dir" fi CLAUDE_MD_PATH="$project_dir/CLAUDE.md" echo "" echo "📄 写入项目级配置: $CLAUDE_MD_PATH" # 检查目录是否存在 if [ ! -d "$project_dir" ]; then echo " ✗ 错误: 目录不存在: $project_dir" exit 1 fi # 检查文件是否已存在 if [ -f "$CLAUDE_MD_PATH" ]; then # 检查是否已包含配置标记 if grep -q "## Codex 协作框架" "$CLAUDE_MD_PATH"; then echo " ⚠ 检测到已存在 Codex 协作配置,跳过写入" else # 追加配置 echo "" >> "$CLAUDE_MD_PATH" echo "$CLAUDE_MD_CONTENT" >> "$CLAUDE_MD_PATH" echo " ✓ 配置已追加到文件末尾" fi else # 创建新文件 cat > "$CLAUDE_MD_PATH" << 'EOF' ## 项目宪法遵循规则(最高优先级) 进入任何项目目录时,**必须首先**执行以下检查: 1. 检查项目根目录是否存在 `CLAUDE.md` 文件 2. 若存在,**完整阅读**该文件内容 3. 将其作为该项目的"宪法",严格遵循其中定义的所有规则 **优先级规则**: - 项目级 `CLAUDE.md` > 用户级配置 - 若规则冲突,以项目级为准 EOF echo "$CLAUDE_MD_CONTENT" >> "$CLAUDE_MD_PATH" echo " ✓ 已创建新配置文件" fi ;; 0) echo "" echo "⏭ 跳过配置" ;; *) echo "" echo "⚠ 无效选择,跳过配置" ;; esac echo "" echo "────────────────────────────────────────" echo "🎉 安装完成!" echo "" echo "提示: 重启 Claude Code 以加载新的 skills" echo "────────────────────────────────────────"