GitHub 趋势 · AI 编码工具
别让 AI 走「最短路径」：addyosmani/agent-skills 把工程纪律打包进编码流
这个项目是做什么的
addyosmani/agent-skills 是 Addy Osmani 开源的一套面向 AI 编码代理的生产级技能包。它把资深工程师在软件开发各阶段用到的工作流、质量门禁与最佳实践，固化成 25 个结构化 SKILL，让代理在 spec、plan、build、test、review、ship 每个阶段都按同一套纪律行事。
关键在于：每个 skill 不是参考文档，而是流程——有步骤、有检查点、有退出标准；还内置反合理化表，把代理常用的偷懒借口（例如「测试我后面再加」）和它的反驳写在一起；并且强制验证——每个 skill 结尾都要求可验证证据（测试通过、构建输出、运行时数据），「看起来对」不算数。
怎么用
通用一行安装（任意 agent）：
npx skills add addyosmani/agent-skills # 安装全部 25 个技能 npx skills add addyosmani/agent-skills --list # 先浏览再装 npx skills add addyosmani/agent-skills --skill test-driven-development # 只装某个技能
Claude Code（推荐方式）：
/plugin marketplace add addyosmani/agent-skills /plugin install agent-skills@addy-agent-skills
它还提供 9 个生命周期斜杠命令：/spec（先写规格）、/plan（拆小任务）、/build（增量构建）、/test（测试即证明）、/constraints（一次定标准）、/review（合并前复查）、/webperf（先量再优化）、/code-simplify（清晰优先）、/ship（上线）。设计 API 会自动触发 api-and-interface-design，写 UI 触发 frontend-ui-engineering——技能会按你正在做的事自动激活。
多端覆盖：Claude Code、Codex、Gemini CLI、Cursor、Copilot CLI、Antigravity、Kiro、Zed 等 70+ 工具，安装命令各不相同但原理一致。
优点和缺点
优点• 流程而非散文：把「何时写 spec、测什么、怎么 review、何时发布」变成可执行步骤，约束代理走规范路径。
• 反合理化设计：直接预判并堵住代理跳步的借口。
• 验证不可协商：强制证据，减少「自信但错误」。
• MIT 许可：可商用、可改、可集成进团队工具链。
• 多端覆盖：主流 AI 编码客户端基本通吃。
缺点 / 坑（来自真实 issue）• Windows 上 SessionStart hook 用 bash 语法跑在 pwsh 下会失败（#488、#475），原生 Windows Codex 同样中招。
• 单 skill 安装只复制 skills/<name>/，不含仓库级 references/ 共享检查表，存在可移植性缺口（#361）。
• 部分客户端（Antigravity CLI）生命周期斜杠命令不可被发现，且 plugin 每次 SessionStart 仍注入 using-agent-skills 造成重复路由（#445、#569）。
• 五个 manifest 版本号不一致，更新检测无法判断插件是否最新（#440）。
• 跨 Claude 不同代模型（如 sonnet-4-6 到 sonnet-5）存在技能落地漂移的讨论（#432、#433）。
最终能达到什么效果
把一个「爱走捷径的代理」变成「按工程纪律交付的代理」：先有规格再写码、红绿重构被强制、合并前过五轴复查、上线前先量性能。它不改变模型本身，而是给模型套上资深工程师会坚持的流程护栏。对你而言，产出更像是生产级代码，而不只是能跑的原型。
• 适合：用 AI 编码代理做真实项目、希望稳定产出、愿意在流程上投入的工程师与团队。
• 不适合：只想一句话提需求等结果、不愿被流程约束的人；以及纯 Windows 原生环境且不想折腾 hook 的人（现阶段摩擦较高）。
• 一个坑：别用单 skill 安装指望共享检查表齐全；要么整仓集成，要么把需要的 checklist 自己拷进 references/。
下期预告
本周还有一批「给 AI 代理套护栏」的工具冲上趋势，下期做一期横向对比合集——从流程纪律到上下文优化，看哪条路线更适合你。