@hcmai/cli 0.2.0 → 0.2.1

package/dist/index.js

@@ -4236,7 +4236,10 @@ import {
   assertSafeReferencePath,
   normalizeReferences,
   parseSkillRequirements,
+  parseSkillFrontmatter,
   resolveSkillInstallOrder,
+  resolveAllSkillsInstallOrder,
+  flattenSkills,
   matchSkills,
   filterByStage,
   formatObject as formatObject13,
@@ -4315,6 +4318,7 @@ function fail3(e, args) {
 }
 async function skillsListCommand(keyword, args) {
   try {
+    if (args.installed) return await listInstalledSkills(keyword, args);
     const { http, endpoint, base } = await chironClient(args);
     const manifest2 = await fetchSkillCatalog(http, base);
     const fmt = args.output ?? "table";
@@ -4384,6 +4388,78 @@ async function skillsListCommand(keyword, args) {
     fail3(e, args);
   }
 }
+async function listInstalledSkills(keyword, args) {
+  const layout = await resolveInstallLayout(args);
+  const state = await readSkillsState(layout.baseDir);
+  const fmt = args.output ?? "table";
+  if (!state || Object.keys(state.skills).length === 0) {
+    if (fmt === "json" || fmt === "yaml") {
+      process.stdout.write(formatObject13({ baseDir: layout.baseDir, target: layout.target, all: false, skills: [] }, { format: fmt }) + "\n");
+      process.exit(0);
+    }
+    process.stdout.write(`${path2.join(layout.baseDir, SKILLS_STATE_FILE)} \u4E0D\u5B58\u5728\u6216\u4E3A\u7A7A \u2014\u2014 \u8FD9\u4E2A\u76EE\u5F55\u4E0B\u8FD8\u6CA1\u7528\u672C CLI \u88C5\u8FC7\u6280\u80FD\u3002
+`);
+    process.stdout.write("  \u88C5\u5168\u90E8\uFF1Ahcm skills install --all\n");
+    process.exit(0);
+  }
+  const rows = [];
+  for (const [id, record] of Object.entries(state.skills).sort(([a], [b]) => a.localeCompare(b))) {
+    const markdown = await readInstalled(layout.baseDir, id);
+    let title = id;
+    if (markdown !== void 0) {
+      const raw = parseSkillFrontmatter(markdown, id).title;
+      if (typeof raw === "string" && raw.trim()) title = raw.trim();
+    }
+    rows.push({
+      id,
+      title,
+      direct: record.direct,
+      installedAt: record.installedAt,
+      // 三种状态互斥：文件没了 / 本地改过 / 和装的时候一致
+      status: markdown === void 0 ? "missing" : sha256(markdown) !== record.sha256 ? "locally-modified" : "installed"
+    });
+  }
+  const shown = keyword ? rows.filter((row) => row.id.includes(keyword) || row.title.includes(keyword)) : rows;
+  if (fmt === "json" || fmt === "yaml") {
+    process.stdout.write(formatObject13({
+      baseDir: layout.baseDir,
+      target: layout.target,
+      endpoint: state.endpoint,
+      all: Boolean(state.all),
+      updatedAt: state.updatedAt,
+      skills: shown
+    }, { format: fmt }) + "\n");
+    process.exit(0);
+  }
+  process.stdout.write(`\u5DF2\u5B89\u88C5\u7684\u777F\u620E\u6280\u80FD \u2014 ${layout.baseDir}\uFF08${layout.target}\uFF09
+`);
+  process.stdout.write(`\u6765\u6E90 ${state.endpoint ?? "\uFF08\u672A\u8BB0\u5F55\uFF09"}` + (state.all ? "   \u8DDF\u968F\u5168\u96C6\uFF1A\u662F\n\n" : "\n\n"));
+  if (shown.length === 0) {
+    process.stdout.write(`  \u6CA1\u6709\u5339\u914D\u300C${keyword}\u300D\u7684\u6280\u80FD\uFF08\u5171\u88C5\u4E86 ${rows.length} \u4E2A\uFF09
+`);
+    process.exit(0);
+  }
+  for (const row of shown) {
+    const mark = row.status === "missing" ? "?" : row.status === "locally-modified" ? "!" : row.direct ? "\u25CF" : "\u25CB";
+    const note = row.status === "missing" ? "\u6587\u4EF6\u4E0D\u89C1\u4E86\uFF08update \u4F1A\u88C5\u56DE\uFF09" : row.status === "locally-modified" ? "\u672C\u5730\u6539\u8FC7" : row.direct ? "" : "\u4F9D\u8D56\u5E26\u5165";
+    process.stdout.write(`  ${mark} ${row.id.padEnd(30)} ${row.title.padEnd(24)} ${note}
+`);
+  }
+  const modified = shown.filter((row) => row.status === "locally-modified").length;
+  const missing = shown.filter((row) => row.status === "missing").length;
+  const indirect = shown.filter((row) => row.direct === false).length;
+  process.stdout.write("\n");
+  process.stdout.write(`  \u25CF \u76F4\u63A5\u5B89\u88C5   \u25CB \u4F9D\u8D56\u5E26\u5165   ! \u672C\u5730\u6539\u8FC7   ? \u6587\u4EF6\u7F3A\u5931
+`);
+  process.stdout.write(`  \u5171 ${shown.length} \u4E2A` + [
+    indirect > 0 ? `${indirect} \u4E2A\u662F\u4F9D\u8D56\u5E26\u5165` : "",
+    modified > 0 ? `${modified} \u4E2A\u672C\u5730\u6539\u8FC7` : "",
+    missing > 0 ? `${missing} \u4E2A\u6587\u4EF6\u7F3A\u5931` : ""
+  ].filter(Boolean).map((t) => `\uFF0C${t}`).join("") + "\n");
+  process.stdout.write(`  \u5347\u7EA7\uFF1Ahcm skills update${state.all ? "" : "\uFF08\u60F3\u8DDF\u968F\u5168\u96C6\u52A0 --all\uFF09"}
+`);
+  process.exit(0);
+}
 async function skillsShowCommand(id, args) {
   try {
     const { http, base } = await chironClient(args);
@@ -4396,42 +4472,64 @@ async function skillsShowCommand(id, args) {
 }
 async function skillsInstallCommand(id, args) {
   try {
-    assertSafeSkillId(id);
+    const all = Boolean(args.all);
+    if (all && id) throw invalid("`--all` \u662F\u88C5\u6574\u4E2A\u6280\u80FD\u5E93\uFF0C\u4E0D\u8981\u518D\u5E26\u6280\u80FD id\uFF1B\u53EA\u88C5\u4E00\u4E2A\u5C31\u53BB\u6389 --all");
+    if (!all && !id) throw invalid("\u8981\u88C5\u54EA\u4E2A\u6280\u80FD\uFF1F\u7ED9\u4E2A id\uFF08`hcm skills list` \u770B\u76EE\u5F55\uFF09\uFF0C\u6216\u7528 `--all` \u88C5\u5168\u90E8");
+    if (id) assertSafeSkillId(id);
     const layout = await resolveInstallLayout(args);
     let documents;
+    let requestedIds;
     let endpoint;
     let base;
     let manifest2;
     if (args.from) {
-      documents = await resolveLocalSkillDocuments(path2.resolve(args.from), id);
+      const root = path2.resolve(args.from);
+      requestedIds = all ? await listLocalSkillIds(root) : [id];
+      const seen = /* @__PURE__ */ new Set();
+      documents = [];
+      for (const one of requestedIds) {
+        for (const document of await resolveLocalSkillDocuments(root, one)) {
+          if (seen.has(document.id)) continue;
+          seen.add(document.id);
+          documents.push(document);
+        }
+      }
     } else {
       const client3 = await chironClient(args);
       endpoint = client3.endpoint;
       base = client3.base;
       manifest2 = await fetchSkillCatalog(client3.http, base);
-      const order = resolveSkillInstallOrder(manifest2, id);
-      documents = await Promise.all(
-        order.map((skill) => fetchSkillDocument(client3.http, skill, endpoint, base))
+      const order = all ? resolveAllSkillsInstallOrder(manifest2) : resolveSkillInstallOrder(manifest2, id);
+      if (all && order.length === 0) throw invalid(`${endpoint} \u7684\u6280\u80FD\u76EE\u5F55\u662F\u7A7A\u7684\uFF0C\u6CA1\u6709\u53EF\u88C5\u7684\u6280\u80FD`);
+      requestedIds = all ? order.map((skill) => skill.id) : [id];
+      documents = await mapWithConcurrency(
+        order,
+        FETCH_CONCURRENCY,
+        (skill) => fetchSkillDocument(client3.http, skill, endpoint, base)
       );
     }
-    const result = await installSkillDocuments(documents, id, layout.baseDir, Boolean(args.force), {
+    const result = await installSkillDocuments(documents, requestedIds, layout.baseDir, Boolean(args.force), {
       endpoint,
       base,
-      target: layout.target
+      target: layout.target,
+      all
     });
     const agents = layout.agentsFile ? await syncAgentsIndex(layout, manifest2) : void 0;
     const fmt = args.output ?? "table";
     if (fmt === "json" || fmt === "yaml") {
-      process.stdout.write(formatObject13({ ...result, target_agent: layout.target, agentsFile: layout.agentsFile, agents }, { format: fmt }) + "\n");
+      process.stdout.write(formatObject13({ ...result, all, target_agent: layout.target, agentsFile: layout.agentsFile, agents }, { format: fmt }) + "\n");
     } else {
-      process.stdout.write(`\u2705 ${id} \u2192 ${result.target}
+      const headline = all ? `\u2705 \u5168\u90E8 ${requestedIds.length} \u4E2A\u6280\u80FD \u2192 ${result.baseDir}` : `\u2705 ${id} \u2192 ${path2.join(result.baseDir, id, "SKILL.md")}`;
+      process.stdout.write(`${headline}
 `);
-      if (result.installed.length > 1) {
-        process.stdout.write(`   \u5DF2\u5B89\u88C5 ${result.installed.join(" \u2192 ")}
+      if (result.installed.length > 0) {
+        process.stdout.write(all ? `   \u65B0\u5199\u5165 ${result.installed.length} \u4E2A
+` : `   \u5DF2\u5B89\u88C5 ${result.installed.join(" \u2192 ")}
 `);
       }
       if (result.unchanged.length > 0) {
-        process.stdout.write(`   \u5DF2\u5B58\u5728\u4E14\u7248\u672C\u4E00\u81F4 ${result.unchanged.join(", ")}
+        process.stdout.write(all ? `   \u5DF2\u662F\u8FD9\u4E00\u7248\u3001\u672A\u6539\u52A8 ${result.unchanged.length} \u4E2A
+` : `   \u5DF2\u5B58\u5728\u4E14\u7248\u672C\u4E00\u81F4 ${result.unchanged.join(", ")}
 `);
       }
       const referenceCount = documents.reduce((n, d) => n + (d.references?.length ?? 0), 0);
@@ -4443,16 +4541,44 @@ async function skillsInstallCommand(id, args) {
         process.stdout.write(`   \u5DF2${agents === "created" ? "\u521B\u5EFA" : "\u66F4\u65B0"} ${layout.agentsFile} \u91CC\u7684\u6280\u80FD\u7D22\u5F15\uFF08Codex \u8BFB\u8FD9\u91CC\uFF09
 `);
       }
-      process.stdout.write(`   \u6765\u6E90 ${result.source}
-`);
-      process.stdout.write(`   \u4EA7\u54C1\u66F4\u65B0\u540E\u8DD1 hcm skills update \u5347\u7EA7
+      process.stdout.write(`   \u6765\u6E90 ${endpoint ?? path2.resolve(args.from)}
 `);
+      process.stdout.write(all ? "   \u5DF2\u8BB0\u4E3A\u300C\u8DDF\u968F\u5168\u96C6\u300D\uFF1A\u4EE5\u540E\u8DD1 hcm skills update\uFF0C\u4EA7\u54C1\u65B0\u589E\u7684\u6280\u80FD\u4F1A\u81EA\u52A8\u8865\u4E0A\n" : "   \u4EA7\u54C1\u66F4\u65B0\u540E\u8DD1 hcm skills update \u5347\u7EA7\n");
     }
     process.exit(0);
   } catch (e) {
     fail3(e, args);
   }
 }
+var FETCH_CONCURRENCY = 6;
+async function mapWithConcurrency(items, limit, fn) {
+  const results = new Array(items.length);
+  let cursor = 0;
+  const worker = async () => {
+    for (; ; ) {
+      const index = cursor++;
+      if (index >= items.length) return;
+      results[index] = await fn(items[index]);
+    }
+  };
+  await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+  return results;
+}
+async function listLocalSkillIds(root) {
+  let entries;
+  try {
+    entries = await fsp.readdir(root, { withFileTypes: true });
+  } catch {
+    throw invalid(`\u8BFB\u4E0D\u5230\u672C\u5730\u6280\u80FD\u76EE\u5F55\uFF1A${root}`);
+  }
+  const ids = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (await exists(path2.join(root, entry.name, "SKILL.md"))) ids.push(entry.name);
+  }
+  if (ids.length === 0) throw invalid(`\u672C\u5730\u76EE\u5F55\u91CC\u6CA1\u6709\u4EFB\u4F55 <id>/SKILL.md\uFF1A${root}`);
+  return ids.sort();
+}
 async function fetchSkillDocument(http, skill, endpoint, base) {
   const relatives = normalizeReferences(skill.references, skill.id);
   const references = await Promise.all(relatives.map(async (relative2) => ({
@@ -4587,8 +4713,9 @@ async function upsertAgentsBlock(agentsFile, block) {
   await fsp.writeFile(agentsFile, existing + separator + block + "\n", "utf8");
   return "appended";
 }
-async function installSkillDocuments(documents, requestedId, baseDir, force, meta2) {
-  assertSafeSkillId(requestedId);
+async function installSkillDocuments(documents, requestedIds, baseDir, force, meta2) {
+  if (requestedIds.length === 0) throw invalid("\u6CA1\u6709\u6307\u5B9A\u8981\u88C5\u7684\u6280\u80FD");
+  for (const id of requestedIds) assertSafeSkillId(id);
   const seen = /* @__PURE__ */ new Set();
   const candidates = documents.map((document) => {
     assertSafeSkillId(document.id);
@@ -4601,36 +4728,32 @@ async function installSkillDocuments(documents, requestedId, baseDir, force, met
       bytes: Buffer.byteLength(document.markdown)
     };
   });
-  const requested = candidates.find((candidate) => candidate.id === requestedId);
-  if (!requested) throw invalid(`\u5B89\u88C5\u95ED\u5305\u4E0D\u5305\u542B\u76EE\u6807\u6280\u80FD: ${requestedId}`);
+  for (const id of requestedIds) {
+    if (!seen.has(id)) throw invalid(`\u5B89\u88C5\u95ED\u5305\u4E0D\u5305\u542B\u76EE\u6807\u6280\u80FD: ${id}`);
+  }
   const unchanged = /* @__PURE__ */ new Set();
   for (const candidate of candidates) {
-    let existing;
-    try {
-      existing = await fsp.readFile(candidate.target, "utf8");
-    } catch (cause) {
-      if (cause?.code !== "ENOENT") throw cause;
-    }
-    if (existing === void 0 || force) continue;
-    if (candidate.id !== requestedId && existing === candidate.markdown) {
+    if (force) continue;
+    const same = await sameOnDisk(baseDir, candidate);
+    if (same === void 0) continue;
+    if (same) {
       unchanged.add(candidate.id);
       continue;
     }
-    const kind = candidate.id === requestedId ? "\u76EE\u6807\u6280\u80FD\u5DF2\u5B58\u5728" : "\u524D\u7F6E\u6280\u80FD\u4E0E\u76EE\u6807\u73AF\u5883\u7248\u672C\u4E0D\u4E00\u81F4";
-    throw invalid(`${kind}\uFF1A${candidate.target}\u3002\u7528 --force \u8986\u76D6\u6574\u4E2A\u4F9D\u8D56\u95ED\u5305\uFF0C\u6216 --dir <path> \u88C5\u5230\u522B\u5904`);
+    throw invalid(
+      `${candidate.target} \u5DF2\u5B58\u5728\uFF0C\u4E14\u548C\u76EE\u6807\u73AF\u5883\u8FD9\u4E00\u7248\u4E0D\u4E00\u81F4\u3002\u7528 --force \u8986\u76D6\uFF08\u4F1A\u4E22\u6389\u672C\u5730\u6539\u52A8\uFF09\uFF0C\u6216 --dir <path> \u88C5\u5230\u522B\u5904\uFF1B\u53EA\u60F3\u8DDF\u4E0A\u4EA7\u54C1\u7248\u672C\u7528 hcm skills update`
+    );
   }
   const pending = candidates.filter((candidate) => !unchanged.has(candidate.id));
   await writeSkillDocuments(pending, baseDir);
   await recordInstalled(baseDir, candidates, {
     ...meta2,
-    directIds: /* @__PURE__ */ new Set([requestedId]),
+    directIds: new Set(requestedIds),
     keepInstalledAt: unchanged
   });
   return {
-    id: requestedId,
-    target: requested.target,
-    source: requested.source,
-    bytes: requested.bytes,
+    ids: [...requestedIds],
+    baseDir,
     installed: pending.map((candidate) => candidate.id),
     unchanged: candidates.filter((candidate) => unchanged.has(candidate.id)).map((candidate) => candidate.id),
     files: candidates.map((candidate) => ({
@@ -4642,6 +4765,15 @@ async function installSkillDocuments(documents, requestedId, baseDir, force, met
     }))
   };
 }
+async function sameOnDisk(baseDir, candidate) {
+  const existing = await readInstalled(baseDir, candidate.id);
+  if (existing === void 0) return void 0;
+  if (existing !== candidate.markdown) return false;
+  for (const reference of candidate.references ?? []) {
+    if (await readInstalledReference(baseDir, candidate.id, reference.path) !== reference.content) return false;
+  }
+  return true;
+}
 async function readLocalReferences(skillDir) {
   const root = path2.join(skillDir, "references");
   const out = [];
@@ -4702,6 +4834,7 @@ async function recordInstalled(baseDir, documents, meta2) {
   if (meta2.target) state.target = meta2.target;
   if (meta2.endpoint) state.endpoint = meta2.endpoint;
   if (meta2.base !== void 0) state.base = meta2.base;
+  if (meta2.all) state.all = true;
   state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   for (const document of documents) {
     const previous = state.skills[document.id];
@@ -4740,11 +4873,13 @@ async function readInstalledReference(baseDir, id, relative2) {
 }
 async function planSkillUpdate(options) {
   const { state, manifest: manifest2, baseDir, force, fetchDocument } = options;
+  const all = options.all ?? Boolean(state.all);
   const recorded = Object.entries(state.skills);
   const directIds = recorded.some(([, r]) => r.direct) ? recorded.filter(([, r]) => r.direct).map(([id]) => id) : recorded.map(([id]) => id);
+  const wanted = all ? [.../* @__PURE__ */ new Set([...directIds, ...flattenSkills(manifest2).map((skill) => skill.id)])] : directIds;
   const entries = [];
   const closure = /* @__PURE__ */ new Map();
-  for (const id of directIds.sort()) {
+  for (const id of wanted.sort()) {
     try {
       for (const skill of resolveSkillInstallOrder(manifest2, id)) {
         if (!closure.has(skill.id)) closure.set(skill.id, skill);
@@ -4766,7 +4901,7 @@ async function planSkillUpdate(options) {
       entries.push({
         id: skill.id,
         status: "added",
-        note: record ? "\u672C\u5730\u6587\u4EF6\u7F3A\u5931\uFF0C\u91CD\u65B0\u88C5\u56DE" : "\u4EA7\u54C1\u65B0\u589E\u7684\u524D\u7F6E\u6280\u80FD"
+        note: record ? "\u672C\u5730\u6587\u4EF6\u7F3A\u5931\uFF0C\u91CD\u65B0\u88C5\u56DE" : all ? "\u4EA7\u54C1\u8FD9\u4E00\u7248\u65B0\u589E\u7684\u6280\u80FD" : "\u4EA7\u54C1\u65B0\u589E\u7684\u524D\u7F6E\u6280\u80FD"
       });
       continue;
     }
@@ -4825,20 +4960,24 @@ async function skillsUpdateCommand(args) {
     });
     const { http, base } = await chironClient({ ...args, endpoint });
     const manifest2 = await fetchSkillCatalog(http, base);
+    const all = Boolean(args.all) || Boolean(state.all);
     const plan = await planSkillUpdate({
       state,
       manifest: manifest2,
       baseDir: layout.baseDir,
       force: Boolean(args.force),
+      all,
       fetchDocument: (skill) => fetchSkillDocument(http, skill, endpoint, base)
     });
-    if (!args.check && plan.documents.length > 0) {
+    const subscriptionChanged = all && !state.all;
+    if (!args.check && (plan.documents.length > 0 || subscriptionChanged)) {
       await writeSkillDocuments(plan.documents, layout.baseDir);
       await recordInstalled(layout.baseDir, plan.documents, {
         endpoint,
         base,
         target: layout.target,
-        directIds: /* @__PURE__ */ new Set()
+        all,
+        directIds: all ? new Set(plan.documents.map((document) => document.id)) : /* @__PURE__ */ new Set()
       });
       if (layout.agentsFile) await syncAgentsIndex(layout, manifest2);
     }
@@ -4850,6 +4989,7 @@ async function skillsUpdateCommand(args) {
         baseDir: layout.baseDir,
         target: layout.target,
         dryRun: Boolean(args.check),
+        all,
         changed: changed.length,
         entries: plan.entries
       }, { format: fmt }) + "\n");
@@ -4857,9 +4997,7 @@ async function skillsUpdateCommand(args) {
     }
     process.stdout.write(`\u777F\u620E\u6280\u80FD\u5347\u7EA7 \u2014 ${endpoint}
 `);
-    process.stdout.write(`\u843D\u70B9 ${layout.baseDir}\uFF08${layout.target}\uFF09
-
-`);
+    process.stdout.write(`\u843D\u70B9 ${layout.baseDir}\uFF08${layout.target}\uFF09` + (all ? "  \u8DDF\u968F\u5168\u96C6\uFF1A\u4EA7\u54C1\u65B0\u589E\u7684\u6280\u80FD\u4F1A\u81EA\u52A8\u8865\u4E0A\n\n" : "\n\n"));
     for (const entry of plan.entries) {
       const mark = entry.status === "unchanged" ? " " : entry.status === "locally-modified" ? "!" : "\xB7";
       process.stdout.write(`  ${mark} ${entry.id.padEnd(30)} ${UPDATE_STATUS_LABEL[entry.status]}
@@ -6562,10 +6700,10 @@ meta.command("get <path>").description("\u6253\u5370 meta \u539F\u6587\uFF08\u59
 meta.command("set <path>").description("\u5199\u5165 meta \u539F\u6587\uFF1B\u5199\u5B8C\u987B hcm cache clear-meta <Model> \u624D\u751F\u6548").requiredOption("--file <file>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6\u539F\u6587\uFF08- \u8868\u793A stdin\uFF09").option("--dry-run", "\u53EA\u663E\u793A\u5C06\u5199\u5165\u7684\u5185\u5BB9\uFF0C\u4E0D\u5B9E\u9645\u5199\u5165").option("--env <name>", "\u4E34\u65F6\u5207\u73AF\u5883\uFF08\u8986\u76D6 activeEnv\uFF0C\u672C\u6B21\u547D\u4EE4\uFF09").option("--as <identity>", "\u4E34\u65F6\u6362\u8EAB\u4EFD").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "json").action((p, opts) => metaSetCommand(p, opts));
 meta.command("delete <path>").description("\u5220\u9664 meta\uFF08\u4E0D\u53EF\u9006\uFF0C\u9ED8\u8BA4\u8FC7\u786E\u8BA4\u95F8\uFF09").option("-y, --yes", "\u8DF3\u8FC7\u786E\u8BA4").option("--env <name>", "\u4E34\u65F6\u5207\u73AF\u5883\uFF08\u8986\u76D6 activeEnv\uFF0C\u672C\u6B21\u547D\u4EE4\uFF09").option("--as <identity>", "\u4E34\u65F6\u6362\u8EAB\u4EFD").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "json").action((p, opts) => metaDeleteCommand(p, opts));
 var skills = program.command("skills").description("\u777F\u620E Chiron \u4EA4\u4ED8\u6280\u80FD\u5E93\uFF1A\u5217\u51FA / \u67E5\u770B / \u5B89\u88C5\u4EA4\u4ED8\u6280\u80FD\uFF08\u514D\u8BA4\u8BC1\uFF0C\u65E0\u9700\u5148 login\uFF09");
-skills.command("list [keyword]").description("\u5217\u51FA\u76EE\u6807\u73AF\u5883\u8FD9\u4E00\u7248\u7684\u4EA4\u4ED8\u6280\u80FD").option("--category <key>", "\u53EA\u770B\u67D0\u4E2A\u5206\u7C7B").option("--stage <key>", "\u53EA\u770B\u67D0\u4E2A\u4EA4\u4ED8\u9636\u6BB5\uFF1Ahandover | baseline | configure | migrate | integrate | golive | operate").option("--by-stage", "\u6309\u4EA4\u4ED8\u751F\u547D\u5468\u671F\u5206\u7EC4\u5C55\u793A\uFF08\u9ED8\u8BA4\u6309\u529F\u80FD\u5206\u7C7B\uFF09").option("--endpoint <url>", "\u6280\u80FD\u5E93\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6 activeEnv \u7684 endpoint\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "table").action((kw, opts) => skillsListCommand(kw, opts));
+skills.command("list [keyword]").description("\u5217\u51FA\u76EE\u6807\u73AF\u5883\u8FD9\u4E00\u7248\u7684\u4EA4\u4ED8\u6280\u80FD\uFF1B--installed \u6539\u770B\u672C\u5730\u88C5\u4E86\u54EA\u4E9B\uFF08\u4E0D\u8FDE\u7F51\uFF09").option("--installed", "\u53EA\u770B\u672C\u5730\u5DF2\u88C5\u7684\u6280\u80FD\uFF08\u8BFB .hcm-skills.json\uFF0C\u4E0D\u8FDE\u7F51\uFF09").option("--target <agent>", "\u914D\u5408 --installed\uFF1Aclaude | codex | auto", "auto").option("--global", "\u914D\u5408 --installed\uFF1A\u770B\u7528\u6237\u7EA7\u76EE\u5F55").option("--dir <path>", "\u914D\u5408 --installed\uFF1A\u770B\u6307\u5B9A\u76EE\u5F55").option("--category <key>", "\u53EA\u770B\u67D0\u4E2A\u5206\u7C7B").option("--stage <key>", "\u53EA\u770B\u67D0\u4E2A\u4EA4\u4ED8\u9636\u6BB5\uFF1Ahandover | baseline | configure | migrate | integrate | golive | operate").option("--by-stage", "\u6309\u4EA4\u4ED8\u751F\u547D\u5468\u671F\u5206\u7EC4\u5C55\u793A\uFF08\u9ED8\u8BA4\u6309\u529F\u80FD\u5206\u7C7B\uFF09").option("--endpoint <url>", "\u6280\u80FD\u5E93\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6 activeEnv \u7684 endpoint\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "table").action((kw, opts) => skillsListCommand(kw, opts));
 skills.command("show <id>").description("\u6253\u5370\u6280\u80FD\u539F\u6587\uFF08\u7BA1\u9053\u53CB\u597D\uFF09").option("--endpoint <url>", "\u6280\u80FD\u5E93\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6 activeEnv \u7684 endpoint\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").action((id, opts) => skillsShowCommand(id, opts));
-skills.command("install <id>").description("\u8FDE\u540C requires \u524D\u7F6E\u6280\u80FD\u4E0E\u53C2\u8003\u6587\u4EF6\u88C5\u5230 agent \u6280\u80FD\u76EE\u5F55").option("--target <agent>", "\u88C5\u7ED9\u54EA\u4E2A agent\uFF1Aclaude\uFF08.claude/skills/\uFF09| codex\uFF08hcm-skills/ + AGENTS.md\uFF09| auto", "auto").option("--global", "\u88C5\u5230\u7528\u6237\u7EA7\u76EE\u5F55\u800C\u975E\u5F53\u524D\u9879\u76EE").option("--dir <path>", "\u88C5\u5230\u6307\u5B9A\u76EE\u5F55").option("--from <dir>", "\u4ECE\u672C\u5730\u76EE\u5F55\u88C5\uFF08\u73B0\u573A\u6539\u8FC7\u7684\u7248\u672C\uFF09\uFF0C\u4E0D\u8D70\u7F51\u7EDC").option("--force", "\u8986\u76D6\u5DF2\u5B58\u5728\u7684\u540C\u540D\u6280\u80FD").option("--endpoint <url>", "\u6280\u80FD\u5E93\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6 activeEnv \u7684 endpoint\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "table").action((id, opts) => skillsInstallCommand(id, opts));
-skills.command("update").description("\u628A\u88C5\u8FC7\u7684\u6280\u80FD\u5347\u5230\u76EE\u6807\u73AF\u5883\u8FD9\u4E00\u7248\uFF08\u4EA7\u54C1\u5347\u7EA7\u540E\u8DD1\u5B83\uFF09").option("--check", "\u53EA\u770B\u4F1A\u53D8\u4EC0\u4E48\uFF0C\u4E0D\u5199\u76D8").option("--target <agent>", "claude | codex | auto\uFF08\u9ED8\u8BA4\u6309\u5DF2\u5B89\u88C5\u76EE\u5F55\u63A2\uFF09", "auto").option("--global", "\u5347\u7EA7\u7528\u6237\u7EA7\u76EE\u5F55\u91CC\u7684\u6280\u80FD").option("--dir <path>", "\u5347\u7EA7\u6307\u5B9A\u76EE\u5F55\u91CC\u7684\u6280\u80FD").option("--force", "\u8FDE\u672C\u5730\u6539\u8FC7\u7684\u6280\u80FD\u4E00\u8D77\u8986\u76D6\u6210\u4EA7\u54C1\u8FD9\u4E00\u7248").option("--endpoint <url>", "\u6280\u80FD\u5E93\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6\u5B89\u88C5\u65F6\u8BB0\u5F55\u7684\u5730\u5740\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "table").action((opts) => skillsUpdateCommand(opts));
+skills.command("install [id]").description("\u8FDE\u540C requires \u524D\u7F6E\u6280\u80FD\u4E0E\u53C2\u8003\u6587\u4EF6\u88C5\u5230 agent \u6280\u80FD\u76EE\u5F55\uFF1B--all \u88C5\u6574\u4E2A\u6280\u80FD\u5E93").option("--all", "\u88C5\u6574\u4E2A\u6280\u80FD\u5E93\uFF0C\u5E76\u8BB0\u4E3A\u300C\u8DDF\u968F\u5168\u96C6\u300D\uFF08\u5F80\u540E update \u4F1A\u81EA\u52A8\u8865\u4E0A\u4EA7\u54C1\u65B0\u589E\u7684\u6280\u80FD\uFF09").option("--target <agent>", "\u88C5\u7ED9\u54EA\u4E2A agent\uFF1Aclaude\uFF08.claude/skills/\uFF09| codex\uFF08hcm-skills/ + AGENTS.md\uFF09| auto", "auto").option("--global", "\u88C5\u5230\u7528\u6237\u7EA7\u76EE\u5F55\u800C\u975E\u5F53\u524D\u9879\u76EE").option("--dir <path>", "\u88C5\u5230\u6307\u5B9A\u76EE\u5F55").option("--from <dir>", "\u4ECE\u672C\u5730\u76EE\u5F55\u88C5\uFF08\u73B0\u573A\u6539\u8FC7\u7684\u7248\u672C\uFF09\uFF0C\u4E0D\u8D70\u7F51\u7EDC").option("--force", "\u8986\u76D6\u5DF2\u5B58\u5728\u7684\u540C\u540D\u6280\u80FD").option("--endpoint <url>", "\u6280\u80FD\u5E93\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6 activeEnv \u7684 endpoint\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "table").action((id, opts) => skillsInstallCommand(id, opts));
+skills.command("update").description("\u628A\u88C5\u8FC7\u7684\u6280\u80FD\u5347\u5230\u76EE\u6807\u73AF\u5883\u8FD9\u4E00\u7248\uFF08\u4EA7\u54C1\u5347\u7EA7\u540E\u8DD1\u5B83\uFF09").option("--all", "\u8FDE\u4EA7\u54C1\u65B0\u589E\u7684\u6280\u80FD\u4E00\u8D77\u88C5\u4E0A\uFF0C\u5E76\u8BB0\u4E3A\u300C\u8DDF\u968F\u5168\u96C6\u300D").option("--check", "\u53EA\u770B\u4F1A\u53D8\u4EC0\u4E48\uFF0C\u4E0D\u5199\u76D8").option("--target <agent>", "claude | codex | auto\uFF08\u9ED8\u8BA4\u6309\u5DF2\u5B89\u88C5\u76EE\u5F55\u63A2\uFF09", "auto").option("--global", "\u5347\u7EA7\u7528\u6237\u7EA7\u76EE\u5F55\u91CC\u7684\u6280\u80FD").option("--dir <path>", "\u5347\u7EA7\u6307\u5B9A\u76EE\u5F55\u91CC\u7684\u6280\u80FD").option("--force", "\u8FDE\u672C\u5730\u6539\u8FC7\u7684\u6280\u80FD\u4E00\u8D77\u8986\u76D6\u6210\u4EA7\u54C1\u8FD9\u4E00\u7248").option("--endpoint <url>", "\u6280\u80FD\u5E93\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6\u5B89\u88C5\u65F6\u8BB0\u5F55\u7684\u5730\u5740\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "table").action((opts) => skillsUpdateCommand(opts));
 program.command("update <Model>").description("\u66F4\u65B0\u4E00\u6761 Model \u8BB0\u5F55\uFF08\u8D70\u540E\u7AEF\u5B8C\u6574\u6821\u9A8C\uFF09").requiredOption("--id <id>", "\u8BB0\u5F55 ID").requiredOption("--data <JSON>", `\u8981\u66F4\u65B0\u7684\u5B57\u6BB5 JSON\uFF0C\u4F8B\u5982 '{"name":"\u65B0\u540D\u79F0"}'`).option("--env <name>", "\u4E34\u65F6\u5207\u73AF\u5883\uFF08\u8986\u76D6 activeEnv\uFF0C\u672C\u6B21\u547D\u4EE4\uFF09").option("--as <identity>", "\u4E34\u65F6\u6362\u8EAB\u4EFD\uFF08\u8986\u76D6 env defaultIdentity\uFF0C\u672C\u6B21\u547D\u4EE4\uFF09").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "json").action((model, opts) => updateCommand(model, opts));
 program.command("version").description("\u67E5\u540E\u7AEF\u7248\u672C\uFF08commit / tag / \u6784\u5EFA\u65F6\u95F4\uFF09\u2014\u2014\u514D\u8BA4\u8BC1\uFF0C\u65E0\u9700\u5148 login").option("--endpoint <url>", "\u540E\u7AEF\u5730\u5740\uFF08\u9ED8\u8BA4\u53D6 activeEnv \u7684 endpoint\uFF09").option("--env <name>", "\u4ECE\u8BE5 env \u89E3\u6790 endpoint").option("--output <fmt>", "\u8F93\u51FA\u683C\u5F0F\uFF1Atable | json | yaml", "json").action((opts) => versionCommand(opts));
 var setting = program.command("setting").description("\u79DF\u6237\u7CFB\u7EDF\u53C2\u6570\uFF08\u767B\u5F55\u7B56\u7565 / \u5BC6\u7801\u7B56\u7565 / \u529F\u80FD\u5F00\u5173 / \u96C6\u6210\u53C2\u6570\uFF09");