乐于分享
好东西不私藏

Agent Skills:给 AI 编码助手装上工程大脑,让开发流程标准化

Agent Skills:给 AI 编码助手装上工程大脑,让开发流程标准化

你是不是发现,AI 编码助手虽然能快速写代码,但总是跳过测试、忽略安全规范,写出来的代码看起来像临时原型,没法直接用到生产环境?

Agent Skills 正是为解决这个问题而生的 —— 它把资深工程师的工作流程、质量关卡和最佳实践,打包成 AI 可以理解的技能,让 AI 编码助手也能遵循生产级的工程规范,从想法到上线,每一步都专业可靠,保证输出的代码稳定、可维护、符合工业级标准。


全流程覆盖:从想法到上线的标准化工作流

Agent Skills 把整个开发周期拆解为 6 个标准化阶段,每个阶段都有对应的命令和技能,让 AI 自动遵循正确的流程:

只需要输入对应的命令,AI 就会自动激活对应的技能,引导你完成整个流程:

你要做什么
对应命令
核心原则
定义要做什么
/spec
先写规范,再写代码
规划实现方案
/plan
拆解为小而原子的任务
增量实现功能
/build
一次只做一个小切片
验证功能可用
/test
测试是功能的证明
合并前做评审
/review
提升代码健康度
简化代码逻辑
/code-simplify
清晰比聪明更重要
部署到生产环境
/ship
快就是稳

这些命令会自动触发对应的技能,比如你在设计 API 的时候,会自动触发 API 设计的技能,做 UI 的时候会自动触发前端工程的技能,完全不需要手动切换。


快速上手:1 分钟安装,适配所有主流 AI 工具

Agent Skills 可以轻松集成到你常用的 AI 编码工具中,无需复杂配置,安装后即可使用:

Claude Code(推荐)

通过插件市场一键安装:

/plugin marketplace add addyosmani/agent-skills/plugin install agent-skills@addy-agent-skills

如果遇到 SSH 错误,可以用 HTTPS 链接安装:

/plugin marketplace add https://github.com/addyosmani/agent-skills.git/plugin install agent-skills@addy-agent-skills

Gemini CLI

一键安装技能包:

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

Cursor

把技能文件复制到 .cursor/rules/,或者直接引用整个技能目录,详细步骤查看Cursor 配置指南。

其他工具

支持 Windsurf、OpenCode、GitHub Copilot、Kiro IDE 等几乎所有主流 AI 编码工具,详细的配置步骤可以查看官方文档。


20 个核心技能,覆盖开发全场景

在命令的背后,是 20 个精心设计的核心技能,每个技能都包含了完整的工作流程、验证关卡和反合理化机制,覆盖开发的每个环节:

📝 Define:明确要做什么

技能
功能
使用场景
🔍 idea-refine
结构化的发散 / 收敛思考,把模糊的想法变成具体的方案
你有一个粗略的概念,需要探索细化
📋 spec-driven-development
写 PRD,覆盖目标、结构、代码风格、测试、边界,先规范后代码
启动新项目、新功能或者重大变更

📐 Plan:拆解实现方案

技能
功能
使用场景
📦 planning-and-task-breakdown
把规范拆解为小的、可验证的任务,带验收标准和依赖排序
你有了规范,需要拆分成可执行的单元

🔨 Build:增量实现功能

技能
功能
使用场景
✂️ incremental-implementation
薄垂直切片,实现、测试、验证、提交,特性开关、安全默认、可回滚变更
任何修改超过一个文件的场景
🧪 test-driven-development
红 - 绿 - 重构,测试金字塔,DAMP 优于 DRY,Beyonce 规则,浏览器测试
实现逻辑、修复 bug、修改行为
🧩 context-engineering
在正确的时间给 AI 正确的信息,规则文件、上下文打包、MCP 集成
开始会话、切换任务、输出质量下降时
📚 source-driven-development
所有框架决策都基于官方文档,验证、引用来源,标记未验证内容
你需要权威的、基于官方文档的框架代码
🎨 frontend-ui-engineering
组件架构、设计系统、状态管理、响应式设计、WCAG 2.1 AA 无障碍
构建或修改用户界面
🔌 api-and-interface-design
契约优先设计、Hyrum 定律、单版本规则、错误语义、边界验证
设计 API、模块边界、公共接口

✅ Verify:验证功能可用

