chore: import upstream snapshot with attribution

2026-07-13 13:01:18 +08:00
commit 979fb22d7c
613 changed files with 113494 additions and 0 deletions
@@ -0,0 +1,80 @@
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(HERE, "..", "..");
+const SKILLS = join(ROOT, "plugin", "skills");
+
+const errors: string[] = [];
+const MAX_LINES = 100;
+const DUP_MARKER = "/plugin list";
+
+function parseFrontmatter(text: string): Record<string, string> | null {
+  if (!text.startsWith("---")) return null;
+  const end = text.indexOf("\n---", 3);
+  if (end === -1) return null;
+  const body = text.slice(3, end);
+  const out: Record<string, string> = {};
+  for (const line of body.split("\n")) {
+    const m = /^([a-zA-Z_-]+):\s*(.*)$/.exec(line.trim());
+    if (m) out[m[1]] = m[2];
+  }
+  return out;
+}
+
+const dirs = readdirSync(SKILLS, { withFileTypes: true })
+  .filter((e) => e.isDirectory() && !e.name.startsWith("_"))
+  .map((e) => e.name);
+
+for (const name of dirs) {
+  const skillFile = join(SKILLS, name, "SKILL.md");
+  if (!existsSync(skillFile)) {
+    errors.push(`${name}: missing SKILL.md`);
+    continue;
+  }
+  const text = readFileSync(skillFile, "utf8");
+  const rel = `plugin/skills/${name}/SKILL.md`;
+
+  const fm = parseFrontmatter(text);
+  if (!fm) {
+    errors.push(`${rel}: missing or malformed frontmatter`);
+  } else {
+    if (!fm.name) errors.push(`${rel}: frontmatter missing 'name'`);
+    if (fm.name && fm.name !== name) errors.push(`${rel}: frontmatter name '${fm.name}' != dir '${name}'`);
+    if (!fm.description) errors.push(`${rel}: frontmatter missing 'description'`);
+    else {
+      if (!/use when/i.test(fm.description)) errors.push(`${rel}: description must contain a "Use when ..." trigger sentence`);
+      if (fm.description.length > 1024) errors.push(`${rel}: description exceeds 1024 chars`);
+    }
+  }
+
+  const lines = text.split("\n").length;
+  if (lines > MAX_LINES) errors.push(`${rel}: ${lines} lines (max ${MAX_LINES}); move detail into REFERENCE.md or EXAMPLES.md`);
+
+  const body = fm ? text.slice(text.indexOf("\n---", 3) + 4) : text;
+  if (body.includes(DUP_MARKER)) {
+    errors.push(`${rel}: inlines the shared troubleshooting block; reference ../_shared/TROUBLESHOOTING.md instead`);
+  }
+}
+
+if (!existsSync(join(SKILLS, "_shared", "TROUBLESHOOTING.md"))) {
+  errors.push(`_shared/TROUBLESHOOTING.md is missing`);
+}
+
+const pluginJson = join(ROOT, "plugin", "plugin.json");
+if (existsSync(pluginJson)) {
+  const desc = (JSON.parse(readFileSync(pluginJson, "utf8")).description as string) ?? "";
+  const m = /(\d+)\s+skills/.exec(desc);
+  if (!m) errors.push(`plugin/plugin.json: description should state the skill count as "N skills"`);
+  else if (Number(m[1]) !== dirs.length) {
+    errors.push(`plugin/plugin.json: description says ${m[1]} skills but ${dirs.length} skill dirs exist`);
+  }
+}
+
+if (errors.length) {
+  console.error("Skill lint failed:");
+  for (const e of errors) console.error(`  - ${e}`);
+  process.exit(1);
+}
+console.log(`Skill lint passed: ${dirs.length} skills checked.`);