left-skills 0.7.0 → 0.9.0

package/dist/cli.js

@@ -6709,8 +6709,8 @@ function formatMarkdown(report) {
 
 // src/install.ts
 var import_node_fs3 = require("fs");
-var import_node_os3 = require("os");
 var import_node_path3 = require("path");
+var import_node_os3 = require("os");
 function hookSnippet() {
   const cmd = "left-skills hook";
   return {
@@ -6776,6 +6776,45 @@ function removeHooksFromSettings(settingsPath) {
 function globalSettingsPath() {
   return (0, import_node_path3.join)((0, import_node_os3.homedir)(), ".claude", "settings.json");
 }
+var SKILL_MD_CONTENT = `---
+name: left-skills
+description: \u7BA1\u7406 AI skill \u751F\u547D\u5468\u671F\u3002\u7528\u6237\u60F3\u68C0\u67E5/\u6539\u8FDB/\u53D1\u73B0 skill \u65F6\u89E6\u53D1\u3002
+---
+
+# left-skills
+
+\u4F60\u662F skill \u751F\u547D\u5468\u671F\u7BA1\u7406\u52A9\u624B\u3002\u901A\u8FC7 left-skills CLI \u91C7\u96C6\u6570\u636E(--json),\u4F60\u505A\u5206\u6790\u5224\u65AD\u3002
+
+## \u6D41\u7A0B
+1. \u8DD1 \`left-skills <\u547D\u4EE4> --json\`(Bash,\u91C7\u96C6\u6570\u636E)
+2. \u8BFB JSON,\u4F60\u5206\u6790\u5224\u65AD(\u8BED\u4E49)
+3. \u8F93\u51FA\u5EFA\u8BAE/\u8349\u7A3F\u7ED9\u7528\u6237\u5BA1(\u4E0D\u81EA\u52A8\u6539)
+
+## \u5165\u53E3 \u2192 CLI \u7EC4\u5408
+
+| \u7528\u6237\u610F\u56FE | \u8DD1\u4EC0\u4E48 | \u4F60\u505A\u4EC0\u4E48 |
+|---|---|---|
+| \u68C0\u67E5\u8D28\u91CF | \`left-skills lint --json\` | \u8BFB\u62A5\u544A,\u5EFA\u8BAE\u600E\u4E48\u4FEE |
+| \u770B\u7528\u6CA1\u7528 | \`left-skills usage --json\` | \u8BFB\u62A5\u544A,\u5EFA\u8BAE\u6539/\u5220 |
+| \u8BE5\u5199\u4EC0\u4E48 | \`left-skills scan --json\` + \`left-skills list-skills --json\` | \u8BFB\u5019\u9009+\u540D\u5355,\u5224\u65AD,\u751F\u6210\u8349\u7A3F |
+| \u6539\u8FDB skill | \`left-skills usage --json\` + \`left-skills lint --json\`(\u8FC7\u6EE4 skill) | \u8BFB\u4FE1\u53F7,\u751F\u6210 diff |
+| \u8BCA\u65AD | \`left-skills doctor\` | \u8F93\u51FA\u7ED9\u7528\u6237 |
+
+## \u7EA2\u7EBF
+- \u4E0D\u81EA\u52A8\u6539 skill(\u4EBA\u5BA1)
+- \u4E0D\u81EA\u52A8\u521B\u5EFA skill(\u4EBA\u5BA1)
+`;
+function writeSkillWrapper() {
+  const skillDir = (0, import_node_path3.join)((0, import_node_os3.homedir)(), ".claude", "skills", "left-skills");
+  (0, import_node_fs3.mkdirSync)(skillDir, { recursive: true });
+  (0, import_node_fs3.writeFileSync)((0, import_node_path3.join)(skillDir, "SKILL.md"), SKILL_MD_CONTENT, "utf-8");
+}
+function removeSkillWrapper() {
+  const skillDir = (0, import_node_path3.join)((0, import_node_os3.homedir)(), ".claude", "skills", "left-skills");
+  if ((0, import_node_fs3.existsSync)(skillDir)) {
+    (0, import_node_fs3.rmSync)(skillDir, { recursive: true, force: true });
+  }
+}
 
 // src/doctor.ts
 var import_node_fs4 = require("fs");
@@ -6917,141 +6956,27 @@ function formatLintHuman(results) {
   }
   return lines.join("\n");
 }
+function formatLintJson(results) {
+  return JSON.stringify({ skills: results });
+}
 
-// src/evolve.ts
+// src/scan.ts
 var import_node_fs6 = require("fs");
 var import_node_path6 = require("path");
 var import_node_os6 = require("os");
-function findSkillDir(skillName) {
-  const dirs = [
-    (0, import_node_path6.join)(process.cwd(), ".claude/skills"),
-    (0, import_node_path6.join)(process.cwd(), ".codex/skills"),
-    (0, import_node_path6.join)((0, import_node_os6.homedir)(), ".claude/skills"),
-    (0, import_node_path6.join)((0, import_node_os6.homedir)(), ".codex/skills")
-  ];
-  for (const d of dirs) {
-    if (!(0, import_node_fs6.existsSync)(d)) continue;
-    const skillDir = (0, import_node_path6.join)(d, skillName);
-    if ((0, import_node_fs6.existsSync)(skillDir)) return skillDir;
-  }
-  return null;
-}
-function evolvePrompt(skillName) {
-  const lines = [];
-  lines.push(`# \u6539\u8FDB skill: ${skillName}`);
-  lines.push("");
-  const stats = aggregate(30);
-  const stat = stats.find((s) => s.name === skillName);
-  const total = stat ? stat.manual + stat.ai + stat.mention : 0;
-  lines.push(`## usage \u4FE1\u53F7`);
-  if (!stat || total === 0) {
-    lines.push(`- \u26A0 \u8FD1 30 \u5929\u4ECE\u672A\u8C03\u7528(\u5199\u4E86\u6CA1\u7528?description \u6CA1\u8BF4\u6E05 trigger \u2192 AI \u4E0D\u89E6\u53D1)`);
-  } else {
-    lines.push(`- \u8C03\u7528 ${total} \u6B21(\u624B\u52A8 ${stat.manual} + AI ${stat.ai} + \u63D0\u53CA ${stat.mention})`);
-    if (stat.ai === 0) lines.push(`- \u26A0 AI \u4ECE\u4E0D\u4E3B\u52A8\u8C03\u7528(\u53EA\u624B\u52A8,description \u53EF\u80FD\u6CA1\u8BA9 AI \u89E6\u53D1)`);
-  }
-  const skillDir = findSkillDir(skillName);
-  lines.push("");
-  lines.push(`## lint \u4FE1\u53F7`);
-  let lint = null;
-  if (!skillDir) {
-    lines.push(`- \u26A0 skill \u76EE\u5F55\u627E\u4E0D\u5230(${skillName} \u672A\u88C5?)`);
-  } else {
-    lint = lintSkill(skillDir);
-    if (lint.issues.length === 0) {
-      lines.push(`- \u2713 \u9759\u6001\u8D28\u91CF\u5408\u89C4(0 issue)`);
-    } else {
-      for (const issue of lint.issues) {
-        lines.push(`- ${issue.severity}  ${issue.rule}: ${issue.message}`);
-      }
-    }
-  }
-  lines.push("");
-  lines.push(`## \u6539\u8FDB\u6307\u4EE4(\u7ED9 AI)`);
-  lines.push(`\u8BF7\u57FA\u4E8E\u4EE5\u4E0A\u4FE1\u53F7,\u6539\u8FDB skill \`${skillName}\` \u7684 SKILL.md:`);
-  if (!stat || total === 0) {
-    lines.push(`- description \u6CA1\u8BA9 AI \u89E6\u53D1 \u2192 \u6539 description,\u52A0 "Use when..." \u89E6\u53D1\u573A\u666F(\u8BF4\u660E\u80FD\u529B + \u4F55\u65F6\u7528)`);
-  }
-  if (stat && stat.ai === 0) {
-    lines.push(`- AI \u4E0D\u4E3B\u52A8\u8C03\u7528 \u2192 description \u8865 trigger \u5173\u952E\u8BCD(\u8BA9 AI \u81EA\u51B3\u89E6\u53D1)`);
-  }
-  if (lint) {
-    for (const issue of lint.issues) {
-      if (issue.severity === "ERROR") {
-        if (issue.rule === "name-kebab") lines.push(`- name \u4E0D\u5408\u89C4 \u2192 \u6539 name \u4E3A kebab-case(\u5C0F\u5199+\u8FDE\u5B57\u7B26)`);
-        if (issue.rule === "name-dir-match") lines.push(`- name\u2260\u76EE\u5F55 \u2192 \u6539 name \u6216\u76EE\u5F55\u540D(\u4E00\u81F4)`);
-        if (issue.rule === "description-present") lines.push(`- description \u7F3A \u2192 \u52A0 description(\u8BF4\u660E\u80FD\u529B+\u89E6\u53D1)`);
-      }
-      if (issue.severity === "WARN" && issue.rule === "description-len") lines.push(`- description \u957F\u5EA6 \u2192 \u8C03\u5230 20-300 \u5B57\u7B26`);
-      if (issue.severity === "WARN" && issue.rule === "token-budget") lines.push(`- body \u592A\u957F \u2192 \u62C6 references/`);
-    }
-  }
-  lines.push("");
-  lines.push(`\u751F\u6210\u6539\u8FDB diff,\u6211\u5BA1\u8FC7\u540E\u5E94\u7528(\u4E0D\u81EA\u52A8\u6539)\u3002`);
-  return lines.join("\n");
-}
-
-// src/inspire.ts
-var import_node_fs8 = require("fs");
-var import_node_path8 = require("path");
-var import_node_os8 = require("os");
-
-// src/llm.ts
-var import_node_fs7 = require("fs");
-var import_node_os7 = require("os");
-var import_node_path7 = require("path");
-var ANTHROPIC_API_URL = "https://api.anthropic.com/v1/messages";
-function getApiKey() {
-  const env = process.env.ANTHROPIC_API_KEY;
-  if (env) return env;
-  try {
-    const settings = JSON.parse((0, import_node_fs7.readFileSync)((0, import_node_path7.join)((0, import_node_os7.homedir)(), ".claude", "settings.json"), "utf-8"));
-    return settings.env?.ANTHROPIC_API_KEY || null;
-  } catch {
-    return null;
-  }
-}
-async function llmAnalyze(prompt, system) {
-  const apiKey = getApiKey();
-  if (!apiKey) return null;
-  const model = process.env.ANTHROPIC_MODEL || "claude-sonnet-4-6";
-  try {
-    const response = await fetch(ANTHROPIC_API_URL, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": apiKey,
-        "anthropic-version": "2023-06-01"
-      },
-      body: JSON.stringify({
-        model,
-        max_tokens: 1024,
-        system,
-        messages: [{ role: "user", content: prompt }]
-      })
-    });
-    if (!response.ok) return null;
-    const data = await response.json();
-    return data.content?.[0]?.text || null;
-  } catch {
-    return null;
-  }
-}
-
-// src/inspire.ts
 function scanSessions(sinceDays = 30) {
-  const projectsDir = (0, import_node_path8.join)((0, import_node_os8.homedir)(), ".claude", "projects");
+  const projectsDir = (0, import_node_path6.join)((0, import_node_os6.homedir)(), ".claude", "projects");
   const cmdCount = /* @__PURE__ */ new Map();
   const seqCount = /* @__PURE__ */ new Map();
-  if (!(0, import_node_fs8.existsSync)(projectsDir)) return { cmdCount, seqCount };
+  if (!(0, import_node_fs6.existsSync)(projectsDir)) return { cmdCount, seqCount };
   const cutoff = Date.now() - sinceDays * 864e5;
-  for (const project of (0, import_node_fs8.readdirSync)(projectsDir, { withFileTypes: true })) {
+  for (const project of (0, import_node_fs6.readdirSync)(projectsDir, { withFileTypes: true })) {
     if (!project.isDirectory()) continue;
-    const projectDir = (0, import_node_path8.join)(projectsDir, project.name);
-    for (const file of (0, import_node_fs8.readdirSync)(projectDir)) {
+    const projectDir = (0, import_node_path6.join)(projectsDir, project.name);
+    for (const file of (0, import_node_fs6.readdirSync)(projectDir)) {
       if (!file.endsWith(".jsonl")) continue;
       try {
-        const content = (0, import_node_fs8.readFileSync)((0, import_node_path8.join)(projectDir, file), "utf-8");
+        const content = (0, import_node_fs6.readFileSync)((0, import_node_path6.join)(projectDir, file), "utf-8");
         const toolNames = [];
         for (const line of content.split("\n")) {
           if (!line.trim()) continue;
@@ -7098,7 +7023,7 @@ function isSeqNoise(seq) {
   if (parts.every((p) => p === parts[0])) return true;
   return false;
 }
-async function inspirePrompt(sinceDays = 30) {
+function scan(sinceDays = 30) {
   const { cmdCount, seqCount } = scanSessions(sinceDays);
   const skeletonCount = /* @__PURE__ */ new Map();
   for (const [cmd, count] of cmdCount) {
@@ -7112,74 +7037,15 @@ async function inspirePrompt(sinceDays = 30) {
       skeletonCount.set(skeleton, { count, examples: [cmd.slice(0, 80)] });
     }
   }
-  const cmdCandidates = [...skeletonCount.entries()].filter(([, info]) => info.count >= 3).sort((a, b) => b[1].count - a[1].count);
-  const seqCandidates = [...seqCount.entries()].filter(([seq, count]) => count >= 3 && !isSeqNoise(seq)).sort((a, b) => b[1] - a[1]).slice(0, 10);
-  if (cmdCandidates.length === 0 && seqCandidates.length === 0) {
-    return "\u65E0\u91CD\u590D\u6A21\u5F0F(Bash \u9AA8\u67B6 \u22653 \u6216 tool \u5E8F\u5217 \u22653),\u6682\u4E0D\u5EFA\u8BAE\u5199 skill\u3002\n(\u8BD5\u66F4\u591A\u5929?left-skills inspire --since 90)";
-  }
-  const installed = listInstalledSkills();
-  const llmPrompt = `\u4F60\u53CD\u590D\u8DD1\u8FD9\u4E9B(${cmdCandidates.length} \u4E2A Bash \u9AA8\u67B6 + ${seqCandidates.length} \u4E2A tool \u5E8F\u5217):
-
-## Bash \u9AA8\u67B6\u5019\u9009
-${cmdCandidates.slice(0, 10).map(([sk, info]) => `- ${sk}(${info.count} \u6B21,\u4F8B: ${info.examples[0]})`).join("\n") || "(\u65E0)"}
-
-## tool \u5E8F\u5217\u5019\u9009(all tools,\u5DE5\u4F5C\u6D41)
-${seqCandidates.map(([seq, count]) => `- ${seq}(${count} \u6B21)`).join("\n") || "(\u65E0)"}
-
-\u5DF2\u88C5 skill(\u907F\u514D\u91CD\u590D\u63D0\u8BAE):
-${installed.length > 0 ? installed.map((s) => "- " + s).join("\n") : "(\u65E0)"}
-
-\u8BF7\u5224\u65AD:\u54EA\u4E9B\u8BE5\u5199 skill(\u81EA\u52A8\u5316)?\u6311 1-2 \u4E2A\u6700\u9891\u7E41\u7684,\u751F\u6210 SKILL.md \u8349\u7A3F\u6307\u4EE4\u3002
-- description \u8BF4\u660E"\u4F55\u65F6\u7528"(\u8BA9 AI \u81EA\u51B3\u89E6\u53D1)
-- body \u542B\u8BE5\u547D\u4EE4/\u5DE5\u4F5C\u6D41(\u81EA\u52A8\u5316)
-- **\u542B test cases(Happy/Edge/Error 3 \u573A\u666F)**(\u7ED9\u4EBA\u5BA1\u9A8C)
-- \u4E0D\u8981\u63D0\u8BAE\u5DF2\u88C5 skill \u91CD\u590D\u7684`;
-  const system = "\u4F60\u662F skill \u67B6\u6784\u5E08\u3002\u4ECE\u91CD\u590D\u547D\u4EE4/\u5DE5\u4F5C\u6D41\u5224\u65AD\u8BE5\u4E0D\u8BE5\u5199 skill,\u907F\u514D\u91CD\u590D\u5DF2\u88C5\u7684\u3002\u8F93\u51FA\u542B test cases \u7684\u6539\u8FDB\u6307\u4EE4(\u7ED9\u4EBA\u5BA1,\u4E0D\u81EA\u52A8\u521B\u5EFA)\u3002";
-  const llmResult = await llmAnalyze(llmPrompt, system);
-  const lines = [];
-  lines.push("# inspire:\u4F60\u53CD\u590D\u8DD1\u7684\u547D\u4EE4 + \u5DE5\u4F5C\u6D41(\u5EFA\u8BAE\u5199 skill \u81EA\u52A8\u5316)");
-  lines.push("");
-  lines.push("## Bash \u9AA8\u67B6\u5019\u9009(\u6B63\u5219\u7C97\u7B5B \u22653)");
-  if (cmdCandidates.length > 0) {
-    for (const [sk, info] of cmdCandidates) lines.push(`- ${sk}(${info.count} \u6B21)`);
-  } else {
-    lines.push("(\u65E0)");
-  }
-  lines.push("");
-  lines.push("## tool \u5E8F\u5217\u5019\u9009(all tools,\u5DE5\u4F5C\u6D41 \u22653)");
-  if (seqCandidates.length > 0) {
-    for (const [seq, count] of seqCandidates) lines.push(`- ${seq}(${count} \u6B21)`);
-  } else {
-    lines.push("(\u65E0)");
-  }
-  lines.push("");
-  lines.push("## \u5DF2\u88C5 skill(OBSERVE,\u907F\u514D\u91CD\u590D)");
-  if (installed.length > 0) {
-    for (const s of installed) lines.push(`- ${s}`);
-  } else {
-    lines.push("(\u65E0)");
-  }
-  lines.push("");
-  if (llmResult) {
-    lines.push("## LLM \u7CBE\u63D0(\u542B test cases \u6307\u4EE4,\u4EBA\u5BA1)");
-    lines.push(llmResult);
-  } else {
-    lines.push("## \u6539\u8FDB\u6307\u4EE4(\u7ED9 AI,\u65E0 LLM \u964D\u7EA7\u7EAF\u6B63\u5219)");
-    lines.push("\u8BF7\u57FA\u4E8E\u4EE5\u4E0A\u5019\u9009,\u6311 1-2 \u4E2A\u6700\u9891\u7E41\u7684,\u751F\u6210 SKILL.md \u8349\u7A3F:");
-    lines.push('- description \u8BF4\u660E"\u4F55\u65F6\u7528"');
-    lines.push("- body \u542B\u8BE5\u547D\u4EE4/\u5DE5\u4F5C\u6D41");
-    lines.push("- **\u542B test cases(Happy/Edge/Error)**");
-    lines.push("- \u4E0D\u8981\u63D0\u8BAE\u5DF2\u88C5 skill \u91CD\u590D\u7684");
-  }
-  lines.push("");
-  lines.push("\u751F\u6210\u8349\u7A3F,\u6211\u5BA1\u8FC7\u540E\u4E22\u8FDB .claude/skills/(\u4E0D\u81EA\u52A8\u521B\u5EFA)\u3002");
-  return lines.join("\n");
+  const candidates = [...skeletonCount.entries()].filter(([, info]) => info.count >= 3).sort((a, b) => b[1].count - a[1].count).map(([skeleton, info]) => ({ skeleton, count: info.count, examples: info.examples }));
+  const tool_sequences = [...seqCount.entries()].filter(([seq, count]) => count >= 3 && !isSeqNoise(seq)).sort((a, b) => b[1] - a[1]).slice(0, 10).map(([sequence, count]) => ({ sequence, count }));
+  return { candidates, tool_sequences };
 }
 
 // package.json
 var package_default = {
   name: "left-skills",
-  version: "0.7.0",
+  version: "0.9.0",
   description: "\u7ED9 AI \u7528\u7684 skill \u751F\u547D\u5468\u671F\u7BA1\u7406\u5DE5\u5177 \u2014 MVP: skill \u8C03\u7528\u4F7F\u7528\u7EDF\u8BA1",
   bin: {
     "left-skills": "./dist/cli.js"
@@ -7223,7 +7089,7 @@ var package_default = {
 
 // src/cli.ts
 var program2 = new Command();
-program2.name("left-skills").description("\u7ED9 AI \u7528\u7684 skill \u751F\u547D\u5468\u671F\u7BA1\u7406\u5DE5\u5177 \u2014 skill \u8C03\u7528\u4F7F\u7528\u7EDF\u8BA1").version(package_default.version);
+program2.name("left-skills").description("\u7ED9 AI \u7528\u7684 skill \u751F\u547D\u5468\u671F\u7BA1\u7406\u5DE5\u5177(\u6570\u636E\u5DE5\u5177\u7BB1,skill \u5165\u53E3 + AI \u5206\u6790)").version(package_default.version);
 program2.command("usage").description("skill \u8C03\u7528\u4F7F\u7528\u62A5\u544A").option("--json", "\u8F93\u51FA JSON(AI \u7528)").option("--since <days>", "\u65F6\u95F4\u7A97\u53E3(\u5929,\u9ED8\u8BA4 30)", "30").action((opts) => {
   const since = parseInt(opts.since, 10) || 30;
   const report = buildReport(since);
@@ -7233,18 +7099,34 @@ program2.command("usage").description("skill \u8C03\u7528\u4F7F\u7528\u62A5\u544
     console.log(formatHuman(report));
   }
 });
-program2.command("lint").description("\u9759\u6001\u8D28\u91CF\u68C0\u67E5 SKILL.md(\u5BF9\u9F50 skills-ref + \u8865\u6DF1\u5EA6,0-100 \u5206)").action(() => {
-  const results = lintAll();
-  console.log(formatLintHuman(results));
+program2.command("scan").description("\u626B\u4F1A\u8BDD\u627E\u91CD\u590D Bash \u547D\u4EE4 + tool \u5E8F\u5217(\u6570\u636E\u91C7\u96C6,\u4E0D LLM)").option("--json", "\u8F93\u51FA JSON(AI \u7528)").option("--since <days>", "\u65F6\u95F4\u7A97\u53E3(\u5929,\u9ED8\u8BA4 30)", "30").action((opts) => {
+  const since = parseInt(opts.since, 10) || 30;
+  const result = scan(since);
+  if (opts.json) {
+    console.log(JSON.stringify(result));
+  } else {
+    console.log(`scan \u62A5\u544A(${result.candidates.length} \u5019\u9009 + ${result.tool_sequences.length} \u5E8F\u5217)`);
+    for (const c of result.candidates) console.log(`  ${c.count}  ${c.skeleton}`);
+    for (const s of result.tool_sequences) console.log(`  ${s.count}  ${s.sequence}`);
+  }
 });
-program2.command("evolve <skill>").description("\u6536\u96C6 usage+lint \u4FE1\u53F7,\u8F93\u51FA\u6539\u8FDB prompt(\u7ED9 AI,\u4EBA\u5BA1,\u4E0D\u81EA\u52A8\u6539)").action((skill) => {
-  console.log(evolvePrompt(skill));
+program2.command("list-skills").description("\u5217\u5DF2\u88C5 skill(.claude/skills + .codex/skills)").option("--json", "\u8F93\u51FA JSON(AI \u7528)").action((opts) => {
+  const skills = listInstalledSkills();
+  if (opts.json) {
+    console.log(JSON.stringify({ skills }));
+  } else {
+    for (const s of skills) console.log(s);
+  }
 });
-program2.command("inspire").description("\u626B\u4F1A\u8BDD\u627E\u91CD\u590D\u547D\u4EE4,\u63D0\u8BAE\u5199 skill(hybrid \u6B63\u5219+LLM,\u7ED9 AI,\u4EBA\u5BA1,\u4E0D\u81EA\u52A8\u521B\u5EFA)").option("--since <days>", "\u65F6\u95F4\u7A97\u53E3(\u5929,\u9ED8\u8BA4 30)", "30").action(async (opts) => {
-  const since = parseInt(opts.since, 10) || 30;
-  console.log(await inspirePrompt(since));
+program2.command("lint").description("\u9759\u6001\u8D28\u91CF\u68C0\u67E5 SKILL.md(0-100 \u5206)").option("--json", "\u8F93\u51FA JSON(AI \u7528)").action((opts) => {
+  const results = lintAll();
+  if (opts.json) {
+    console.log(formatLintJson(results));
+  } else {
+    console.log(formatLintHuman(results));
+  }
 });
-program2.command("report").description("\u5BFC\u51FA usage \u62A5\u544A markdown(\u53EF > report.md \u5206\u4EAB)").option("--markdown", "\u8F93\u51FA markdown(\u9ED8\u8BA4\u5373 markdown)").option("--since <days>", "\u65F6\u95F4\u7A97\u53E3(\u5929,\u9ED8\u8BA4 30)", "30").action((opts) => {
+program2.command("report").description("\u5BFC\u51FA usage \u62A5\u544A markdown(\u53EF > report.md)").option("--markdown", "\u8F93\u51FA markdown(\u9ED8\u8BA4)").option("--since <days>", "\u65F6\u95F4\u7A97\u53E3(\u5929,\u9ED8\u8BA4 30)", "30").action((opts) => {
   const since = parseInt(opts.since, 10) || 30;
   const report = buildReport(since);
   console.log(formatMarkdown(report));
@@ -7257,22 +7139,23 @@ program2.command("doctor").description("\u8BCA\u65AD left-skills \u5B89\u88C5/ho
     if (r.fix) console.log(`    \u2192 \u4FEE\u590D: ${r.fix}`);
   }
 });
-program2.command("install").description("\u8F93\u51FA hook \u914D\u7F6E\u7247\u6BB5(\u9ED8\u8BA4)\u6216 --write \u81EA\u52A8\u5199\u8FDB ~/.claude/settings.json(\u5408\u5E76+\u5907\u4EFD .bak)").option("--write", "\u81EA\u52A8\u5199 hook \u5230 settings.json(\u5408\u5E76\u53BB\u91CD + \u5907\u4EFD .bak)", false).action((opts) => {
+program2.command("install").description("\u8F93\u51FA hook \u7247\u6BB5(\u9ED8\u8BA4)\u6216 --write \u914D hook + \u653E SKILL.md").option("--write", "\u81EA\u52A8\u5199 hook + \u653E SKILL.md(\u5907\u4EFD .bak)", false).action((opts) => {
   if (opts.write) {
     const path = globalSettingsPath();
     writeHooksToSettings(path);
-    console.log(`\u2713 hook \u5DF2\u5199\u5165 ${path}(\u5DF2\u5907\u4EFD .bak)`);
-    console.log("  \u6253 /skill \u6216 AI \u8C03 skill \u4F1A\u81EA\u52A8\u8BB0\u5F55,\u8DD1 left-skills usage \u770B\u62A5\u544A");
+    writeSkillWrapper();
+    console.log(`\u2713 hook \u5DF2\u5199\u5165 ${path}(\u5907\u4EFD .bak)`);
+    console.log(`\u2713 SKILL.md \u5DF2\u653E ~/.claude/skills/left-skills/(/left-skills slash \u89E6\u53D1)`);
   } else {
     console.log(JSON.stringify(hookSnippet(), null, 2));
-    console.log("\n# \u628A\u4E0A\u9762\u7247\u6BB5\u52A0\u8FDB ~/.claude/settings.json \u7684 hooks \u5B57\u6BB5,\u6216\u8DD1 left-skills install --write \u81EA\u52A8\u5199");
   }
 });
-program2.command("uninstall").description("\u5220 ~/.claude/settings.json \u7684 left-skills hook(\u5E72\u51C0\u5378\u8F7D,\u5907\u4EFD .bak)").action(() => {
+program2.command("uninstall").description("\u5220 hook + SKILL.md(\u5E72\u51C0\u5378\u8F7D)").action(() => {
   const path = globalSettingsPath();
   removeHooksFromSettings(path);
-  console.log(`\u2713 left-skills hook \u5DF2\u4ECE ${path} \u5220\u9664(\u5DF2\u5907\u4EFD .bak)`);
-  console.log("  \u518D\u8DD1 npm uninstall -g left-skills \u5378\u8F7D binary");
+  removeSkillWrapper();
+  console.log(`\u2713 hook \u5DF2\u5220 ${path}(\u5907\u4EFD .bak)`);
+  console.log(`\u2713 SKILL.md \u5DF2\u5220`);
 });
 program2.command("hook <event>").description("hook \u5165\u53E3(\u8BFB stdin payload)").action(async (event) => {
   const payload = await readStdinPayload();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "left-skills",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "给 AI 用的 skill 生命周期管理工具 — MVP: skill 调用使用统计",
   "bin": {
     "left-skills": "./dist/cli.js"