@vima_tech/telos 1.4.0

package/scripts/bridge-to-coder.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# scripts/bridge-to-coder.sh
+# 将 Skill 分析产物桥接到编程执行工具，工具退出后自动收集反馈
+#
+# 用法：./scripts/bridge-to-coder.sh <project_id> [tool] [impl_dir]
+#   project_id : Telos 项目 ID（如 proj_20260515_01）
+#   tool       : claude（默认）| opencode | trae | codex
+#   impl_dir   : 实现目录（默认 ../{project_id}-impl）
+#
+# 前置条件：projects/{project_id}/artifacts/ai-execution-doc.md 已生成
+
+set -e
+
+PROJECT_ID="${1:?用法: $0 <project_id> [tool] [impl_dir]}"
+TOOL="${2:-claude}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+ARTIFACTS_DIR="$REPO_DIR/projects/$PROJECT_ID/artifacts"
+AI_DOC="$ARTIFACTS_DIR/ai-execution-doc.md"
+STATE_FILE="$REPO_DIR/projects/$PROJECT_ID/state.json"
+IMPL_DIR="${3:-$(dirname "$REPO_DIR")/${PROJECT_ID}-impl}"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+LOG_FILE="$REPO_DIR/episodic-logs/${PROJECT_ID}.jsonl"
+DISTILL_NEEDED_DIR="$REPO_DIR/.distill-needed"
+
+# ── 检查前置条件 ───────────────────────────────────────────────
+if [ ! -f "$AI_DOC" ]; then
+  echo "❌ 错误：AI 执行文档不存在：$AI_DOC"
+  echo "   请先完成 Skill 分析并生成产物。"
+  exit 1
+fi
+
+# ── 创建实现工作区 ─────────────────────────────────────────────
+echo "📁 创建实现目录：$IMPL_DIR"
+mkdir -p "$IMPL_DIR"
+
+# ── 注入 AI 执行文档为编程工具上下文 ──────────────────────────
+PROJECT_NAME=$(python3 -c "import json,sys; d=json.load(open('$STATE_FILE')); print(d.get('project_name','未命名项目'))" 2>/dev/null || echo "未命名项目")
+
+cat > "$IMPL_DIR/CLAUDE.md" << HEREDOC
+# $PROJECT_NAME — AI 执行规格
+
+> 本文档由 Telos Skill 分析自动生成，是唯一权威需求来源。
+> **遇到本文档未说明的情况，必须停止并记录，不得自行决定。**
+
+---
+
+$(cat "$AI_DOC")
+
+---
+
+## 反馈协议（实现完成后必须执行）
+
+实现过程中如遇到以下情况，请记录到 \`.telos-feedback.json\`：
+- 需求描述不清晰或有歧义
+- 遇到文档未覆盖的技术决策
+- 发现需求假设与现实不符
+- 验收标准无法被测试
+
+记录格式：
+\`\`\`json
+{
+  "unclear_specs": ["具体描述哪条规格不清晰"],
+  "uncovered_decisions": ["遇到的未覆盖决策"],
+  "wrong_assumptions": ["发现的错误假设"],
+  "untestable_criteria": ["无法测试的验收标准"],
+  "general_feedback": "总体反馈和质量评分（1-10）"
+}
+\`\`\`
+
+**重要：** 实现完成后请写入上述文件。退出编程工具后，飞轮系统会自动读取该文件收集反馈，无需手动运行任何命令。
+HEREDOC
+
+echo "✅ CLAUDE.md 已生成"
+
+# ── 写入桥接事件日志 ──────────────────────────────────────────
+mkdir -p "$(dirname "$LOG_FILE")"
+EVENT_ID="evt_bridge_$(date +%s)"
+echo "{\"event_id\":\"$EVENT_ID\",\"type\":\"bridge_to_coder\",\"project_id\":\"$PROJECT_ID\",\"tool\":\"$TOOL\",\"impl_dir\":\"$IMPL_DIR\",\"timestamp\":\"$TIMESTAMP\"}" >> "$LOG_FILE"
+
+# ── 启动编程工具 ───────────────────────────────────────────────
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  项目：$PROJECT_NAME ($PROJECT_ID)"
+echo "  工具：$TOOL"
+echo "  目录：$IMPL_DIR"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+cd "$IMPL_DIR"
+
+case "$TOOL" in
+  claude)
+    echo "🚀 启动 Claude Code..."
+    claude
+    ;;
+  opencode)
+    echo "🚀 启动 opencode..."
+    opencode
+    ;;
+  trae)
+    echo "🚀 启动 trae..."
+    trae .
+    ;;
+  codex)
+    echo "🚀 启动 codex..."
+    codex
+    ;;
+  cursor)
+    echo "🚀 启动 Cursor..."
+    cursor .
+    ;;
+  *)
+    echo "⚠️  未知工具：$TOOL，已准备好实现目录。"
+    echo "   手动进入：cd $IMPL_DIR"
+    ;;
+esac
+
+# ── 工具退出后：自动收集反馈 ──────────────────────────────────
+echo ""
+echo "━━━ 编程工具已退出，自动收集反馈... ━━━"
+cd "$REPO_DIR"
+"$SCRIPT_DIR/feedback-hook.sh" "$PROJECT_ID" "$IMPL_DIR" --auto
+
+# ── 检查是否需要蒸馏，自动打开蒸馏会话 ───────────────────────
+DISTILL_MARKER="$DISTILL_NEEDED_DIR/$PROJECT_ID"
+if [ -f "$DISTILL_MARKER" ]; then
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "  ⚡ 蒸馏条件已满足，自动启动蒸馏会话"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "即将打开 Telos 蒸馏会话..."
+  echo "AI 将展示所有变更预览，你只需确认一次 (y/n)"
+  echo ""
+  sleep 1
+  cd "$REPO_DIR"
+  exec claude
+fi

package/scripts/feedback-hook.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+# scripts/feedback-hook.sh
+# 从编程工具实现会话收集反馈，写入 episodic-logs 以驱动蒸馏飞轮
+#
+# 用法：./scripts/feedback-hook.sh <project_id> [impl_dir] [--auto]
+#   project_id : 飞轮项目 ID
+#   impl_dir   : 实现目录（用于读取 .telos-feedback.json）
+#   --auto     : 非交互模式，仅读取反馈文件，跳过问答
+#
+# 反馈问题可由 Skill 定制：
+#   在 skills/{skill-name}/feedback-questions.sh 中定义
+#   QUESTION_1 ~ QUESTION_5 变量
+
+set -e
+
+PROJECT_ID="${1:?用法: $0 <project_id> [impl_dir] [--auto]}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+IMPL_DIR="${2:-$(dirname "$REPO_DIR")/${PROJECT_ID}-impl}"
+LOG_FILE="$REPO_DIR/episodic-logs/${PROJECT_ID}.jsonl"
+FEEDBACK_FILE="$IMPL_DIR/.telos-feedback.json"
+DISTILL_NEEDED_DIR="$REPO_DIR/.distill-needed"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+EVENT_ID="evt_feedback_$(date +%s)"
+AUTO_MODE=false
+THRESHOLD=${DISTILL_THRESHOLD:-3}
+
+# 解析参数（支持 --auto 在任意位置）
+for arg in "$@"; do
+  [ "$arg" = "--auto" ] && AUTO_MODE=true
+done
+
+$AUTO_MODE || echo "━━━ 需求反馈收集器 ━━━"
+$AUTO_MODE || echo "项目：$PROJECT_ID"
+$AUTO_MODE || echo ""
+
+# ── 读取编程工具自动生成的反馈文件 ───────────────────────────
+FEEDBACK_JSON="{}"
+if [ -f "$FEEDBACK_FILE" ]; then
+  echo "✅ 读取反馈文件：$FEEDBACK_FILE"
+  FEEDBACK_JSON=$(cat "$FEEDBACK_FILE")
+else
+  if $AUTO_MODE; then
+    echo "ℹ️  未发现 .telos-feedback.json，写入空反馈事件"
+  else
+    echo "ℹ️  未发现自动反馈文件，进入交互收集模式..."
+  fi
+fi
+
+# ── 加载 Skill 专属反馈问题（如存在则覆盖默认问题）────────────
+QUESTION_1="执行过程中哪些输入信息不清晰？"
+QUESTION_2="遇到了哪些文档未覆盖的决策点？"
+QUESTION_3="发现哪些假设与实际情况不符？"
+QUESTION_4="哪些产出无法验证质量？"
+QUESTION_5="总体反馈（执行难度、输入质量评分 1-10）："
+
+# 从 state.json 读取当前 Skill，尝试加载其 feedback-questions.sh
+STATE_FILE="$REPO_DIR/projects/$PROJECT_ID/state.json"
+if [ -f "$STATE_FILE" ]; then
+  ACTIVE_SKILL=$(python3 -c "import json; d=json.load(open('$STATE_FILE')); print(d.get('skill',''))" 2>/dev/null || echo "")
+  if [ -n "$ACTIVE_SKILL" ] && [ -f "$REPO_DIR/skills/$ACTIVE_SKILL/feedback-questions.sh" ]; then
+    source "$REPO_DIR/skills/$ACTIVE_SKILL/feedback-questions.sh"
+  fi
+fi
+
+# ── 交互补充（仅非 auto 模式）────────────────────────────────
+UNCLEAR=""
+UNCOVERED=""
+WRONG_ASSUMPTIONS=""
+UNTESTABLE=""
+GENERAL=""
+
+if ! $AUTO_MODE; then
+  echo "请回答以下问题（直接按 Enter 跳过）："
+  echo ""
+  read -p "1. $QUESTION_1 " UNCLEAR
+  read -p "2. $QUESTION_2 " UNCOVERED
+  read -p "3. $QUESTION_3 " WRONG_ASSUMPTIONS
+  read -p "4. $QUESTION_4 " UNTESTABLE
+  read -p "5. $QUESTION_5 " GENERAL
+fi
+
+# ── 合并反馈并生成事件 ────────────────────────────────────────
+PENDING=$(python3 - << PYEOF
+import json, os
+
+try:
+    existing = json.loads('''$FEEDBACK_JSON''')
+except:
+    existing = {}
+
+feedback = {
+    "event_id": "$EVENT_ID",
+    "type": "implementation_feedback",
+    "project_id": "$PROJECT_ID",
+    "timestamp": "$TIMESTAMP",
+    "distillation_candidate": True,
+    "unclear_specs": existing.get("unclear_specs", []) + (["$UNCLEAR"] if "$UNCLEAR" else []),
+    "uncovered_decisions": existing.get("uncovered_decisions", []) + (["$UNCOVERED"] if "$UNCOVERED" else []),
+    "wrong_assumptions": existing.get("wrong_assumptions", []) + (["$WRONG_ASSUMPTIONS"] if "$WRONG_ASSUMPTIONS" else []),
+    "untestable_criteria": existing.get("untestable_criteria", []) + (["$UNTESTABLE"] if "$UNTESTABLE" else []),
+    "general_feedback": existing.get("general_feedback", "") or "$GENERAL",
+    "impl_dir": "$IMPL_DIR"
+}
+
+# 过滤空字符串
+for key in ["unclear_specs", "uncovered_decisions", "wrong_assumptions", "untestable_criteria"]:
+    feedback[key] = [x for x in feedback[key] if x.strip()]
+
+# 计算质量分数
+score = 0.0
+if feedback["unclear_specs"]: score += 0.3
+if feedback["uncovered_decisions"]: score += 0.4
+if feedback["wrong_assumptions"]: score += 0.3
+if feedback["general_feedback"]: score += 0.2
+feedback["quality_score"] = min(score, 0.9)
+
+log_file = "$LOG_FILE"
+os.makedirs(os.path.dirname(log_file), exist_ok=True)
+with open(log_file, "a") as f:
+    f.write(json.dumps(feedback, ensure_ascii=False) + "\n")
+
+print(f"✅ 反馈已写入：{log_file}")
+print(f"   质量分数：{feedback['quality_score']:.2f}（≥0.6 将被蒸馏提炼）")
+
+# 统计待蒸馏事件数
+try:
+    with open(log_file) as f:
+        events = [json.loads(l) for l in f if l.strip()]
+    pending = sum(1 for e in events
+                  if e.get("distillation_candidate") and not e.get("distilled")
+                  and e.get("quality_score", 0) >= 0.6)
+    print(f"   待蒸馏事件：{pending} 条（阈值：$THRESHOLD）")
+    print(str(pending))  # 最后一行供 bash 读取
+except:
+    print("0")
+PYEOF
+)
+
+# 读取 python 输出的最后一行（待蒸馏事件数）
+PENDING_COUNT=$(echo "$PENDING" | tail -1)
+echo "$PENDING" | head -n -1  # 打印非数字行
+
+# ── 自动触发蒸馏标记 ──────────────────────────────────────────
+if [ "$PENDING_COUNT" -ge "$THRESHOLD" ] 2>/dev/null; then
+  mkdir -p "$DISTILL_NEEDED_DIR"
+  echo "$PENDING_COUNT" > "$DISTILL_NEEDED_DIR/$PROJECT_ID"
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "  ⚡ 蒸馏条件已满足（$PENDING_COUNT 条待蒸馏反馈）"
+  echo "  已写入标记：$DISTILL_NEEDED_DIR/$PROJECT_ID"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+else
+  $AUTO_MODE || echo ""
+  $AUTO_MODE || echo "━━━ 飞轮状态更新完成 ━━━"
+  $AUTO_MODE || echo "下一步：积累 ≥$THRESHOLD 条反馈后将自动触发蒸馏"
+fi

package/scripts/telos-install.sh

@@ -0,0 +1,329 @@
+#!/bin/bash
+# scripts/telos-install.sh
+# 在已安装 telos 的项目中管理 Skill 包
+#
+# Skill 三级分层：
+#   bundled   — 内置 Skill，随框架发布，不可单独更新（skills/_kernel/ 或 tier: bundled）
+#   managed   — 从注册表安装，可通过 update 升级（tier: managed）
+#   workspace — 本地 /add-skill 创建，不上传注册表（tier: workspace）
+#
+# 用法：
+#   ./scripts/telos-install.sh list              # 列出所有 Skill（含分层）
+#   ./scripts/telos-install.sh add <skill>       # 从注册表安装（标记 managed）
+#   ./scripts/telos-install.sh update            # 更新所有 managed Skill
+#   ./scripts/telos-install.sh update <skill>    # 更新指定 managed Skill
+#   ./scripts/telos-install.sh available         # 查看注册表可安装列表
+#   ./scripts/telos-install.sh publish <skill>   # 发布到本地注册表
+#   ./scripts/telos-install.sh tier <skill> <tier>  # 修改 Skill 分层
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+REPO="renmengkai/telos"
+BRANCH="main"
+BASE_URL="https://raw.githubusercontent.com/$REPO/$BRANCH"
+CMD="${1:-list}"
+TARGET="${2:-}"
+PROXY="${TELOS_PROXY:-}"
+
+[ -n "$PROXY" ] && CURL_PROXY="--proxy $PROXY" || CURL_PROXY=""
+
+# ── curl helper ─────────────────────────────────────────────────
+do_curl() {
+  curl -fsSL $CURL_PROXY "$@"
+}
+
+# ── tier helper ─────────────────────────────────────────────────
+# 返回 Skill 的分层：bundled | managed | workspace
+get_tier() {
+  local yaml="$1"
+  local name="$2"
+  [[ "$name" == _* ]] && { echo "bundled"; return; }
+  local tier
+  tier=$(grep '^tier:' "$yaml" 2>/dev/null | awk '{print $2}')
+  echo "${tier:-workspace}"
+}
+
+# tier 显示标签（对齐用）
+tier_label() {
+  case "$1" in
+    bundled)   echo "[bundled  ]" ;;
+    managed)   echo "[managed  ]" ;;
+    workspace) echo "[workspace]" ;;
+    *)         echo "[unknown  ]" ;;
+  esac
+}
+
+# 写入或更新 skill.yaml 中的 tier 字段
+set_tier_in_yaml() {
+  local yaml="$1"
+  local tier="$2"
+  if grep -q '^tier:' "$yaml" 2>/dev/null; then
+    sed -i "s/^tier:.*/tier: $tier/" "$yaml"
+  else
+    # 插到 version 行之后
+    sed -i "/^version:/a tier: $tier" "$yaml"
+  fi
+}
+
+# ── list ───────────────────────────────────────────────────────
+cmd_list() {
+  echo "━━━ 已安装 Skills ━━━"
+  echo ""
+
+  local found=false
+  local counts_bundled=0 counts_managed=0 counts_workspace=0
+
+  for yaml in "$REPO_DIR/skills"/*/skill.yaml; do
+    [ -f "$yaml" ] || continue
+    local name version desc tier label
+    name=$(basename "$(dirname "$yaml")")
+    [[ "$name" == _* ]] && continue
+    version=$(grep '^version:' "$yaml" 2>/dev/null | awk '{print $2}' || echo "?")
+    desc=$(grep '^description:' "$yaml" 2>/dev/null | cut -d: -f2- | xargs || echo "")
+    tier=$(get_tier "$yaml" "$name")
+    label=$(tier_label "$tier")
+    printf "  %s  %-20s v%-8s  %s\n" "$label" "$name" "$version" "$desc"
+    found=true
+    case "$tier" in
+      bundled)   counts_bundled=$((counts_bundled + 1)) ;;
+      managed)   counts_managed=$((counts_managed + 1)) ;;
+      workspace) counts_workspace=$((counts_workspace + 1)) ;;
+    esac
+  done
+
+  $found || echo "  （未安装任何 Skill）"
+
+  echo ""
+  echo "  bundled=$counts_bundled  managed=$counts_managed  workspace=$counts_workspace"
+  echo ""
+  echo "  bundled   — 内置，随框架更新，不可单独 update"
+  echo "  managed   — 注册表安装，可 update 升级"
+  echo "  workspace — 本地创建，不自动更新"
+  echo ""
+  echo "安装新 Skill：$0 add <name>    创建新 Skill：/add-skill"
+}
+
+# ── available ─────────────────────────────────────────────────
+cmd_available() {
+  echo "━━━ 注册表可安装 Skills ━━━"
+  local available_file="$SCRIPT_DIR/available.json"
+  if [ -f "$available_file" ]; then
+    python3 -c "
+import json
+with open('$available_file') as f:
+    data = json.load(f)
+for s in data.get('agents', data.get('skills', [])):
+    tier = s.get('tier', 'managed')
+    print(f\"  [{tier:<9}]  {s['name']:<20} v{s['version']:<8}  {s['description']}\")
+"
+  else
+    echo "  （注册表为空）"
+  fi
+  echo ""
+  echo "安装：$0 add <skill-name>"
+}
+
+# ── add ────────────────────────────────────────────────────────
+cmd_add() {
+  local agent="$1"
+  [ -z "$agent" ] && { echo "❌ 用法：$0 add <skill-name>"; exit 1; }
+
+  local dest_dir="$REPO_DIR/skills/$agent"
+  local dest_yaml="$dest_dir/skill.yaml"
+
+  echo "安装 Skill（managed）：$agent"
+
+  if ! do_curl "$BASE_URL/skills/$agent/skill.yaml" -o /dev/null 2>/dev/null; then
+    echo "❌ 注册表中未找到 Skill '$agent'"
+    echo "   运行 '$0 available' 查看可安装列表"
+    echo "   本地创建：/add-skill"
+    exit 1
+  fi
+
+  curl -fsSL $CURL_PROXY "$BASE_URL/install.sh" | bash -s -- "$agent"
+
+  # 安装后标记为 managed
+  if [ -f "$dest_yaml" ]; then
+    set_tier_in_yaml "$dest_yaml" "managed"
+    echo "  ✓ 已标记为 managed"
+  fi
+}
+
+# ── publish ────────────────────────────────────────────────────
+cmd_publish() {
+  local agent="$1"
+  [ -z "$agent" ] && { echo "❌ 用法：$0 publish <skill-name>"; exit 1; }
+
+  local yaml="$REPO_DIR/skills/$agent/skill.yaml"
+  [ -f "$yaml" ] || { echo "❌ skill '$agent' 未找到：$yaml"; exit 1; }
+
+  local tier
+  tier=$(get_tier "$yaml" "$agent")
+  if [ "$tier" = "bundled" ]; then
+    echo "❌ bundled Skill 不可发布到注册表（随框架维护）"
+    exit 1
+  fi
+
+  local name version description
+  name=$(grep '^name:' "$yaml" | head -1 | awk '{print $2}')
+  version=$(grep '^version:' "$yaml" | head -1 | awk '{print $2}')
+  description=$(grep '^description:' "$yaml" | head -1 | cut -d: -f2- | xargs)
+
+  local available_file="$SCRIPT_DIR/available.json"
+
+  echo "━━━ 发布 Skill: $agent ━━━"
+  echo ""
+
+  if [ -f "$available_file" ] && python3 -c "
+import json, sys
+data = json.load(open('$available_file'))
+agents = data.get('agents', data.get('skills', []))
+sys.exit(0 if any(s['name']=='$name' for s in agents) else 1)
+" 2>/dev/null; then
+    echo "  ℹ  '$name' 已在注册表中，更新版本..."
+    python3 - "$available_file" "$name" "$version" "$description" << 'PYEOF'
+import json, sys
+path, name, version, desc = sys.argv[1:]
+data = json.load(open(path))
+key = 'agents' if 'agents' in data else 'skills'
+for s in data[key]:
+    if s['name'] == name:
+        s['version'] = version
+        s['description'] = desc
+        s['tier'] = 'managed'
+        break
+with open(path, 'w') as f:
+    json.dump(data, f, ensure_ascii=False, indent=2)
+    f.write('\n')
+print("  ✓ available.json 已更新")
+PYEOF
+  else
+    python3 - "$available_file" "$name" "$version" "$description" << 'PYEOF'
+import json, sys, os
+path, name, version, desc = sys.argv[1:]
+data = json.load(open(path)) if os.path.exists(path) else {"agents": []}
+data.setdefault('agents', []).append({
+    "name": name, "version": version,
+    "description": desc, "tier": "managed"
+})
+with open(path, 'w') as f:
+    json.dump(data, f, ensure_ascii=False, indent=2)
+    f.write('\n')
+print(f"  ✓ '{name}' 已添加到 available.json（tier: managed）")
+PYEOF
+  fi
+
+  # 更新 skill.yaml 自身的 tier 为 managed
+  set_tier_in_yaml "$yaml" "managed"
+
+  echo ""
+  echo "下一步：提交到仓库"
+  echo "  git add scripts/available.json skills/$agent/"
+  echo "  git commit -m \"feat(skill): publish $name v$version\""
+  echo "  git push && 发起 PR 到 https://github.com/renmengkai/telos"
+}
+
+# ── update ─────────────────────────────────────────────────────
+cmd_update() {
+  local targets=()
+
+  if [ -n "$TARGET" ]; then
+    # 指定 skill，先检查 tier
+    local yaml="$REPO_DIR/skills/$TARGET/skill.yaml"
+    [ -f "$yaml" ] || { echo "❌ skill '$TARGET' 未安装"; exit 1; }
+    local tier
+    tier=$(get_tier "$yaml" "$TARGET")
+    case "$tier" in
+      bundled)
+        echo "⚠️  '$TARGET' 是 bundled Skill，随框架整体更新，不支持单独 update"
+        exit 0
+        ;;
+      workspace)
+        echo "⚠️  '$TARGET' 是 workspace Skill（本地创建），不从注册表更新"
+        echo "   如需发布后更新，先运行：$0 publish $TARGET"
+        exit 0
+        ;;
+    esac
+    targets=("$TARGET")
+  else
+    # 只收集 managed Skill
+    for yaml in "$REPO_DIR/skills"/*/skill.yaml; do
+      [ -f "$yaml" ] || continue
+      local name tier
+      name=$(basename "$(dirname "$yaml")")
+      [[ "$name" == _* ]] && continue
+      tier=$(get_tier "$yaml" "$name")
+      [ "$tier" = "managed" ] && targets+=("$name")
+    done
+  fi
+
+  if [ ${#targets[@]} -eq 0 ]; then
+    echo "没有 managed Skill 可更新"
+    echo "bundled Skill 随框架更新；workspace Skill 通过 publish 后才可 update"
+    exit 0
+  fi
+
+  echo "━━━ 更新 managed Skills ━━━"
+
+  local to_update=()
+  for agent in "${targets[@]}"; do
+    local yaml_url="$BASE_URL/skills/$agent/skill.yaml"
+    local local_ver remote_ver
+    local_ver=$(grep '^version:' "$REPO_DIR/skills/$agent/skill.yaml" 2>/dev/null | awk '{print $2}' || echo "0")
+    remote_ver=$(do_curl "$yaml_url" 2>/dev/null | grep '^version:' | awk '{print $2}' || echo "?")
+
+    if [ "$remote_ver" = "$local_ver" ]; then
+      echo "  ✓ $agent  已是最新 v$local_ver"
+    else
+      echo "  → $agent  v$local_ver → v$remote_ver"
+      to_update+=("$agent")
+    fi
+  done
+
+  if [ ${#to_update[@]} -gt 0 ]; then
+    echo ""
+    echo "更新 ${#to_update[@]} 个 Skill..."
+    for agent in "${to_update[@]}"; do
+      echo ""
+      echo "更新 $agent..."
+      cmd_add "$agent"
+    done
+  fi
+}
+
+# ── tier ───────────────────────────────────────────────────────
+cmd_tier() {
+  local agent="$1"
+  local new_tier="$2"
+  [ -z "$agent" ] || [ -z "$new_tier" ] && {
+    echo "用法：$0 tier <skill-name> <bundled|managed|workspace>"
+    exit 1
+  }
+  case "$new_tier" in
+    bundled|managed|workspace) ;;
+    *) echo "❌ 无效 tier：$new_tier（可选：bundled managed workspace）"; exit 1 ;;
+  esac
+
+  local yaml="$REPO_DIR/skills/$agent/skill.yaml"
+  [ -f "$yaml" ] || { echo "❌ skill '$agent' 未找到"; exit 1; }
+
+  local old_tier
+  old_tier=$(get_tier "$yaml" "$agent")
+  set_tier_in_yaml "$yaml" "$new_tier"
+  echo "✓ $agent: $old_tier → $new_tier"
+}
+
+case "$CMD" in
+  list)      cmd_list ;;
+  add)       cmd_add "$TARGET" ;;
+  update)    cmd_update ;;
+  available) cmd_available ;;
+  publish)   cmd_publish "$TARGET" ;;
+  tier)      cmd_tier "$TARGET" "${3:-}" ;;
+  *)
+    echo "用法：$0 list | add <skill> | update [skill] | available | publish <skill> | tier <skill> <tier>"
+    exit 1
+    ;;
+esac