Agent/skills4claude/install.sh

#!/usr/bin/env bash
#
# 把 Agent 仓库的 skills/ 同步到 Claude Code 或 Codex 的 skills 目录。
#
# 默认用 **symlink**：源头在 repo，edit-in-repo 立即生效，适合本机开发。
# 跨机器部署/发布用 --copy：把文件 rsync 过去，脱离 repo。
#
# 默认行为：
#   - 目标不存在 → 创建
#   - 目标已是指向本 repo 的 symlink → 跳过（no-op）
#   - 目标已存在（其他 symlink / 目录 / 文件）→ **拒绝安装并报错**，让你自己决定如何处理
#     - 用 --force 才会强制覆盖（先 rm 再装）
#
# 不自动备份的原因：skill 已进版本控制，旧内容通常有 git 历史；
# 盲目 backup 会污染客户端的 skills 目录（Claude Code / Codex 都可能把 .bak.* 当 skill 索引）。
#
# 用法：
#   bash install.sh                  # 安装到 Claude Code（默认 ~/.claude/skills）
#   bash install.sh --codex          # 安装到 Codex（默认 ${CODEX_HOME:-~/.codex}/skills）
#   bash install.sh --claude         # 明确安装到 Claude Code
#   bash install.sh --copy           # copy 模式（默认 symlink）
#   bash install.sh --force          # 冲突时强制覆盖
#   bash install.sh --target DIR     # 改安装目录
#   bash install.sh --dry-run        # 只打印会做什么，不动文件
#   bash install.sh --skills a,b     # 只装指定的（默认全装）
#
set -euo pipefail

REPO_SKILLS_DIR="$(cd "$(dirname "$0")" && pwd)"
PLATFORM="claude"
TARGET_DIR=""
MODE="symlink"
DRY_RUN=0
FORCE=0
ONLY_SKILLS=""

while [[ $# -gt 0 ]]; do
  case "$1" in
    --claude)   PLATFORM="claude"; shift ;;
    --codex)    PLATFORM="codex"; shift ;;
    --platform)
      PLATFORM="$2"; shift 2 ;;
    --copy)     MODE="copy"; shift ;;
    --symlink)  MODE="symlink"; shift ;;
    --target)   TARGET_DIR="$2"; shift 2 ;;
    --dry-run)  DRY_RUN=1; shift ;;
    --force)    FORCE=1; shift ;;
    --skills)   ONLY_SKILLS="$2"; shift 2 ;;
    -h|--help)
      grep '^#' "$0" | sed 's/^# \{0,1\}//' | head -30
      exit 0 ;;
    *) echo "unknown arg: $1" >&2; exit 1 ;;
  esac
done

case "$PLATFORM" in
  claude)
    DEFAULT_TARGET_DIR="${HOME}/.claude/skills"
    ;;
  codex)
    DEFAULT_TARGET_DIR="${CODEX_HOME:-${HOME}/.codex}/skills"
    ;;
  *)
    echo "unknown platform: $PLATFORM (expected: claude or codex)" >&2
    exit 1
    ;;
esac

if [[ -z "$TARGET_DIR" ]]; then
  TARGET_DIR="$DEFAULT_TARGET_DIR"
fi

run() {
  if [[ $DRY_RUN -eq 1 ]]; then
    echo "[dry-run] $*"
  else
    eval "$@"
  fi
}

# 收集要安装的 skill 列表
if [[ -n "$ONLY_SKILLS" ]]; then
  IFS=',' read -r -a skills <<< "$ONLY_SKILLS"
else
  skills=()
  for d in "$REPO_SKILLS_DIR"/*/; do
    [[ -d "$d" ]] || continue
    name="$(basename "$d")"
    [[ "$name" == "__pycache__" ]] && continue
    skills+=("$name")
  done
fi

echo "platform : $PLATFORM"
echo "mode     : $MODE"
echo "source   : $REPO_SKILLS_DIR"
echo "target   : $TARGET_DIR"
echo "force    : $FORCE"
echo "skills   : ${skills[*]}"
echo "---"

run "mkdir -p '$TARGET_DIR'"

conflict_count=0
for name in "${skills[@]}"; do
  src="$REPO_SKILLS_DIR/$name"
  dst="$TARGET_DIR/$name"

  if [[ ! -d "$src" ]]; then
    echo "⚠ skip (not found in repo): $name"
    continue
  fi

  # 已经是指向本 repo 的 symlink → 跳过
  if [[ -L "$dst" ]]; then
    current="$(readlink "$dst")"
    if [[ "$current" == "$src" ]]; then
      echo "= $name (already linked, skip)"
      continue
    fi
  fi

  # 目标存在但不是我们想要的状态 → 要么 --force 覆盖，要么报错
  if [[ -e "$dst" || -L "$dst" ]]; then
    if [[ $FORCE -eq 0 ]]; then
      echo "✗ $name: target exists → $dst"
      echo "    (现状: $( [[ -L "$dst" ]] && echo "symlink → $(readlink "$dst")" || echo "directory/file" ))"
      echo "    用 --force 覆盖；或手动处理后重跑。"
      conflict_count=$((conflict_count + 1))
      continue
    fi
    echo "↺ $name (forced: removing existing)"
    run "rm -rf '$dst'"
  fi

  case "$MODE" in
    symlink)
      run "ln -s '$src' '$dst'"
      echo "✓ $name (symlinked)"
      ;;
    copy)
      run "cp -R '$src' '$dst'"
      run "rm -rf '$dst/__pycache__'"
      echo "✓ $name (copied)"
      ;;
  esac
done

echo ""
if [[ $conflict_count -gt 0 ]]; then
  echo "⚠ $conflict_count 个 skill 因冲突未安装。用 --force 覆盖或先手动处理。"
  exit 2
fi

echo "安装完成。"
if [[ "$MODE" == "symlink" ]]; then
  echo "symlink 模式：在 $REPO_SKILLS_DIR 下改文件，$TARGET_DIR 自动跟随。"
else
  echo "copy 模式：repo 改动后需要重跑本脚本才会同步。"
fi

if [[ "$PLATFORM" == "codex" ]]; then
  echo "Codex 需要重启后才会重新索引新安装的 skills。"
fi