agent-skills - Addy Osmani 出品的生产级 AI 编程技能包，把谷歌工程纪律装进 AI

项目简介

当前 AI 编程工具最尖锐的矛盾是：模型可以写出"正确"的代码，却无法产出"可靠"的工程交付物。AI 写的代码往往缺少测试、没有文档、不考虑安全、不遵循团队规范——能跑，但不能上生产。

Addy Osmani（Google Chrome 工程总监，《前端性能清单》作者）想治的就是这个病。他把自己十几年做工程、审查代码、带团队的经验，整理成了 agent-skills 这个项目。它不是一个新的 AI 模型，也不是自动写代码的工具，而是一套纯 Markdown 格式的"认知协议"——把高级工程师的工作方法和质量门禁，强制加载到 AI 的上下文中。

核心设计理念

• 将资深工程师的工作流封装为可执行的技能

• 每个技能都有明确的输入、输出和质量标准

• AI 必须遵循技能定义的步骤执行

• 减少 AI 的随意性和不一致性

• 确保每次交付都达到生产级质量

• DEFINE（定义）：明确需求，编写规格文档

• PLAN（规划）：制定实现方案和任务分解

• BUILD（构建）：TDD 驱动开发，编写代码和测试

• VERIFY（验证）：运行测试，代码审查，安全检查

• REVIEW（审查）：全面质量评估，性能和可访问性检查

• SHIP（交付）：部署上线，监控反馈

• AI 不能跳过测试步骤

• AI 不能省略文档编写

• AI 不能忽略安全检查

• 每个阶段都有明确的完成标准

• 未通过验证不能进入下一阶段

24 个技能详解

• spec-writing：编写清晰、可验证的规格文档

• task-breakdown：将大任务分解为可执行的小任务

• risk-assessment：评估技术风险和依赖

• architecture-review：审查架构设计合理性

• tdd-development：测试驱动开发，先写测试再写代码

• clean-code：遵循代码整洁原则

• error-handling：完善的错误处理和边界情况

• documentation：编写代码文档和注释

• api-design：设计清晰、一致的 API 接口

• testing-strategy：制定全面的测试策略（单元、集成、E2E）

• code-review：自动化代码审查检查清单

• security-audit：安全漏洞扫描和修复

• performance-check：性能基准测试和优化

• accessibility：可访问性合规检查

• deployment：安全部署流程和回滚策略

• monitoring：监控指标和告警配置

• incident-response：故障响应和处理流程

• post-mortem：事后复盘和改进

• using-skills：指导 AI 如何正确使用技能系统

• context-management：管理 AI 上下文窗口

• prompt-optimization：优化提示词质量

8 个 Slash 命令

• /define：进入需求定义阶段

• /plan：制定实现计划

• /build：开始 TDD 构建

• /verify：运行验证和测试

• /review：执行全面代码审查

• /ship：准备部署交付

• /audit：安全和性能审计

• /skills：查看可用技能列表

兼容性

• 支持 70+ 种 AI 编程 Agent

• Claude Code（原生支持）

• Cursor、GitHub Copilot

• OpenAI Codex CLI

• Gemini CLI

• 其他支持技能/插件系统的工具

快速开始

npx skills add addyosmani/agent-skills

/plugin marketplace add addyosmani/agent-skills

1. 克隆仓库到本地

2. 将技能文件夹复制到 Agent 的技能目录

3. 重启 Agent 即可使用

实际效果

• 代码测试覆盖率显著提升

• 生产环境 Bug 率下降

• 代码审查通过率提高

• 团队代码风格一致性增强

• 新人上手速度加快

• 被多家科技公司内部采用

项目地址

GitHub 开源仓库：https://github.com/AddyOsmani/agent-skills

官方网站：https://skills.addy.ie/

授权方式：免费 + 开源（MIT License）