
字节笔记本
2026年10月3日 · 约 6 分钟读完
给 coding agent 立规矩的 10 万星技能包,又更新了
用 coding agent 干活久了都会遇到同一个问题:它不是不会写代码,而是不按规矩写。测试说稍后补,提交信息随手写,改动一把梭不拆分。Chrome 工程负责人 Addy Osmani 的答案是把这些规矩本身做成 agent 技能:agent-skills 仓库已经攒到 10 万星,MIT 协议,10 月 3 日刚发布 v0.6.12,保持每周一更的节奏。

项目简介
agent-skills 的定位是把资深工程师在真实项目里遵循的工作流、质量门和最佳实践编码成技能,让 agent 在开发的每个阶段稳定复现这些习惯。整套体系覆盖六个阶段:定义、计划、构建、验证、审查、发布,对应 9 个斜杠命令和 25 个技能(24 个生命周期技能加 1 个路由用的元技能)。它不是又一批提示词模板,每个技能都是带步骤、检查点和退出条件的可执行流程。
核心功能
生命周期命令。 /spec 先写规格再动代码,/plan 把规格拆成可验证的小任务,/build 按纵向切片增量实现,/test 用测试证明改动成立,/review 合并前做五轴审查,/ship 负责带检查清单地上线。中间还有 /constraints 把质量标准一次定死写进 CONSTRAINTS.md,/code-simplify 在不改行为的前提下降复杂度。
反找借口表。 这是整个仓库最特别的设计。每个技能都内置一张「合理化借口对照表」,比如 agent 最常说的「我先实现,测试稍后补」,表里就写着驳回理由和依据。技能的验证环节是强制的:必须拿出测试通过、构建输出或运行时数据作为证据,「看起来没问题」不算数。
/build auto 自主模式。 规格存在的前提下,批准一次计划就能自主推进所有任务。它去掉的不是验证而是人肉卡点:每个任务仍然测试驱动、独立提交,遇到失败或高风险步骤会主动暂停。
上下文自动路由。 技能会根据你正在做的事自动激活:设计 API 时带出接口设计技能,写前端时带出 UI 工程技能,不用手动挑。另有 interview-me 技能,在你需求说不清时一次只问一个问题,把真实意图问到约 95% 的置信度才开工。
几个值得单装的技能。 doubt-driven-development 在高风险场景对每个非平凡决策做对抗式复核,走 CLAIM 到 EXTRACT 到 DOUBT 再到 RECONCILE 的流程,拿不准就停下来问人,必要时还能授权跨模型交叉验证;source-driven-development 强制每个框架决策以官方文档为准,给出引用并标记未核实的内容;debugging-and-error-recovery 是五步排查法:复现、定位、缩小、修复、加护栏,测试挂了就停线。

快速上手
最快的路径是一条命令装进 70 多个 agent,Claude Code、Cursor、Codex、Copilot、Cline 都支持:
npx skills add addyosmani/agent-skills想先逛后买可以加 --list 浏览全部技能,或者按需单装,比如只要代码审查:
npx skills add addyosmani/agent-skills --skill code-review-and-qualityClaude Code 用户走插件市场更顺:/plugin marketplace add addyosmani/agent-skills 再 /plugin install。两个注意点:单装某个技能时共享的 references 检查清单不会被复制,技能能跑但部分引用路径失效,官方在 issue 里跟踪这个问题;Windows 和 macOS 上 SSH 没配好导致市场安装报错时,把 GitHub 的 SSH 地址全局改写成 HTTPS 即可绕过。
技能是怎么组织的
每个技能都是一份结构化的 SKILL.md,解剖结构固定:frontmatter 声明名称和触发条件,正文按 Overview、When to Use、Process、Rationalizations、Red Flags、Verification 六段展开。配套的参考资料只在需要时加载,SKILL.md 本身保持入口轻量,不会一上来就吃掉大量上下文窗口。仓库还附了 Agent Personas 和一组共享检查清单,团队可以把质量标准直接对齐到同一份文件上。
适合谁用
团队里 agent 产出质量不稳定、想统一工程规范的技术负责人,最直接的用法是把 /constraints 和 /review 先铺开;个人开发者如果受够了 agent 的「稍后再补」综合症,TDD 和 debugging 两个技能单装就值回时间;正在给自研 agent 设计技能体系的人,它的技能解剖结构(步骤、借口表、红旗信号、验证要求)是很好的模板。
10 万星说明两件事:这个痛点足够普遍,而这个解法被足够多的人验证过。技能包解决不了产品方向问题,但能让 agent 少犯低级错误,这就够回本了。从趋势看它保持约一周一版的小步节奏,v0.6.12 之后大概率还有增量,装完全套的记得隔段时间用同一条 add 命令刷新,别用 update 漏掉新技能。仓库地址:addyosmani/agent-skills。



