left-skills 0.4.0 → 0.5.0

package/README.md

@@ -57,6 +57,7 @@ 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 doctor           # diagnose install (✓/✗ + fix)
 left-skills report --markdown > report.md  # export report
 ```

package/dist/cli.js

@@ -6918,10 +6918,83 @@ 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");
+}
+
 // package.json
 var package_default = {
   name: "left-skills",
-  version: "0.4.0",
+  version: "0.5.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"
@@ -6979,6 +7052,9 @@ 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("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.5.0",
   "description": "给 AI 用的 skill 生命周期管理工具 — MVP: skill 调用使用统计",
   "bin": {
     "left-skills": "./dist/cli.js"