Skillager — 给编码 Agent 建一座带审批的技能库

技能简介

Skillager 是一个本地个人技能库与审批层。它把散落在项目、依赖包、共享目录里的技能统一纳入一个可版本化的库中，记录你实际审阅过的内容，并让 Agent 为每个项目只取「最小可用的一组」技能。它的核心主张很直接：先把技能收进库、由人确认、让 Agent 按需检索，而不是把所有技能一股脑塞进每次会话。装上后它会在项目里安装一个小技能，教 Agent 如何查询就绪状态、检索已审阅技能，并在需要你确认时给出准确命令。

核心能力

1. 个人技能库：在一个版本化目录中创建与维护自己的技能，任何改动都有迹可循。
2. 多来源复用：项目技能、依赖包技能、共享仓库技能都可直接使用，无需搬动原文件。
3. 审批层：新技能或变更后的技能在运行前必须经你确认，审批会保留经过核验的副本。
4. 按需暴露：已审阅技能保持待命状态，Agent 只在任务真正需要时才加载，减少上下文占用。
5. 风险内容拦截：对检查标记为有风险的内容，或明确排除你所用 Agent 的技能，使用前都会先询问。
6. 技能仓库注册：可把外部技能仓库注册为集合，或把现有技能仓库作为来源接入，让已审阅技能跨项目可用。
7. 诊断与溯源：doctor 排查异常，library sync --status 查看来源血缘与冲突，且不会自动从远端拉取或推送。

安装配置

1. 安装工具：uv tool install skillager 或 pipx install skillager，要求 Python 3.10 及以上。
2. 在项目根目录初始化：skillager setup --agent codex，使用 Claude 时改为 --agent claude。
3. 初始化不会修改 AGENTS.md 或 CLAUDE.md，只安装一个小型项目技能，改动范围可控。
4. 需要接入外部技能仓库时，先 skillager collection add ~/skills/workflows --name workflows，再执行 skillager setup --collection workflows --agent codex。

使用步骤

1. 安装并初始化：在项目里运行 setup，工具会扫描当前项目可发现的技能，并逐个询问你是否信任。
2. 审阅技能：确认时会记录你审阅的具体内容，后续若技能被篡改会被识别出来。
3. 重启 Agent：重新打开编码 Agent 会话，让项目技能生效。
4. 描述目标：直接说「先查一下 Skillager，再帮我搭一个 Python GIS 服务；有帮助时用已审阅技能，一次性技能按需加载」。
5. 按需确认：当 Skillager 需要你介入时，Agent 会把要执行的准确命令交给你，由你决定是否放行。
6. 排查与维护：用 skillager list --scope project --json 查看项目内技能清单，用 doctor --agent codex 检查异常，用 library sync --approved 回填历史上已批准的技能。

适用场景

1. 技能越装越多、每次会话都被无关技能占据上下文的开发者。
2. 团队需要「谁批准了哪个技能、内容是什么」的审计链路。
3. 使用第三方技能包，担心上游偷偷改动技能内容的场景。
4. 跨多个项目复用同一批个人技能，又不想复制多份副本。
5. 对 Agent 自动安装、自动执行技能持谨慎态度的安全敏感团队。

适用人群

适合长期维护个人技能资产的资深开发者、平台工程师与研发效能团队；对需要审计与审批流程的组织尤其合适。刚接触 Agent、技能数量很少的用户会觉得流程偏重。

工作原理

Skillager 把技能视为需要审批的构件：发现技能后记录其确切内容，形成「已审阅」快照存入本地库；Agent 通过 CLI 查询就绪状态与已审阅技能，只在任务需要时加载；一旦技能内容变化、来源异常或涉及风险项，就用审批流程拦住并要求人工确认。项目级、包级与共享级三种作用域分别管理，副本与库之间保持血缘关系，且工具不会静默移动外部技能、覆盖本地修改或与 Git 远端同步。

官方链接

• PyPI 页面：https://pypi.org/project/skillager/
• 许可证：MIT
• 当前版本：0.9.8（支持 Codex 与 Claude，兼容 Python、npm、Cargo 三种包来源）