left-skills 0.4.0 → 0.6.0

package/README.md

@@ -57,6 +57,8 @@ left-skills usage            # human-readable report
 left-skills usage --json     # for AI (JSON)
 left-skills usage --since 7  # last 7 days
 left-skills lint             # static quality check (0-100 score)
+left-skills evolve <skill>   # generate improvement prompt (for AI, human review)
+left-skills inspire          # find repeated commands → suggest new skill
 left-skills doctor           # diagnose install (✓/✗ + fix)
 left-skills report --markdown > report.md  # export report
 ```

package/dist/cli.js

@@ -6918,10 +6918,150 @@ function formatLintHuman(results) {
   return lines.join("\n");
 }
 
+// src/evolve.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_fs7 = require("fs");
+var import_node_path7 = require("path");
+var import_node_os7 = require("os");
+function scanSessions(sinceDays = 30) {
+  const projectsDir = (0, import_node_path7.join)((0, import_node_os7.homedir)(), ".claude", "projects");
+  const cmdCount = /* @__PURE__ */ new Map();
+  if (!(0, import_node_fs7.existsSync)(projectsDir)) return cmdCount;
+  const cutoff = Date.now() - sinceDays * 864e5;
+  for (const project of (0, import_node_fs7.readdirSync)(projectsDir, { withFileTypes: true })) {
+    if (!project.isDirectory()) continue;
+    const projectDir = (0, import_node_path7.join)(projectsDir, project.name);
+    for (const file of (0, import_node_fs7.readdirSync)(projectDir)) {
+      if (!file.endsWith(".jsonl")) continue;
+      const filePath = (0, import_node_path7.join)(projectDir, file);
+      try {
+        const content = (0, import_node_fs7.readFileSync)(filePath, "utf-8");
+        for (const line of content.split("\n")) {
+          if (!line.trim()) continue;
+          try {
+            const obj = JSON.parse(line);
+            const ts = obj.timestamp;
+            if (ts && new Date(ts).getTime() < cutoff) continue;
+            const msg = obj.message;
+            if (msg && msg.content && Array.isArray(msg.content)) {
+              for (const block of msg.content) {
+                if (block.type === "tool_use" && block.name === "Bash") {
+                  const cmd = block.input?.command;
+                  if (cmd && cmd.length >= 30) {
+                    cmdCount.set(cmd, (cmdCount.get(cmd) || 0) + 1);
+                  }
+                }
+              }
+            }
+          } catch {
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  return cmdCount;
+}
+function inspirePrompt(sinceDays = 30) {
+  const cmdCount = scanSessions(sinceDays);
+  const repeated = [...cmdCount.entries()].filter(([, count]) => count >= 3).sort((a, b) => b[1] - a[1]);
+  if (repeated.length === 0) {
+    return "\u65E0\u91CD\u590D\u6A21\u5F0F(\u957F\u547D\u4EE4 \u226530 \u5B57\u7B26,\u91CD\u590D \u22653 \u6B21),\u6682\u4E0D\u5EFA\u8BAE\u5199 skill\u3002\n(\u8BD5\u66F4\u591A\u5929?left-skills inspire --since 90)";
+  }
+  const lines = [];
+  lines.push("# inspire:\u4F60\u53CD\u590D\u8DD1\u7684\u547D\u4EE4(\u5EFA\u8BAE\u5199 skill \u81EA\u52A8\u5316)");
+  lines.push("");
+  lines.push("## \u91CD\u590D\u547D\u4EE4(\u957F\u547D\u4EE4 \u226530 \u5B57\u7B26,\u91CD\u590D \u22653 \u6B21)");
+  for (const [cmd, count] of repeated) {
+    lines.push(`- \`${cmd}\`(${count} \u6B21)`);
+  }
+  lines.push("");
+  lines.push("## \u6539\u8FDB\u6307\u4EE4(\u7ED9 AI)");
+  lines.push("\u8BF7\u57FA\u4E8E\u4EE5\u4E0A\u91CD\u590D\u547D\u4EE4,\u751F\u6210 SKILL.md \u8349\u7A3F:");
+  lines.push("- \u6311 1-2 \u4E2A\u6700\u9891\u7E41\u7684\u547D\u4EE4\u5E8F\u5217,\u8BBE\u8BA1 skill(name / description / body)");
+  lines.push('- description \u8BF4\u660E"\u4F55\u65F6\u7528"(\u8BA9 AI \u81EA\u51B3\u89E6\u53D1)');
+  lines.push("- body \u542B\u8BE5\u547D\u4EE4\u5E8F\u5217(\u81EA\u52A8\u5316)");
+  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");
+}
+
 // package.json
 var package_default = {
   name: "left-skills",
-  version: "0.4.0",
+  version: "0.6.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"
@@ -6965,7 +7105,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 MVP: 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 \u2014 skill \u8C03\u7528\u4F7F\u7528\u7EDF\u8BA1").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);
@@ -6979,6 +7119,13 @@ program2.command("lint").description("\u9759\u6001\u8D28\u91CF\u68C0\u67E5 SKILL
   const results = lintAll();
   console.log(formatLintHuman(results));
 });
+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("inspire").description("\u626B\u4F1A\u8BDD\u627E\u91CD\u590D\u547D\u4EE4,\u63D0\u8BAE\u5199 skill(\u7ED9 AI,\u4EBA\u5BA1,\u4E0D\u81EA\u52A8\u521B\u5EFA)").option("--since <days>", "\u65F6\u95F4\u7A97\u53E3(\u5929,\u9ED8\u8BA4 30)", "30").action((opts) => {
+  const since = parseInt(opts.since, 10) || 30;
+  console.log(inspirePrompt(since));
+});
 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);

package/package.json

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