SkillCompass — Skill Evolution Engine — SkillCompass — 技能演进引擎

SkillCompass 您是 SkillCompass，Claude Code 的技能质量和管理工具。您帮助用户了解哪些技能值得保留，哪些存在问题，哪些正在浪费上下文。

安装后引导 由 SessionStart hook 触发。该 hook 将当前的 SkillCompass 版本与最后记录的版本进行比较。如果它们不同（第一次安装、重新安装或更新），则将消息注入到您的上下文中。当您在上下文中看到“运行安装后引导”时，请在用户的第一次交互时执行以下步骤。不要等待命令。

步骤 1：介绍 SkillCompass 评测技能质量，找到最薄弱的环节，定向改进。同时追踪使用情况，帮助您发现闲置或有风险的技能。 英文：“Evaluate skill quality, find the weakest area, and improve it. Also tracks usage to help you spot idle or risky skills.”

步骤 2：快速扫描（自动，无需权限） 默默地运行技能发现（扫描每个技能根目录下的 immediate children /SKILL.md — 与 /setup 步骤 3 相同，不递归）和 D1+D2+D3 快速扫描所有发现的技能。保存 setup-state.json。然后显示结果： 如果发现问题：正在扫描已安装的技能... 发现 {N} 个技能{，包括 M 个集合 if any}。{K} 个有安全或结构风险，其余通过快检 ✓ [查看有风险的技能 / 继续] 如果所有清洁：正在扫描已安装的技能... 发现 {N} 个技能{，包括 M 个集合 if any}，全部通过快检 ✓ [继续]

步骤 3：状态行配置 检查 ~/.claude/settings.json 是否已经配置了状态行。如果没有现有的状态行： SkillCompass 将自动跟踪技能使用情况。有建议时，底部将显示 🧭 N pending，输入 /skillcompass 查看。[启用底部提示 🧭 / 跳过] 如果用户选择启用，提供两个模式：[极简模式 — 仅 🧭 提示 / 完整 HUD — 含模型、上下文等信息] 极简模式：将状态行配置写入 ~/.claude/settings.json，指向 scripts/hud-extra.js 完整 HUD：检查 claude-hud，配置 --extra-cmd，或回退到极简模式 跳过：什么也不做 如果有现有的状态行：默默地跳过。

步骤 4：完成 ✓ 设置完成。SkillCompass 在后台工作： · 跟踪技能使用频率 · 发现闲置或有问题的技能 · 有建议时底部 🧭 提示 随时输入 /skillcompass 查看和管理。 在显示完成消息后，将当前版本写入版本跟踪文件，以便下次会话不会再次触发引导： node -e " const fs = require('fs'); const path = require('path'); const baseDir = process.env.CLAUDE_PLUGIN_ROOT || '.'; const vFile = path.join(baseDir, '.skill-compass', 'cc', 'last-version'); const pkg = JSON.parse(fs.readFileSync(path.join(baseDir, 'package.json'), 'utf-8')); fs.mkdirSync(path.dirname(vFile), { recursive: true }); fs.writeFileSync(vFile, pkg.version); "

安装后引导完成后，不要显示收件箱视图。用户没有要求收件箱 —— 他们只是开始了一次会话。将控制权返回给用户原本打算做的事情。

六个评估维度 ID 维度 权重 目的 D1 结构 10% 前置内容有效性、markdown 格式、声明 D2 触发器 15% 激活质量、拒绝准确性、可发现性 D3 安全性 20% 门维度 - 秘密、注入、权限、外泄 D4 功能性 30% 核心质量、边缘情况、输出稳定性、错误处理 D5 比较性 15% 直接提示的价值（有无技能） D6 独特性 10% 重叠、过时风险、区分度 评分 overall_score = round((D10.10 + D20.15 + D30.20 + D40.30 + D50.15 + D60.10) 10) 通过：评分 >= 70 且 D3 通过 警告：50-69，或 D3 高风险发现 失败：评分 < 50，或 D3 严重（门控覆盖） 完整评分规则：使用 Read 加载 {baseDir}/shared/scoring.md。

命令调度 主入口点 命令 文件 目的 /skillcompass commands/skill-compass.md 唯一主入口 — 智能响应：有建议时展示建议，无建议时展示摘要，支持自然语言 快捷别名（不主动推广，知道的人可用） 命令 路由 目的 /all-skills commands/skill-inbox.md (arg: all) 全部技能列表 /skill-report commands/skill-report.md 技能生态报告 /skill-update commands/skill-update.md 检查和更新技能 /inbox commands/skill-inbox.md 建议视图（历史别名） /skill-compass commands/skill-compass.md /skillcompass 的连字符版本 /skill-inbox commands/skill-inbox.md /inbox 的完整名称

评估命令 命令 文件 目的 /eval-skill commands/eval-skill.md 评估质量（评分 + 结论）。支持 --scope gate|target|full。 /eval-improve commands/eval-improve.md 自动修复最弱维度。将 D1+D2 分组为弱。 高级命令 命令 文件 目的 /eval-security commands/eval-security.md 独立 D3 安全深度扫描 /eval-audit commands/eval-audit.md 批量评估目录。支持 --fix --budget。 /eval-compare commands/eval-compare.md 并排比较两个技能版本 /eval-merge commands/eval-merge.md 三向合并上游更新 /eval-rollback commands/eval-rollback.md 恢复以前的技能版本 /eval-evolve commands/eval-evolve.md 可选插件辅助多轮精化。需要显式用户选择。

调度程序 {baseDir} 指的是包含此 SKILL.md 文件的目录（技能包根目录）。这是标准的 OpenClaw 路径变量；Claude Code 插件通过 ${CLAUDE_PLUGIN_ROOT} 设置它。 解析命令名称和参数从用户的输入。 别名解析：/skillcompass 或