friskeval

技能目录的路由 linter —— 在你发布技能之前，捕获冲突和 scope overclaim。

🇺🇸 English · 🇮🇩 Bahasa Indonesia · 🇨🇳 简体中文

friskeval 是 agent 在发布新技能之前，对其**自身的技能目录**（Claude Code —— 也包括 Codex、Cursor、Gemini CLI、opencode）执行的检查。技能的 `description` 是 router 决定何时触发它的唯一依据，因此两个重叠的 description 会 悄悄地竞争相同的 prompt，而且没有任何崩溃来警告你。friskeval 会 确定性地、离线地（不消耗 token）测量这种重叠——并且当新技能与目录中已有的技能发生冲突时，它会拒绝标记为“done”。 ## 前后对比 **没有 friskeval 时** —— 你添加了 `gatefrisk`，随后将其 description 扩充，也提到了 “auto-run untrusted input 的 agent hook”。现在它会悄悄地与 `hookfrisk` 竞争 hook-audit 的 prompt。Cosine similarity 仅为 0.21，因此普通的 重复检查会显示“fine”。真正的审计开始落到了错误的技能上，而你 却永远发现不了： ``` $ git commit -m "feat: broaden gatefrisk" # ships. 无错误。hookfrisk 提示现在有时会路由到 gatefrisk。 ``` **使用 friskeval 时** —— scope-overclaim 检查会在你发布之前，指出确切借用的词汇： ``` friskeval — 7 skills · 1 issue ✓ collision gatefrisk ~ hookfrisk = 0.21 (under 0.5) ⚠ overclaim gatefrisk carries 50% of hookfrisk's domain terms [hook, command, input] → drop them or narrow gatefrisk ✓ routing 21/21 prompts rank their owner first cosine said "ok" — overclaim caught it. Fix the description before done. ``` ## 实际运行 这不是模型演示。这是 friskeval 在 Claude Code 中的实际运行 —— 请参见 **[CASES.md](CASES.md)**。 ## 安装 ``` # macOS / Linux / WSL curl -fsSL https://raw.githubusercontent.com/ryanda9910/friskeval/main/install.sh | bash # Windows (PowerShell) irm https://raw.githubusercontent.com/ryanda9910/friskeval/main/install.ps1 | iex ``` 查找你拥有的每一个编码 agent，并将技能安装到每一个中。大约需要 10 秒， 可以安全地重复运行。`--project` 也会将其安装到当前 repo 的 `.claude/` 目录中。无需 密钥，无需账号，没有依赖。 手动安装：将 [`skill/SKILL.md`](skill/SKILL.md) 复制到你的 agent 的 skills/rules 目录 （Claude Code：`~/.claude/skills/friskeval/SKILL.md`）。 ## 文档 完整文档请见 **[docs/](docs/)** — [用法](docs/usage.md) · [参考](docs/checklist.md) · [安装](docs/install.md) · [自定义](docs/customizing.md) · [FAQ](docs/faq.md) · [实际运行](CASES.md) · [贡献](CONTRIBUTING.md)。 ## 适用于 Claude Code（原生 skill），以及任何加载 rules/skill 文件的 agent —— Codex、 Cursor、Gemini CLI、opencode、Aider、GitHub Copilot CLI。 ## License MIT。

标签：AI合规, AI智能体, Cutter, SOC Prime, TF-IDF, 开发工具, 自定义脚本, 路由, 零依赖