🔗 我的中转站：https://api.aiseo.one/register?channel=c_0qyhisw6
项目简介
Agent Skills 是由 Addy Osmani（Google 工程总监） 开源的生产级 AI 编码 Agent 技能包。它将高级工程师的工作流、质量门禁和最佳实践编码为结构化指令，让 AI Agent 在开发的每个阶段都能遵循工程规范。
这不是提示词，而是工程纪律的数字化。
GitHubhttps://github.com/addyosmani/agent-skills
作者Addy Osmani（Google 工程总监）
Stars37,222 ⭐
Forks4,161
创建2026-02-15
协议MIT License
来源Google 工程实践 + SWE Book
AI Agent 的问题
AI 编码 Agent 的默认行为是走最短路径——这意味着它们经常跳过规范文档、测试、安全审查等让软件可靠的关键实践。
❌ 跳过规范，直接写代码
❌ 写代码但不写测试
❌ 完成功能但不做代码审查
❌ 发布前没有预检清单
❌ "我觉得没问题" 就是验证标准
Agent Skills 改变了这一切。
Agent Skills 的解决方案
它将完整的软件工程生命周期编码为 7 条 Slash 命令，每个命令自动激活对应的技能工作流：
DEFINE
/spec
➜
PLAN
/plan
➜
BUILD
/build
➜
VERIFY
/test
➜
REVIEW
/review
➜
SHIP
/ship
| 阶段 | 命令 | 核心原则 |
|---|---|---|
| 定义要做什么 | /spec | 先写规范，再写代码 |
| 规划怎么做 | /plan | 小而原子的任务拆分 |
| 增量构建 | /build | 一个切片一个切片来 |
| 证明它能工作 | /test | 测试是证据 |
| 合并前审查 | /review | 提升代码健康度 |
| 简化代码 | /code-simplify | 清晰优于聪明 |
| 发布到生产 | /ship | 越快越安全 |
21 个核心技能
技能包包含 21 个结构化技能，每个都有完整的工作流步骤、验证门禁和反合理化表格。
💭 Define：定义阶段
| 技能 | 做什么 |
|---|---|
| idea-refine | 结构化发散/收敛思维，将模糊想法变为具体方案 |
| spec-driven-development | 写 PRD（目标、命令、结构、代码风格、测试、边界），先规范再编码 |
📋 Plan：规划阶段
| 技能 | 做什么 |
|---|---|
| planning-and-task-breakdown | 将规范拆分为小型、可验证的任务，含验收标准和依赖排序 |
🛠️ Build：构建阶段
| 技能 | 做什么 |
|---|---|
| incremental-implementation | 薄垂直切片——实现、测试、验证、提交。功能标记、安全默认值 |
| test-driven-development | 红绿重构、测试金字塔（80/15/5）、Beyonce 规则 |
| context-engineering | 在正确时间给 Agent 正确的信息——规则文件、上下文打包、MCP 集成 |
| source-driven-development | 每个框架决策都基于官方文档——验证、引用、标记未验证内容 |
| doubt-driven-development | 对抗性上下文审查——CLAIM → EXTRACT → DOUBT → RECONCILE → STOP |
| frontend-ui-engineering | 组件架构、设计系统、状态管理、响应式设计、WCAG 2.1 AA 无障碍 |
| api-and-interface-design | 契约优先设计、Hyrum 定律、One Version 规则、错误语义 |
✅ Verify：验证阶段
| 技能 | 做什么 |
|---|---|
| browser-testing-with-devtools | Chrome DevTools MCP 实时数据——DOM 检查、控制台日志、网络追踪 |
| debugging-and-error-recovery | 五步分诊：复现、定位、简化、修复、防护。止损规则、安全回退 |
👁️ Review：审查阶段
| 技能 | 做什么 |
|---|---|
| code-review-and-quality | 五轴审查、变更大小（~100 行）、严重性标签（Nit/Optional/FYI） |
| code-simplification | Chesterton 围栏、500 行规则、降低复杂度、保持行为不变 |
| security-and-hardening | OWASP Top 10、认证模式、密钥管理、依赖审计、三层边界系统 |
| performance-optimization | 先测量后优化——Core Web Vitals 目标、性能分析、包分析 |
🚀 Ship：发布阶段
| 技能 | 做什么 |
|---|---|
| git-workflow-and-versioning | Trunk 开发、原子提交、变更大小、提交即保存点模式 |
| ci-cd-and-automation | 左移原则、更快更安全、功能标记、质量门禁流水线 |
| deprecation-and-migration | 代码即负债、强制/建议弃用、迁移模式、僵尸代码清理 |
| documentation-and-adrs | 架构决策记录、API 文档、内联文档标准——记录为什么 |
| shipping-and-launch | 预发布清单、功能标记生命周期、分阶段发布、回滚流程 |
3 个专家角色
预配置的专业 Agent 角色，用于针对性审查：
| 角色 | 视角 | 关注点 |
|---|---|---|
| 👨💻 code-reviewer | Senior Staff Engineer | 五轴审查，"Staff 工程师会批准吗？"标准 |
| 🧪 test-engineer | QA 专家 | 测试策略、覆盖分析、Prove-It 模式 |
| 🔒 security-auditor | 安全工程师 | 漏洞检测、威胁建模、OWASP 评估 |
设计哲学
流程，不是散文
技能是 Agent 遵循的工作流，不是供阅读的参考文档。每个都有步骤、检查点和退出标准
反合理化
每个技能都包含 Agent 常用的跳过步骤借口表（如"我稍后加测试"），附带反驳论点
验证不可协商
每个技能都以证据要求结尾——测试通过、构建输出、运行时数据。"我觉得没问题"永远不够
渐进式披露
SKILL.md 是入口。支持性参考文档仅在需要时加载，保持 token 用量最小化
安装与适配
Agent Skills 支持几乎所有主流 AI 编码工具：
| 工具 | 安装方式 |
|---|---|
| 🧠 Claude Code（推荐） | /plugin marketplace add addyosmani/agent-skills |
| 🎯 Cursor | 复制 SKILL.md 到 .cursor/rules/ 目录 |
| ✨ Gemini CLI | gemini skills install ... --path skills |
| 🌊 Windsurf | 添加 skill 内容到 Windsurf 规则配置 |
| 📝 OpenCode | 通过 AGENTS.md + skill 工具调用 |
| 🤖 GitHub Copilot | 使用 agents/ 作为 persona，写入 copilot-instructions.md |
| 🔧 Kiro | 技能存放在 .kiro/skills/ 目录 |
| 💻 Codex 等 | 技能是纯 Markdown，可用于任何接受系统提示的 Agent |
快速开始
Claude Code 安装
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skillsClaude Code 本地安装
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skillsGemini CLI 安装
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills实战场景
🚀 场景一：从零开发新功能
使用完整的工作流：
/spec— 先写 PRD，定义目标、边界、测试策略/plan— 拆分为小型可验证任务，按依赖排序/build— 薄垂直切片实现，每次实现→测试→验证→提交/test— 红绿重构，测试金字塔覆盖/review— 五轴审查，严重性标签标注/ship— 预发布清单、功能标记、分阶段发布
🔍 场景二：审查一段复杂代码
/code-simplify— Chesterton 围栏原则，降低复杂度/review— 激活 code-reviewer 专家角色- security-auditor — OWASP 威胁建模
- performance-optimization — 测量性能瓶颈
🐛 场景三：修复一个线上 Bug
/test— 先写复现测试- debugging — 五步分诊：复现→定位→简化→修复→防护
- browser-testing — DevTools MCP 实时追踪
/review— 确认修复不引入新问题
总结
Agent Skills 不是一组提示词，而是工程纪律的数字化——它把 Google 级别的软件工程实践，封装成 AI Agent 能理解、能执行、不会跳过的结构化工作流。
✅ 37,222 Stars — Addy Osmani（Google）出品
✅ 21 个核心技能 — 覆盖完整 SDLC
✅ 7 条 Slash 命令 — /spec /plan /build /test /review /code-simplify /ship
✅ 3 个专家角色 — Code Reviewer / Test Engineer / Security Auditor
✅ 反理性化设计 — 每个借口都有反驳论点
✅ 验证不可协商 — "我觉得没问题" 永远不够
✅ 全工具适配 — Claude Code / Cursor / Gemini / Windsurf / Copilot 等
✅ MIT 开源 — 自由使用，自由定制
如果你的 AI Agent 还在跳过规范、测试和安全审查——给它装上 Agent Skills，它会开始像一个高级工程师那样工作。
🚀 GitHub：https://github.com/addyosmani/agent-skills
👤 作者：Addy Osmani（Google 工程总监）
🔗 我的中转站：https://api.aiseo.one/register?channel=c_0qyhisw6