lang-upgrade

升级 langskill（狼格拉底 ASOP）到最新版本，显示更新内容。

使用场景

• 用户主动调用 /lang-upgrade 升级
• 显示版本变化和更新内容

升级流程

Step 1: 检测安装位置

if [ -d "$HOME/.claude/skills/lang" ]; then
  INSTALL_DIR="$HOME/.claude/skills"
  echo "Install location: $INSTALL_DIR"
else
  echo "ERROR: langskill not found in ~/.claude/skills/"
  echo "请先安装：npx skills add YiXinHui/langskill --skill '*' --agent claude -y"
  exit 1
fi

Step 2: 获取当前版本

OLD_VERSION=$(cat "$HOME/.claude/skills/lang-upgrade/../../VERSION" 2>/dev/null || echo "unknown")
echo "Current version: $OLD_VERSION"

Step 3: 获取远程版本

REMOTE_VERSION=$(curl -sL https://raw.githubusercontent.com/YiXinHui/langskill/main/VERSION || echo "")
if [ -z "$REMOTE_VERSION" ]; then
  echo "ERROR: Cannot fetch remote version"
  exit 1
fi
echo "Remote version: $REMOTE_VERSION"

Step 4: 比较版本

如果 OLD_VERSION 等于 REMOTE_VERSION，告诉用户已是最新版本，结束。

否则继续升级。

Step 5: 备份当前版本

使用清单文件 .langskill-manifest 追踪 langskill 管理的 skill 目录。备份清单中的所有目录。

BACKUP_DIR="$HOME/.claude/skills/.langskill-backup-$(date +%Y%m%d-%H%M%S)"
MANIFEST="$HOME/.claude/skills/.langskill-manifest"
mkdir -p "$BACKUP_DIR"

if [ -f "$MANIFEST" ]; then
  while IFS= read -r skill_dir; do
    [ -d "$HOME/.claude/skills/$skill_dir" ] && cp -r "$HOME/.claude/skills/$skill_dir" "$BACKUP_DIR/"
  done < "$MANIFEST"
else
  # 首次升级，兜底备份 lang* 目录
  cp -r "$HOME/.claude/skills"/lang* "$BACKUP_DIR/" 2>/dev/null || true
fi
echo "Backup created: $BACKUP_DIR"

Step 6: 下载最新版本

TMP_DIR=$(mktemp -d)
git clone --depth 1 https://github.com/YiXinHui/langskill.git "$TMP_DIR/langskill"
if [ $? -ne 0 ]; then
  echo "ERROR: Failed to clone repository"
  exit 1
fi
echo "Downloaded to: $TMP_DIR/langskill"

Step 7: 替换旧版本

从仓库的 skills/ 目录动态获取所有 skill 名，逐个替换，并更新清单文件。

MANIFEST="$HOME/.claude/skills/.langskill-manifest"

# 读取旧清单，删除旧版 skill 目录
if [ -f "$MANIFEST" ]; then
  while IFS= read -r skill_dir; do
    rm -rf "$HOME/.claude/skills/$skill_dir"
  done < "$MANIFEST"
else
  # 首次升级兜底
  rm -rf "$HOME/.claude/skills"/lang*
fi

# 复制仓库中所有 skill 目录，并生成新清单
> "$MANIFEST"
for skill_path in "$TMP_DIR/langskill/skills"/*/; do
  skill_name=$(basename "$skill_path")
  cp -r "$skill_path" "$HOME/.claude/skills/$skill_name"
  echo "$skill_name" >> "$MANIFEST"
done

rm -rf "$TMP_DIR"
echo "Upgrade completed"

如果复制失败，从备份恢复：

if [ $? -ne 0 ]; then
  echo "ERROR: Upgrade failed, restoring from backup..."
  if [ -f "$MANIFEST" ]; then
    while IFS= read -r skill_dir; do
      rm -rf "$HOME/.claude/skills/$skill_dir"
    done < "$MANIFEST"
  fi
  cp -r "$BACKUP_DIR"/* "$HOME/.claude/skills/"
  echo "Restored from backup"
  exit 1
fi

Step 8: 显示更新内容

读取 $HOME/.claude/skills/lang/../../README.md（如果存在），提取从 OLD_VERSION 到 REMOTE_VERSION 之间的更新内容。

格式：

langskill v{REMOTE_VERSION} — 从 v{OLD_VERSION} 升级成功！

更新内容：
- [从 README 提取的更新要点]

升级完成！

Step 9: 清理备份

询问用户是否删除备份：

echo "Backup location: $BACKUP_DIR"
echo "Keep backup? (will be auto-deleted in 7 days if not used)"

不强制删除，让用户自己决定。

错误处理

• 网络失败：提示用户检查网络连接
• Git clone 失败：从备份恢复
• 文件复制失败：从备份恢复

注意事项

• 只支持通过 ~/.claude/skills/ 安装的版本
• 升级前自动备份，失败时自动恢复
• 不需要用户手动操作 git