opencode-skills-doctor 0.0.0-stage → 0.3.2

package/src/parse.mjs

@@ -0,0 +1,132 @@
+// 极简 frontmatter / YAML 子集解析 + 文本度量工具。
+// 只服务 skills 场景：name、description、metadata.opencode/autoinvoke、
+// disable-model-invocation 等，不追求完整 YAML。
+
+import { createHash } from "node:crypto"
+
+/** @param {string} text */
+export function parseFrontmatter(text) {
+  const empty = { data: {}, body: text, hasFrontmatter: false }
+  if (!text.startsWith("---")) return empty
+
+  const lines = text.split(/\r?\n/)
+  if (lines[0].trim() !== "---") return empty
+
+  let end = -1
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i].trim() === "---") {
+      end = i
+      break
+    }
+  }
+  if (end === -1) return empty
+
+  return {
+    data: parseYamlLite(lines.slice(1, end)),
+    body: lines.slice(end + 1).join("\n"),
+    hasFrontmatter: true,
+  }
+}
+
+function leadingSpaces(line) {
+  return line.length - line.replace(/^[ \t]*/, "").length
+}
+
+function coerce(value) {
+  const v = value.trim()
+  if (v === "true") return true
+  if (v === "false") return false
+  if (v === "null" || v === "~") return null
+  if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+    return v.slice(1, -1).replace(/\\"/g, '"')
+  }
+  return v
+}
+
+/** @param {string[]} lines */
+export function parseYamlLite(lines) {
+  const root = {}
+  const stack = [{ indent: -1, obj: root }]
+
+  for (let i = 0; i < lines.length; i++) {
+    const raw = lines[i]
+    if (!raw.trim() || raw.trim().startsWith("#")) continue
+
+    const indent = leadingSpaces(raw)
+    const content = raw.trim()
+
+    while (stack.length > 1 && indent <= stack[stack.length - 1].indent) stack.pop()
+    const parent = stack[stack.length - 1].obj
+
+    // key 不含冒号；value 可以含冒号（如 "Prepare: notes"）
+    const m = /^([^:#]+?)\s*:\s*(.*)$/.exec(content)
+    if (!m) continue
+    const key = m[1].trim()
+    const rest = m[2].trim()
+
+    if (rest === "") {
+      const child = {}
+      parent[key] = child
+      stack.push({ indent, obj: child })
+      continue
+    }
+
+    // 块标量：| 或 >
+    if (/^[|>][+-]?$/.test(rest)) {
+      const block = []
+      let j = i + 1
+      while (j < lines.length) {
+        const next = lines[j]
+        if (next.trim() === "") {
+          block.push("")
+          j++
+          continue
+        }
+        if (leadingSpaces(next) > indent) {
+          block.push(next)
+          j++
+        } else break
+      }
+      const nonEmpty = block.filter((l) => l.trim())
+      const minIndent = nonEmpty.length ? Math.min(...nonEmpty.map(leadingSpaces)) : 0
+      const joined = block.map((l) => l.slice(minIndent)).join("\n")
+      parent[key] = rest.startsWith(">") ? joined.replace(/\n+/g, " ").trim() : joined.trim()
+      i = j - 1
+      continue
+    }
+
+    parent[key] = coerce(rest)
+  }
+
+  return root
+}
+
+const CJK_CHAR = /[\u2e80-\u9fff\uac00-\ud7af\uf900-\ufaff\uff00-\uffef]/
+const CJK_ALL = /[\u2e80-\u9fff\uac00-\ud7af\uf900-\ufaff\uff00-\uffef]/g
+
+/** 粗略 token 估算：CJK 约 1.7 字/token，其余约 4 字符/token。 */
+export function estimateTokens(text) {
+  const str = String(text ?? "")
+  const cjk = (str.match(CJK_ALL) ?? []).length
+  return Math.ceil(cjk * 1.7 + (str.length - cjk) / 4)
+}
+
+/** 终端显示宽度（CJK 记 2 列） */
+export function displayWidth(text) {
+  let width = 0
+  for (const ch of String(text ?? "")) {
+    width += CJK_CHAR.test(ch) ? 2 : 1
+  }
+  return width
+}
+
+export function padDisplay(text, width) {
+  const str = String(text ?? "")
+  const diff = width - displayWidth(str)
+  return diff > 0 ? str + " ".repeat(diff) : str
+}
+
+/** @param {string} text */
+export function sha1(text) {
+  return createHash("sha1").update(text).digest("hex")
+}

package/src/plugin-v1.mjs

@@ -0,0 +1,31 @@
+import { tool } from "@opencode-ai/plugin"
+import { auditSkills, formatMarkdown } from "./audit.mjs"
+
+const z = tool.schema
+
+/**
+ * OpenCode 1.x 插件入口（V1 API：`server` 函数 + tool()）。
+ * 在 1.x 里通过 opencode.json 配置：
+ *   { "plugin": ["opencode-skills-doctor/v1"] }
+ * 2.x 请使用包根导出（V2 的 Plugin.define）。
+ */
+export const SkillsDoctorPlugin = async ({ directory }) => ({
+  tool: {
+    skills_doctor: tool({
+      description:
+        "Audit local OpenCode skills: duplicates, shadowing, context budget and fix hints. Returns a markdown report.",
+      args: z.object({
+        directory: z.string().optional().describe("Directory to audit (defaults to the current project)"),
+        budget: z.number().optional().describe("Description token budget (default 1200)"),
+      }),
+      execute: async (args) => {
+        const cwd = args.directory || directory || process.cwd()
+        const audit = auditSkills({ cwd, budget: typeof args.budget === "number" ? args.budget : null, lang: "en" })
+        return formatMarkdown(audit)
+      },
+    }),
+  },
+})
+
+export const server = SkillsDoctorPlugin
+export default { id: "skills-doctor", server: SkillsDoctorPlugin }

package/src/plugin.mjs

@@ -0,0 +1,52 @@
+import { Plugin } from "@opencode/plugin"
+import { auditSkills, formatMarkdown } from "./audit.mjs"
+
+/**
+ * OpenCode 插件入口：把 skills-doctor 暴露成 skills_doctor 工具和 /skills-doctor 命令。
+ * 通过 opencode.json(c) 加载：
+ *   { "plugins": ["opencode-skills-doctor"] }
+ * 或本地路径。
+ */
+export default Plugin.define({
+  id: "skills-doctor",
+
+  async setup(ctx) {
+    await ctx.tool.transform((editor) => {
+      editor.namespace({ name: "skills", description: "OpenCode skill diagnostics" })
+      editor.add({
+        name: "doctor",
+        description: "Audit local OpenCode skills: duplicates, shadowing, context budget and fix hints",
+        input: {
+          type: "object",
+          properties: {
+            directory: { type: "string", description: "Directory to audit (defaults to the current project)" },
+            budget: { type: "number", description: "Description token budget (default 1200)" },
+          },
+          additionalProperties: false,
+        },
+        options: { namespace: "skills", codemode: true },
+        execute: async (input) => {
+          const directory = (input && typeof input.directory === "string" && input.directory) || ctx.location.directory
+          const budget = input && typeof input.budget === "number" ? input.budget : null
+          const audit = auditSkills({ cwd: directory, budget, lang: "en" })
+          return { content: formatMarkdown(audit) }
+        },
+      })
+    })
+
+    await ctx.command.transform((editor) => {
+      editor.add({
+        name: "skills-doctor",
+        description: "Audit local OpenCode skills",
+        execute: async ({ sessionID, prompt, delivery }) => {
+          await ctx.session.prompt({
+            ...prompt,
+            sessionID,
+            text: "Run a skills audit with the skills_doctor tool, then summarize the top issues and propose concrete fixes.",
+            delivery,
+          })
+        },
+      })
+    })
+  },
+})