skilladopt：根据自己项目适配 AI Agent 技能文件

Agent skills（也就是 Claude Code 和 Codex 加载的 SKILL.md 文件）很容易分享，GitHub 上满地都是。每一份都是作者为自己的项目写的，带着他们的技术栈、脚本和习惯用法。

原封不动地复制到自己的仓库里，你的 Agent 就会继承这一切。一个前端 skill 会让它在你们用 CSS modules 时却去用 Tailwind。一个工作流 skill 说"运行测试"，而你的项目脚本叫 pnpm test:unit。一个清理 skill 说"删除未使用的文件"，而你的 AGENTS.md 明确写着不许碰 docs/。

我做了 skilladopt，在 skill 进入仓库之前先把它修正一番。

npx skilladopt anthropics/skills frontend-design

它根据一个固定的 commit 拉取 skill 内容，然后把文本和你项目的简短摘要一起交给一个隔离的 Claude 或 Codex worker 处理。Worker 对每个段落各做一个决定：

每个决定都必须引用你仓库里的证据：依赖、npm 脚本、AGENTS.md 或 CLAUDE.md 里的一行。然后纯代码会校验这个答案。"bind"可以在句子里插入恰好一个你项目里真正存在的命令，其余部分必须与原文完全一致。"stack mismatch" drop 必须指向你项目实际缺少的东西。带有义务性质的段落（禁止条款、审批步骤、验证步骤）绝不会被删除或重写，除非经过你同意。

没有任何来自 skill 的内容被执行，worker 以无工具模式运行（claude -p --safe-mode）或在只读沙箱中运行（codex）。

你的队友重命名了测试脚本，并在 AGENTS.md 里加了一条规则。

npx skilladopt impact

因为每个决定都记录了证据，skilladopt 能判断哪些决定已经不再成立。在演示运行中，25 个决定里有 1 个不再成立，再加上可能冲突的新规则。你重新检查那几行，其余的保持不动。skilladopt update <name> 会把 skill 重新适配到最新上游版本，复用所有段落和证据都没变的决定。

npx skilladopt setup

这会为 Claude Code 和 Codex 安装一个小 skill。之后你可以在任意项目里问"把这个项目加一个前端设计 skill"。Agent 搜索到一个，调用 skilladopt 采纳它，展示改了哪些内容，然后在安装前征求你同意。

目前是 v0.1，MIT 协议，无运行时依赖。只处理 Markdown 格式的 skill，拒绝需要脚本的 skill。我还没有测量它节省了多少时间，这是我最想听到反馈的部分。如果它做了一个你不同意的决定，关于这个 skill 和决定的 issue 会很有帮助。

GitHub: https://github.com/kks0488/skilladopt