agent-skills：给 AI 编程 Agent 装上高级工程师的工程能力

🛠️

agent-skills：给 AI 编程 Agent 装上高级工程师的工程能力

37,763 Stars · Addy Osmani (Google) · MIT · 22 个工程 Skill

GitHub →

🔗 我的中转站：https://api.aiseo.one/register?channel=c_0qyhisw6

📑 目录导航

• 项目简介
• 为什么需要
• 六大开发阶段
• 22 个 Skill 全览
• 核心设计理念
• 安装方式
• 快速开始
• 实战场景
• 总结

项目简介

agent-skills 是 Google 工程师 Addy Osmani 开源的 AI 编程 Agent 工程技能包。它把高级工程师的 workflows、质量门禁和最佳实践编码成结构化的 Skill 文件，让 Claude Code、Cursor、Gemini 等 AI Agent 在开发的每个阶段都能自动遵循工程规范。

不是提示词，不是模板——是可执行的工程流程：每一步有步骤、有检查点、有退出标准，还有反自我说服机制。

GitHub

https://github.com/addyosmani/agent-skills

Stars

37,763 ⭐

Forks

4,210

创建

2026-02-15

语言

Shell

协议

MIT License

为什么需要

AI 编程 Agent 默认走最短路径——跳过写 spec、不写测试、不做安全审查。结果就是原型质量的代码，不是生产级代码。

Agent Skills 的核心理念：

AI Agent ✃ 工程规范 = 原型质量 AI Agent ✅ 工程规范 = 生产质量

它把 Google 软件工程实践（Software Engineering at Google）中的经验编码成 Agent 可以执行的流程。

六大开发阶段

7 个斜杠命令，覆盖完整软件开发生命周期：

DEFINE PLAN BUILD VERIFY REVIEW SHIP ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │Idea ├──▶│Spec ├──▶│Code ├──▶│Test ├──▶│QA ├──▶│Go │ │Refine│ │PRD │ │Impl │ │Debug│ │Gate │ │Live │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘/spec /plan /build /test /review /ship

阶段	命令	核心原则
Define 定义	/spec	Spec before code
Plan 规划	/plan	Small, atomic tasks
Build 构建	/build	One slice at a time
Verify 验证	/test	Tests are proof
Review 审查	/review	Improve code health
Ship 发布	/ship	Faster is safer

22 个 Skill 全览

📝 Define 阶段

idea-refine — 结构化发散/收敛思维，把模糊想法变成具体方案
spec-driven-development — 写 PRD（目标、命令、结构、代码风格、测试、边界）后再写代码

📋 Plan 阶段

planning-and-task-breakdown — 把 spec 拆成小、可验证的任务，含验收标准和依赖排序

🔨 Build 阶段

incremental-implementation — 薄垂直切片，实现-测试-验证-提交，feature flag 保护
test-driven-development — Red-Green-Refactor，测试金字塔（80/15/5），DAMP over DRY
context-engineering — 在正确时间给 Agent 正确信息，rules 文件、上下文打包、MCP 集成
source-driven-development — 每个框架决策都要追溯到官方文档，引用来源，标记未验证内容
doubt-driven-development — 对每个非平凡决策做对抗性审查，CLAIM → EXTRACT → DOUBT → RECONCILE
frontend-ui-engineering — 组件架构、设计系统、状态管理、响应式、WCAG 2.1 AA 无障碍
api-and-interface-design — 契约优先设计、Hyrum's Law、One Version Rule、错误语义

✅ Verify 阶段

browser-testing-with-devtools — Chrome DevTools MCP 获取运行时数据：DOM、console、network、性能
debugging-and-error-recovery — 五步排查：复现、定位、简化、修复、防御。stop-the-line 规则

🔍 Review 阶段

code-review-and-quality — 五维审查，变更大小约 100 行，严重度标签（Nit/Optional/FYI）
code-simplification — Chesterton's Fence 原则，Rule of 500，降低复杂度但保持行为不变
security-and-hardening — OWASP Top 10、认证模式、密钥管理、依赖审计、三层边界系统
performance-optimization — 先测量再优化，Core Web Vitals 目标、性能分析、包分析

🚀 Ship 阶段

git-workflow-and-versioning — Trunk-based development、原子提交、commit-as-save-point
ci-cd-and-automation — Shift Left、Faster is Safer、feature flag、质量门禁流水线
deprecation-and-migration — 代码即负债思维，强制 vs 建议废弃，迁移模式，僵尸代码清理
documentation-and-adrs — 架构决策记录、API 文档、内联文档标准——记录 why 而非 what
shipping-and-launch — 预发布清单、feature flag 生命周期、分阶段发布、回滚流程、监控设置

