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

码途漫谈
1 阅读7分钟

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

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

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

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

flowchart LR
    Idea[Idea<br>需求细化] -->|/spec| Spec[Spec<br>需求定义]
    Spec -->|/plan| Code[Code<br>增量实现]
    Code -->|/build| Test[Test<br>验证测试]
    Test -->|/review| QA[QA<br>质量评审]
    QA -->|/ship| Go[Go<br>正式上线]
    style Idea fill:#f5f4ed,stroke:#1B365D,stroke-width:2px
    style Spec fill:#f5f4ed,stroke:#1B365D,stroke-width:2px
    style Code fill:#f5f4ed,stroke:#1B365D,stroke-width:2px
    style Test fill:#f5f4ed,stroke:#1B365D,stroke-width:2px
    style QA fill:#f5f4ed,stroke:#1B365D,stroke-width:2px
    style Go fill:#f5f4ed,stroke:#1B365D,stroke-width:2px

只需要输入对应的命令，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-devtoolsChrome DevTools MCP，获取实时运行数据，DOM 检查、控制台日志、网络追踪、性能分析构建或调试浏览器端的内容
🐛 debugging-and-error-recovery五步排查：复现、定位、简化、修复、防护，停止规则、安全降级测试失败、构建出错、行为异常

🔍 Review：合并前的质量关卡

技能功能使用场景
👀 code-review-and-quality五轴评审，变更大小控制，严重程度标签，评审速度规范，拆分策略合并任何变更之前
✨ code-simplification切斯特顿栅栏，500 行规则，在保留行为的同时降低复杂度代码能跑但是可读性和维护性不好
🔒 security-and-hardeningOWASP 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 可以自动遵循的标准流程，让你的开发效率和代码质量同时提升。

项目地址：github.com/addyosmani/…

avatar
文章
阅读
粉丝