opencode-skills-doctor 0.7.0 → 0.8.1

package/README.md

@@ -117,6 +117,7 @@ All commands accept `--json`, `--lang en|zh`, `--budget`, `--root` and `--no-glo
 | **Claude Code / Codex** | MCP server (`npx -y opencode-skills-doctor mcp`) |
 | **Grok CLI / Cursor** | their skill roots are scanned natively |
 | **Hermes Agent** | MCP entry in `~/.hermes/config.yaml`; `~/.hermes/skills` is scanned |
+| **Kimi Code** | `install --client kimi` writes `~/.kimi-code/mcp.json` + the audit skill |
 
 ## Why it is safe
 

package/docs/README.zh-CN.md

@@ -438,6 +438,16 @@ mcp_servers:
 
 Hermes 的工具命名是 `mcp_<server>_<tool>`，即 `mcp_skills_doctor_skills_doctor`。它的 skill 在 `~/.hermes/skills`（含导入的 `openclaw-imports/`）和项目 `.hermes/skills`，`check` 都会扫描。
 
+### Kimi Code（Moonshot）
+
+一条命令写入 MCP 配置和审计 skill：
+
+```powershell
+npx -y opencode-skills-doctor install --client kimi
+```
+
+它会把 `skills-doctor` 合并进 `~/.kimi-code/mcp.json`（或 `$KIMI_CODE_HOME/mcp.json`），并把 skill 复制到 `$KIMI_CODE_HOME/skills/`。之后开新的 Kimi Code 会话即可，工具名是 `mcp__skills_doctor__skills_doctor`。`check` 也会扫描 `~/.kimi-code/skills` 和项目 `.kimi-code/skills`；`uninstall --client kimi` 反向撤销。
+
 ## 检测规则
 
 | 规则 | 级别 | 含义 |

package/docs/REFERENCE.md

@@ -10,7 +10,7 @@ Local scanner, linter, fixer, updater and **OpenCode plugin** for agent skills
 |---|---|
 | **What it is** | Audit, fix and update the skills your coding agent loads |
 | **Interfaces** | CLI · OpenCode plugin (1.x / 2.x) · MCP server (Claude Code, Codex, DSH, …) · Grok CLI compatible |
-| **Skill sources** | `.opencode/skills`, `.claude/skills`, `.agents/skills`, `.grok/skills`, `.cursor/skills`, `.hermes/skills`, `opencode.json(c)` entries, HTTP catalogs |
+| **Skill sources** | `.opencode/skills`, `.claude/skills`, `.agents/skills`, `.grok/skills`, `.cursor/skills`, `.hermes/skills`, `.kimi-code/skills`, `opencode.json(c)` entries, HTTP catalogs |
 | **What it finds** | shadowed IDs, duplicates, long descriptions, oversized bodies, per-step token budget, broken file references, invalid frontmatter, empty bodies, stale skills |
 | **What it fixes** | archives shadowed definitions (reversible), hides low-frequency skills, syncs catalogs with drift detection |
 | **Reports** | terminal, JSON, or a self-contained HTML report (`--html [file] --open`) |
@@ -421,6 +421,16 @@ mcp_servers:
 
 Hermes names tools `mcp_<server>_<tool>`, so the tool is `mcp_skills_doctor_skills_doctor`. Its skills live in `~/.hermes/skills` (including imported `openclaw-imports/`) and project `.hermes/skills`; `check` scans both.
 
+### Kimi Code (Moonshot)
+
+One command writes the MCP entry and the audit skill:
+
+```powershell
+npx -y opencode-skills-doctor install --client kimi
+```
+
+It merges `skills-doctor` into `~/.kimi-code/mcp.json` (or `$KIMI_CODE_HOME/mcp.json`) and copies the skill to `$KIMI_CODE_HOME/skills/`. Start a new Kimi Code session afterwards; the tool is `mcp__skills_doctor__skills_doctor` (Kimi uses the same `mcp__<server>__<tool>` shape as Claude Code). `check` also scans `~/.kimi-code/skills` and project `.kimi-code/skills`; `uninstall --client kimi` reverses both.
+
 ## Rules
 
 | Rule | Level | Meaning |
@@ -466,9 +476,11 @@ Hermes names tools `mcp_<server>_<tool>`, so the tool is `mcp_skills_doctor_skil
 8. project `.grok/skills`
 9. `~/.hermes/skills`
 10. project `.hermes/skills`