技能
功能
使用场景
🌐 browser-testing-with-devtools
Chrome DevTools MCP,获取实时运行数据,DOM 检查、控制台日志、网络追踪、性能分析
构建或调试浏览器端的内容
🐛 debugging-and-error-recovery
五步排查:复现、定位、简化、修复、防护,停止规则、安全降级
测试失败、构建出错、行为异常

🔍 Review:合并前的质量关卡

技能
功能
使用场景
👀 code-review-and-quality
五轴评审,变更大小控制,严重程度标签,评审速度规范,拆分策略
合并任何变更之前
✨ code-simplification
切斯特顿栅栏,500 行规则,在保留行为的同时降低复杂度
代码能跑但是可读性和维护性不好
🔒 security-and-hardening
OWASP Top 10 防护,认证模式,密钥管理,依赖审计,三层边界系统
处理用户输入、认证、数据存储、外部集成
⚡ performance-optimization
先测量后优化,Core Web Vitals 目标,分析流程,包分析,反模式检测
有性能要求或者怀疑有性能退化

🚀 Ship:自信部署上线

技能
功能
使用场景
🌿 git-workflow-and-versioning
主干开发,原子提交,变更大小控制,提交作为保存点
任何代码修改(全程生效)
🤖 ci-cd-and-automation
左移,快就是稳,特性开关,质量关卡,失败反馈
设置或修改构建部署流水线
🗑️ deprecation-and-migration
代码即负债,强制 / 建议弃用,迁移模式,僵尸代码清理
移除旧系统、迁移用户、下线功能
📖 documentation-and-adrs
架构决策记录,API 文档,内联文档标准,记录为什么这么做
做架构决策、修改 API、发布功能
🚢 shipping-and-launch
上线前检查清单,特性开关生命周期,分阶段发布,回滚流程,监控配置
准备部署到生产环境

专家角色:让 AI 化身领域专家

Agent Skills 还提供了预配置的专家角色,你可以让 AI 化身不同的专家,帮你做针对性的工作:

  • 👨‍💻 高级 Staff 工程师:做代码评审,用 “Staff 工程师会批准这个吗?” 的标准来检查代码

  • 🧪 QA 专家:做测试策略,覆盖分析,用 “证明给我看” 的模式来验证功能

  • 🔐 安全工程师:漏洞检测,威胁建模,OWASP 评估,帮你检查代码的安全问题


技能是怎么工作的?

每个技能都遵循统一的结构,确保 AI 能可靠地执行:

┌─────────────────────────────────────────────────┐│                   SKILL.md                      ││                                                 ││  ┌─ Frontmatter ─────────────────────────────┐  ││  │ name: lowercase-hyphen-name               │  ││  │ description: Guides agents through [task].│  ││  │ Use when…                                │  ││  └───────────────────────────────────────────┘  │ │ 概述 → 这个技能做什么                            ││ 使用时机 → 触发条件                              ││ 流程 → 分步工作流                                │| 合理化借口 → 常见借口+对应的反驳                  ││ 危险信号 → 异常的标志                            ││ 验证 → 需要的证据                                │└─────────────────────────────────────────────────┘

最特别的是反合理化机制:每个技能都包含了 AI 常用的跳过步骤的借口(比如 “我之后再加测试”),并且提前写好了对应的反驳,防止 AI 找借口跳过重要的工程步骤,保证流程被严格执行。

而且,每个技能都有明确的验证要求:必须有证据证明步骤完成了,比如测试通过、构建成功、运行数据正常,“看起来没问题” 永远不够。


为什么选择 Agent Skills?

AI 编码助手默认会走最短的路径,这就意味着它会跳过规范、测试、安全评审这些让软件可靠的实践,而 Agent Skills 给 AI 加上了结构化的工作流,强制 AI 遵循资深工程师带到生产代码中的规范。

这些技能里的最佳实践,都来自 Google 的工程文化,包括《Software Engineering at Google》里的理念,比如 API 设计里的 Hyrum 定律,测试里的 Beyonce 规则和测试金字塔,代码评审里的变更大小和评审速度规范,简化里的切斯特顿栅栏,Git 流程里的主干开发,CI/CD 里的左移和特性开关,还有专门的弃用技能,把代码当成负债来处理。这些不是抽象的原则,而是直接嵌入到 AI 要遵循的分步工作流里。


总结

Agent Skills 给你的 AI 编码助手装上了生产级的工程大脑,让 AI 不再只会写原型代码,而是能输出符合工业标准的、可维护的、安全的生产代码,把资深工程师的最佳实践,变成 AI 可以自动遵循的标准流程,让你的开发效率和代码质量同时提升。

项目地址:https://github.com/addyosmani/agent-skills