left-skills 0.2.0 → 0.3.0

package/README.md

@@ -56,6 +56,8 @@ npm uninstall -g left-skills    # remove binary
 left-skills usage            # human-readable report
 left-skills usage --json     # for AI (JSON)
 left-skills usage --since 7  # last 7 days
+left-skills doctor           # diagnose install (✓/✗ + fix)
+left-skills report --markdown > report.md  # export report
 ```
 
 Example:

package/README.zh.md

@@ -56,6 +56,8 @@ npm uninstall -g left-skills    # 卸 binary
 left-skills usage            # 人看报告
 left-skills usage --json     # AI 用(JSON)
 left-skills usage --since 7  # 近 7 天
+left-skills doctor           # 诊断安装(✓/✗ + 建议)
+left-skills report --markdown > report.md  # 导出报告
 ```
 
 报告示例:

package/dist/cli.js

@@ -3201,6 +3201,22 @@ function relativeTime(iso) {
   if (days === 1) return "1 \u5929\u524D";
   return `${days} \u5929\u524D`;
 }
+function formatMarkdown(report) {
+  const lines = [];
+  lines.push(`# left-skills usage report`);
+  lines.push("");
+  lines.push(`Generated: ${report.generated_at}  |  Skills: ${report.skills.length}`);
+  lines.push("");
+  lines.push("| skill | manual | AI | mention | total | last |");
+  lines.push("|---|---|---|---|---|---|");
+  for (const s of report.skills) {
+    const total = s.manual + s.ai + s.mention;
+    const last = s.last_used ? relativeTime(s.last_used) : "-";
+    const mark = total === 0 ? " \u26A0" : "";
+    lines.push(`| ${s.name}${mark} | ${s.manual} | ${s.ai} | ${s.mention} | ${total} | ${last} |`);
+  }
+  return lines.join("\n");
+}
 
 // src/install.ts
 var import_node_fs3 = require("fs");
@@ -3272,10 +3288,64 @@ function globalSettingsPath() {
   return (0, import_node_path3.join)((0, import_node_os3.homedir)(), ".claude", "settings.json");
 }
 
+// src/doctor.ts
+var import_node_fs4 = require("fs");
+var import_node_os4 = require("os");
+var import_node_path4 = require("path");
+var import_node_child_process = require("child_process");
+function checkBinary() {
+  try {
+    const path = (0, import_node_child_process.execSync)("which left-skills", { encoding: "utf-8" }).trim();
+    return { name: "binary in PATH", ok: true, detail: path };
+  } catch {
+    return { name: "binary in PATH", ok: false, detail: "left-skills \u547D\u4EE4\u627E\u4E0D\u5230", fix: "npm i -g left-skills" };
+  }
+}
+function checkHook() {
+  const settingsPath = (0, import_node_path4.join)((0, import_node_os4.homedir)(), ".claude", "settings.json");
+  if (!(0, import_node_fs4.existsSync)(settingsPath)) {
+    return { name: "hook in settings", ok: false, detail: "~/.claude/settings.json \u4E0D\u5B58\u5728", fix: "left-skills install --write" };
+  }
+  try {
+    const settings = JSON.parse((0, import_node_fs4.readFileSync)(settingsPath, "utf-8"));
+    const hooks = settings.hooks || {};
+    const hasLeft = Object.values(hooks).some(
+      (entries) => entries.some((e) => (e.hooks || []).some((h) => h.command && h.command.includes("left-skills")))
+    );
+    return hasLeft ? { name: "hook in settings", ok: true, detail: "~/.claude/settings.json \u6709 left-skills hook" } : { name: "hook in settings", ok: false, detail: "settings.json \u65E0 left-skills hook", fix: "left-skills install --write" };
+  } catch {
+    return { name: "hook in settings", ok: false, detail: "settings.json \u89E3\u6790\u5931\u8D25", fix: "\u68C0\u67E5 ~/.claude/settings.json JSON" };
+  }
+}
+function checkUsageFile() {
+  const usagePath = (0, import_node_path4.join)((0, import_node_os4.homedir)(), ".left-skills", "usage.json");
+  return (0, import_node_fs4.existsSync)(usagePath) ? { name: "usage.json", ok: true, detail: "~/.left-skills/usage.json \u5B58\u5728" } : { name: "usage.json", ok: false, detail: "~/.left-skills/usage.json \u4E0D\u5B58\u5728(\u9996\u6B21\u7528\u540E\u521B\u5EFA)", fix: "\u6253 /skill \u6216 AI \u8C03 skill \u89E6\u53D1 hook \u8BB0\u5F55" };
+}
+function checkHookCanRun() {
+  try {
+    (0, import_node_child_process.execSync)('echo "{}" | left-skills hook UserPromptExpansion', { encoding: "utf-8", stdio: "pipe" });
+    return { name: "hook command runs", ok: true, detail: "left-skills hook \u80FD\u6267\u884C" };
+  } catch {
+    return { name: "hook command runs", ok: false, detail: "left-skills hook \u547D\u4EE4\u6267\u884C\u5931\u8D25", fix: "\u68C0\u67E5 left-skills binary / node" };
+  }
+}
+function checkNodeVersion() {
+  try {
+    const ver = (0, import_node_child_process.execSync)("node --version", { encoding: "utf-8" }).trim();
+    const major = parseInt(ver.slice(1).split(".")[0], 10);
+    return major >= 18 ? { name: "node version", ok: true, detail: `${ver} (\u226518)` } : { name: "node version", ok: false, detail: `${ver} (<18)`, fix: "\u5347\u7EA7 node \u5230 18+" };
+  } catch {
+    return { name: "node version", ok: false, detail: "node \u547D\u4EE4\u627E\u4E0D\u5230", fix: "\u88C5 node 18+" };
+  }
+}
+function runDoctor() {
+  return [checkBinary(), checkHook(), checkUsageFile(), checkHookCanRun(), checkNodeVersion()];
+}
+
 // package.json
 var package_default = {
   name: "left-skills",
-  version: "0.2.0",
+  version: "0.3.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"
@@ -3329,6 +3399,19 @@ program2.command("usage").description("skill \u8C03\u7528\u4F7F\u7528\u62A5\u544
     console.log(formatHuman(report));
   }
 });
+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) => {
+  const since = parseInt(opts.since, 10) || 30;
+  const report = buildReport(since);
+  console.log(formatMarkdown(report));
+});
+program2.command("doctor").description("\u8BCA\u65AD left-skills \u5B89\u88C5/hook \u914D\u7F6E(\u2713/\u2717 + \u4FEE\u590D\u5EFA\u8BAE)").action(() => {
+  const results = runDoctor();
+  for (const r of results) {
+    const mark = r.ok ? "\u2713" : "\u2717";
+    console.log(`${mark} ${r.name}: ${r.detail}`);
+    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) => {
   if (opts.write) {
     const path = globalSettingsPath();

package/package.json

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