-11. `~/.config/opencode/skills`
-12. project `.opencode/skills`
-13. the `skills` array in `opencode.json(c)` (2.x) or `skills.paths` (1.x); relative paths resolve from the working directory; supports `~/`, absolute paths and HTTP catalogs
+11. `~/.kimi-code/skills`
+12. project `.kimi-code/skills`
+13. `~/.config/opencode/skills`
+14. project `.opencode/skills`
+15. the `skills` array in `opencode.json(c)` (2.x) or `skills.paths` (1.x); relative paths resolve from the working directory; supports `~/`, absolute paths and HTTP catalogs
 
 ## JSON output
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-doctor",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Audit, fix and update agent skills: token cost, broken references, shadowed duplicates, HTML reports, catalog sync. CLI, OpenCode plugin, MCP server; works with OpenCode, Claude Code, Codex, Grok CLI, Cursor and DeepSeek Harness.",
   "type": "module",
   "exports": {
@@ -8,7 +8,8 @@
     "./plugin": "./src/plugin.mjs",
     "./server": "./src/plugin-v1.mjs",
     "./v1": "./src/plugin-v1.mjs",
-    "./audit": "./src/audit.mjs"
+    "./audit": "./src/audit.mjs",
+    "./cli": "./src/cli.mjs"
   },
   "bin": {
     "skills-doctor": "./bin/skills-doctor.mjs"

package/src/audit.mjs

@@ -16,13 +16,14 @@ export function auditSkills({
   configPath = null,
   budget = null,
   staleDays = null,
+  extraDirs = [],
 } = {}) {
   const loaded = loadConfig(cwd, configPath)
   const config = loaded.config
   const resolvedLang = normalizeLang(lang) ?? normalizeLang(config.lang) ?? detectLang()
   const t = translator(resolvedLang)
 
-  const discovered = scanAll(discoverSources({ cwd, includeGlobal }))
+  const discovered = scanAll(discoverSources({ cwd, includeGlobal, extraDirs }))
   const managedInfo = inspectManaged(discovered.scans, { t })
 
   const effectiveBudget = Number.isFinite(budget) && budget > 0 ? budget : config.budget ?? 1200

package/src/cli.mjs

@@ -10,6 +10,7 @@ import { loadConfig } from "./config.mjs"
 import { startMcpServer } from "./mcp.mjs"
 import { installOpenCode, uninstallOpenCode } from "./install.mjs"
 import { installDsh, uninstallDsh } from "./dsh.mjs"
+import { installKimi, uninstallKimi } from "./kimi.mjs"
 import { writeHtmlReport, openReport } from "./html.mjs"
 import { planBudget } from "./plan.mjs"
 import {
@@ -75,6 +76,8 @@ function parseArgs(argv) {
     client: "auto",
     profile: null,
     dshHome: null,
+    kimiHome: null,
+    extraDirs: [],
     configDir: null,
     noNpm: false,
     html: null,
@@ -162,6 +165,12 @@ function parseArgs(argv) {
       case "--dsh-home":
         options.dshHome = path.resolve(args[++i] ?? ".")
         break
+      case "--kimi-home":
+        options.kimiHome = path.resolve(args[++i] ?? ".")
+        break
+      case "--extra-dir":
+        options.extraDirs.push(path.resolve(args[++i] ?? "."))
+        break
       case "--no-npm":
         options.noNpm = true
         break
@@ -600,8 +609,8 @@ export async function main(argv) {
     process.exit(2)
   }
 
-  if (!["auto", "opencode", "desktop", "dsh"].includes(options.client)) {
-    console.error("unsupported --client: expected auto, opencode, desktop or dsh")
+  if (!["auto", "opencode", "desktop", "dsh", "kimi"].includes(options.client)) {
+    console.error("unsupported --client: expected auto, opencode, desktop, dsh or kimi")
     process.exitCode = 2
     return
   }
@@ -648,6 +657,25 @@ export async function main(argv) {
     return
   }
 
+  if (options.command === "install" && options.client === "kimi") {
+    const result = installKimi({ home: options.kimiHome ?? undefined, dryRun: options.dryRun })
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2))
+    } else {
+      console.log(bold(t("kimi.title")))
+      if (result.home) console.log(dim(t("kimi.home", { dir: result.home })))
+      if (result.mcpFile) console.log(dim(t("kimi.mcp", { file: result.mcpFile })))
+      if (result.skillDir) console.log(dim(t("kimi.skill", { dir: result.skillDir })))
+      if (result.dryRun) console.log(dim(t("install.dryRun")))
+      for (const action of result.actions) console.log(`  · ${action}`)
+      for (const error of result.errors) console.log(red(t("install.error", { error })))
+      console.log("")
+      console.log(result.errors.length ? red(t("kimi.failed")) : dim(t("kimi.restart")))
+    }
+    process.exitCode = result.errors.length ? 1 : 0
+    return
+  }
+
   if (options.command === "install") {
     const result = installOpenCode({
       configDir: options.configDir ?? undefined,
@@ -698,6 +726,23 @@ export async function main(argv) {
     return
   }
 
+  if (options.command === "uninstall" && options.client === "kimi") {
+    const result = uninstallKimi({ home: options.kimiHome ?? undefined, dryRun: options.dryRun })
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2))
+    } else {
+      console.log(bold(t("kimi.uninstallTitle")))
+      if (result.home) console.log(dim(t("kimi.home", { dir: result.home })))
+      if (result.dryRun) console.log(dim(t("install.dryRun")))
+      for (const action of result.actions) console.log(`  · ${action}`)
+      for (const error of result.errors) console.log(red(t("install.error", { error })))
+      console.log("")
+      console.log(result.errors.length ? red(t("kimi.failed")) : dim(t("kimi.restart")))
+    }
+    process.exitCode = result.errors.length ? 1 : 0
+    return
+  }
+
   if (options.command === "uninstall") {
     const result = uninstallOpenCode({
       configDir: options.configDir ?? undefined,
@@ -773,6 +818,7 @@ export async function main(argv) {
       configPath: options.config,
       budget: options.budget,
       staleDays: options.staleDays,
+      extraDirs: options.extraDirs,
     })
     const plan = planBudget(audit, { descTarget: options.descTarget, steps: options.steps })
     if (options.json) console.log(JSON.stringify(plan, null, 2))
@@ -788,6 +834,7 @@ export async function main(argv) {
       configPath: options.config,
       budget: options.budget,
       staleDays: options.staleDays,
+      extraDirs: options.extraDirs,
     })
     const result = buildCheckResult(audit, options)
 
@@ -814,7 +861,7 @@ export async function main(argv) {
     return
   }
 
-  const discovered = scanAll(discoverSources({ cwd, includeGlobal: options.global }))
+  const discovered = scanAll(discoverSources({ cwd, includeGlobal: options.global, extraDirs: options.extraDirs }))
   const managedInfo = inspectManaged(discovered.scans, { t })
 
   if (options.command === "scan") {
@@ -852,6 +899,7 @@ export async function main(argv) {
       configPath: options.config,
       budget: options.budget,
       staleDays: options.staleDays,
+      extraDirs: options.extraDirs,
     })
     process.exitCode = runFix(audit, options, t)
   }

package/src/discover.mjs

@@ -122,11 +122,13 @@ function isUnder(parent, child) {
  *  8. 项目 .grok/skills
  *  9. ~/.hermes/skills（Hermes Agent）
  * 10. 项目 .hermes/skills
- * 11. ~/.config/opencode/skills
- * 12. 项目 .opencode/skills（项目根 → cwd）
- * 13. opencode.json(c) 里的 skills 数组 / skills.paths
+ * 11. ~/.kimi-code/skills（Kimi Code）
+ * 12. 项目 .kimi-code/skills
+ * 13. ~/.config/opencode/skills
+ * 14. 项目 .opencode/skills（项目根 → cwd）
+ * 15. opencode.json(c) 里的 skills 数组 / skills.paths
  */
-export function discoverSources({ cwd = process.cwd(), home = os.homedir(), includeGlobal = true } = {}) {
+export function discoverSources({ cwd = process.cwd(), home = os.homedir(), includeGlobal = true, extraDirs = [] } = {}) {
   const projectRoot = findProjectRoot(cwd) ?? path.resolve(cwd)
   const projectChain = pathChain(projectRoot, cwd)
   const sources = []
@@ -156,9 +158,18 @@ export function discoverSources({ cwd = process.cwd(), home = os.homedir(), incl
   if (includeGlobal) addSource("hermes-global", "global", path.join(home, ".hermes", "skills"))
   for (const dir of projectChain) addSource("hermes-project", "project", path.join(dir, ".hermes", "skills"))
 
+  if (includeGlobal) addSource("kimi-global", "global", path.join(home, ".kimi-code", "skills"))
+  for (const dir of projectChain) addSource("kimi-project", "project", path.join(dir, ".kimi-code", "skills"))
+
   if (includeGlobal) addSource("opencode-global", "global", path.join(home, ".config", "opencode", "skills"))
   for (const dir of projectChain) addSource("opencode-project", "project", path.join(dir, ".opencode", "skills"))
 
+  for (const dir of extraDirs) {
+    if (typeof dir !== "string" || !dir.trim()) continue
+    const abs = path.resolve(dir)
+    if (fs.existsSync(abs)) addSource("extra", isUnder(projectRoot, abs) ? "project" : "global", abs)
+  }
+
   const configFiles = []
   if (includeGlobal) {
     for (const file of configCandidates(path.join(home, ".config", "opencode"))) {

package/src/i18n.mjs

@@ -36,9 +36,11 @@ Options:
   --html [file]        check: write a self-contained HTML report (default: skills-report.html)
   --open               check: open the HTML report after writing it
   --config-dir <dir>   install/uninstall: OpenCode config directory (default: ~/.config/opencode)
-  --client <name>      install/uninstall: auto | opencode | desktop | dsh (default auto)
+  --client <name>      install/uninstall: auto | opencode | desktop | dsh | kimi (default auto)
   --profile <name>     dsh: profile to install into (default: desktop, or the only one)
   --dsh-home <dir>     dsh: DSH home directory (default: ~/.dsh)
+  --kimi-home <dir>    kimi: Kimi Code home (default: ~/.kimi-code or $KIMI_CODE_HOME)
+  --extra-dir <dir>    scan an additional skill directory (repeatable; e.g. ~/.openclaw/skills)
   --no-npm             install/uninstall: do not run npm (1.x)
   --apply              upgrade: run npm install -g opencode-skills-doctor@latest
   --no-update-check    skip the automatic update check for this run
@@ -129,6 +131,13 @@ Exit codes: 0 ok; 1 errors (and warnings with --strict); 2 bad arguments or runt
     "dsh.skill": "  skill: {dir}",
     "dsh.restart": "Restart DSH to load the MCP tool (HMR reloads the patch when enabled; the skill updates live).",
     "dsh.failed": "DSH integration failed.",
+    "kimi.title": "Kimi Code integration",
+    "kimi.uninstallTitle": "Remove Kimi Code integration",
+    "kimi.home": "  home: {dir}",
+    "kimi.mcp": "  mcp: {file}",
+    "kimi.skill": "  skill: {dir}",
+    "kimi.restart": "Start a new Kimi Code session to load the MCP tool.",
+    "kimi.failed": "Kimi Code integration failed.",
     "update.toolAvailable":
       "  ! skills-doctor {latest} is available (you have {current}); update with: {cmd}  ·  {url}",
     "upgrade.title": "skills-doctor upgrade",
@@ -257,9 +266,11 @@ Exit codes: 0 ok; 1 errors (and warnings with --strict); 2 bad arguments or runt
   --html [file]       check: 生成自包含 HTML 报告（默认 skills-report.html）
   --open              check: 写完报告后用浏览器打开
   --config-dir <dir>  install/uninstall: OpenCode 配置目录（默认 ~/.config/opencode）
-  --client <name>     install/uninstall: auto | opencode | desktop | dsh（默认 auto）
+  --client <name>     install/uninstall: auto | opencode | desktop | dsh | kimi（默认 auto）
   --profile <name>    dsh: 安装到哪个 profile（默认 desktop，或唯一的一个）
   --dsh-home <dir>    dsh: DSH 主目录（默认 ~/.dsh）
+  --kimi-home <dir>   kimi: Kimi Code 主目录（默认 ~/.kimi-code 或 $KIMI_CODE_HOME）
+  --extra-dir <dir>   额外扫描一个 skill 目录（可重复；例如 ~/.openclaw/skills）
   --no-npm            install/uninstall: 不执行 npm（1.x）
   --apply             upgrade: 执行 npm install -g opencode-skills-doctor@latest
   --no-update-check   本次运行跳过自动更新检查
@@ -350,6 +361,13 @@ Exit codes: 0 ok; 1 errors (and warnings with --strict); 2 bad arguments or runt
     "dsh.skill": "  skill: {dir}",
     "dsh.restart": "重启 DSH 加载 MCP 工具（启用 HMR 时会自动重载 patch；skill 即时更新）。",
     "dsh.failed": "DSH 集成失败。",
+    "kimi.title": "Kimi Code 集成",
+    "kimi.uninstallTitle": "撤销 Kimi Code 集成",
+    "kimi.home": "  主目录: {dir}",
+    "kimi.mcp": "  mcp: {file}",
+    "kimi.skill": "  skill: {dir}",
+    "kimi.restart": "开一个新的 Kimi Code 会话加载 MCP 工具。",
+    "kimi.failed": "Kimi Code 集成失败。",
     "update.toolAvailable": "  ! skills-doctor 有新版本 {latest}（当前 {current}）；更新：{cmd}  ·  {url}",
     "upgrade.title": "skills-doctor 自更新",
     "upgrade.current": "  当前版本: {version}",

package/src/kimi.mjs

@@ -0,0 +1,121 @@
+import fs from "node:fs"
+import path from "node:path"
+import os from "node:os"
+import { fileURLToPath } from "node:url"
+
+export const SERVER_NAME = "skills-doctor"
+export const SKILL_NAME = "skills-doctor-audit"
+
+const ENTRY = { command: "npx", args: ["-y", "opencode-skills-doctor", "mcp"] }
+
+export function kimiHome(env = process.env) {
+  return env.KIMI_CODE_HOME || path.join(os.homedir(), ".kimi-code")
+}
+
+function skillSourceDir() {
+  return fileURLToPath(new URL("../skills/dsh-skills-doctor", import.meta.url))
+}
+
+function readJson(file) {
+  if (!fs.existsSync(file)) return {}
+  try {
+    return JSON.parse(fs.readFileSync(file, "utf8").replace(/^\uFEFF/, ""))
+  } catch {
+    return null
+  }
+}
+
+function copySkill(source, target, dryRun, act, dry) {
+  const file = path.join(source, "SKILL.md")
+  if (!fs.existsSync(file)) return false
+  const targetFile = path.join(target, "SKILL.md")
+  if (fs.existsSync(targetFile) && fs.readFileSync(targetFile, "utf8") === fs.readFileSync(file, "utf8")) {
+    act(`skill already up to date ${target}`)
+    return true
+  }
+  if (dryRun) {
+    dry(`install skill ${SKILL_NAME} into ${target}`)
+    return true
+  }
+  fs.mkdirSync(target, { recursive: true })
+  fs.copyFileSync(file, targetFile)
+  act(`wrote skill ${targetFile}`)
+  return true
+}
+
+function removeSkill(target, dryRun, act, dry) {
+  const file = path.join(target, "SKILL.md")
+  if (!fs.existsSync(file)) return false
+  if (!fs.readFileSync(file, "utf8").includes("Skill audit workflow")) {
+    act(`kept ${target} (not the generated skill)`)
+    return false
+  }
+  if (dryRun) {
+    dry(`delete skill ${target}`)
+    return true
+  }
+  fs.rmSync(target, { recursive: true, force: true })
+  act(`deleted skill ${target}`)
+  return true
+}
+
+export function installKimi({ home = kimiHome(), dryRun = false } = {}) {
+  const actions = []
+  const errors = []
+  const act = (message) => actions.push(message)
+  const dry = (message) => actions.push(`[dry-run] ${message}`)
+
+  const mcpFile = path.join(home, "mcp.json")
+  const skillDir = path.join(home, "skills", SKILL_NAME)
+
+  const config = readJson(mcpFile)
+  if (config === null) {
+    errors.push(`cannot parse ${mcpFile}`)
+    return { ok: false, home, mcpFile, skillDir, actions, errors, dryRun }
+  }
+  config.mcpServers = config.mcpServers && typeof config.mcpServers === "object" ? config.mcpServers : {}
+
+  const existing = config.mcpServers[SERVER_NAME]
+  const same = existing && existing.command === ENTRY.command && JSON.stringify(existing.args) === JSON.stringify(ENTRY.args)
+  if (same) {
+    act(`${SERVER_NAME} already present in ${mcpFile}`)
+  } else if (dryRun) {
+    dry(`add ${SERVER_NAME} to mcpServers in ${mcpFile}`)
+  } else {
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-")
+    if (fs.existsSync(mcpFile)) fs.copyFileSync(mcpFile, `${mcpFile}.bak-${stamp}`)
+    config.mcpServers[SERVER_NAME] = ENTRY
+    fs.mkdirSync(home, { recursive: true })
+    fs.writeFileSync(mcpFile, JSON.stringify(config, null, 2) + "\n", "utf8")
+    act(`wrote ${SERVER_NAME} to ${mcpFile}`)
+  }
+
+  copySkill(skillSourceDir(), skillDir, dryRun, act, dry)
+  return { ok: errors.length === 0, home, mcpFile, skillDir, actions, errors, dryRun }
+}
+
+export function uninstallKimi({ home = kimiHome(), dryRun = false } = {}) {
+  const actions = []
+  const errors = []
+  const act = (message) => actions.push(message)
+  const dry = (message) => actions.push(`[dry-run] ${message}`)
+
+  const mcpFile = path.join(home, "mcp.json")
+  const skillDir = path.join(home, "skills", SKILL_NAME)
+
+  const config = readJson(mcpFile)
+  if (config && config.mcpServers && config.mcpServers[SERVER_NAME]) {
+    if (dryRun) {
+      dry(`remove ${SERVER_NAME} from ${mcpFile}`)
+    } else {
+      const stamp = new Date().toISOString().replace(/[:.]/g, "-")
+      fs.copyFileSync(mcpFile, `${mcpFile}.bak-${stamp}`)
+      delete config.mcpServers[SERVER_NAME]
+      fs.writeFileSync(mcpFile, JSON.stringify(config, null, 2) + "\n", "utf8")
+      act(`removed ${SERVER_NAME} from ${mcpFile}`)
+    }
+  }
+
+  removeSkill(skillDir, dryRun, act, dry)
+  return { ok: errors.length === 0, home, mcpFile, skillDir, actions, errors, dryRun }
+}