🤖 Meta 和辅助

using-agent-skills # 元 Skill：自动匹配工作流 + 共享运行规则3 个专家角色：code-reviewer # 高级工程师视角，五维审查test-engineer # QA 专家，测试策略 + 覆盖率分析security-auditor # 安全工程师，漏洞检测 + 威胁建模4 个参考清单：testing-patterns / security-checklist / performance-checklist / accessibility-checklist

核心设计理念

1. 流程驱动，不是文档驱动

每个 Skill 都是 Agent 要执行的流程，不是让 Agent 阅读的参考文档。有步骤、有检查点、有退出标准。

2. 反自我说服机制

每个 Skill 都包含"反自我说服表"——记录 Agent 常用的偷懒借口（如"我稍后再加测试"）和对应的反驳。

❌ "我稍后再补测试" ✅ "不写测试的代码就像没刹车的车——跑得快但停不下来"

3. 验证不可商量

每个 Skill 最后都有证据要求：测试通过、构建输出、运行时数据。"看起来对"永远不够。

4. 渐进式加载

SKILL.md 是入口，参考资料按需加载，最小化 Token 消耗。

安装方式

Claude Code（推荐）

# 市场安装 /plugin marketplace add addyosmani/agent-skills /plugin install agent-skills@addy-agent-skills# 本地安装 git clone https://github.com/addyosmani/agent-skills.git claude --plugin-dir /path/to/agent-skills

Cursor

# 把 SKILL.md 内容复制到 .cursor/rules/ # 或参考 skills/ 目录完整引用

Gemini CLI

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

Windsurf / OpenCode / GitHub Copilot / Kiro

各 IDE 都有对应的 setup 指南，Skill 文件是纯 Markdown，任何接受系统提示词的 Agent 都能用。

快速开始

30 秒安装（Claude Code）

# 一行命令 /plugin marketplace add addyosmani/agent-skills# 开始使用 /spec "做一个用户管理系统" /plan /build /test /review /ship

Cursor 用户

把需要的 SKILL.md 内容复制到 .cursor/rules/ 目录下，Cursor 会自动加载。

实战场景

🚀 场景一：从零开始一个项目

# 第一步：定义要做什么 /spec "做一个 TODO 应用，支持分类和优先级"# 第二步：规划实现方案 /plan# 第三步：逐步构建 /build# 第四步：验证 /test# 第五步：审查代码 /review# 第六步：发布 /ship

每个命令自动触发对应的 Skill 流程，不需要手动指定。

🔍 场景二：审查别人的代码

# 五维代码审查 /review# 或者指定专家角色审查 # code-reviewer 角色会从高级工程师视角审查 # security-auditor 角色会做安全审计

📊 场景三：性能优化

# 先测量，再优化 # performance-optimization skill 会自动： # 1. 跑性能基准测试 # 2. 分析瓶颈 # 3. 给出优化建议 # 4. 验证优化效果

🔒 场景四：安全加固

处理用户输入、认证、数据存储时，security-and-hardening Skill 自动触发：

• OWASP Top 10 检查
• 认证模式审查
• 密钥管理验证
• 依赖审计

⚡ 场景五：代码简化

# 代码能跑但太难懂？ /code-simplify# Chesterton's Fence 原则： # 先理解为什么这段代码存在，再决定能不能删

总结

agent-skills 不是一套提示词，而是把高级工程师的工程判断力编码成可执行流程——什么时候写 spec、测什么、怎么审查、何时发布。它解决的核心问题是：AI Agent 很强，但缺工程纪律。

✅ 37,763 Stars — Addy Osmani (Google) 开源

✅ 22 个 Skill — 覆盖完整 SDLC

✅ 7 个斜杠命令 — /spec /plan /build /test /review /code-simplify /ship

✅ 反自我说服 — 防止 Agent 偷懒跳过关键步骤

✅ 验证驱动 — 每个流程都有证据要求

✅ 多平台 — Claude Code / Cursor / Gemini / Windsurf / Copilot

✅ 3 个专家角色 — 代码审查 / 测试 / 安全

✅ MIT 开源 — 自由使用和修改

如果你在用 AI 写代码但总觉得质量不够稳，agent-skills 可能是让 AI 输出从"能用"到"可靠"的关键一步。

🚀 GitHub：https://github.com/addyosmani/agent-skills

🔗 我的中转站：https://api.aiseo.one/register?channel=c_0qyhisw6