skills/install.sh

#!/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 "────────────────────────────────────────"