Agent Skills：addyosmani的生产级AI编程工程技能框架

📋 学习目标

• 理解Agent Skills的核心定位——将资深工程师的最佳实践封装成AI可复用的技能
• 掌握6阶段开发生命周期的理念与实施方法
• 学会使用7条slash命令驱动不同的开发阶段
• 理解20个结构化技能如何协同工作
• 掌握在Claude Code中安装和配置Agent Skills的方法
• 理解自动技能激活机制如何提升AI响应质量

📖 项目概述

什么是Agent Skills

Agent Skills是一套生产级工程技能框架，由Google前工程师addyosmani创建。它将资深软件工程师在真实项目中使用的工作流、质量门控和最佳实践封装成AI Agent可复用的结构化技能。

核心理念：

“Skills encode the workflows, quality gates, and best practices that senior engineers use when building software.”

核心数据

技术架构

Agent Skills 6阶段开发周期

┌──────┐    ┌──────┐    ┌──────┐    ┌──────┐    ┌──────┐    ┌──────┐
│ Idea │───▶│ Spec │───▶│ Code │───▶│ Test │───▶│ QA   │───▶│ Go   │
│Refine│    │ PRD  │    │ Impl │    │Debug │    │ Gate │    │ Live │
└──────┘    └──────┘    └──────┘    └──────┘    └──────┘    └──────┘

命令: /spec   /plan    /build    /test    /review   /code-simplify  /ship

🔄 6阶段开发生命周期

阶段详解

循环迭代

每个阶段都支持**Refine（精化）**循环：

• 如果测试失败 → 返回Build阶段修复
• 如果审查发现问题 → 返回相关阶段重做
• 如果Spec需要调整 → 返回Define阶段更新

⚡ 7条Slash命令

命令一览

自动技能激活

Agent Skills支持上下文感知的自动技能激活：

触发条件 → 自动激活技能
─────────────────────────────────────
设计API → api-and-interface-design
构建UI → frontend-ui-engineering  
编写测试 → test-driven-development
性能优化 → performance-optimization
安全修复 → security-best-practices

🛠️ 20个结构化技能

Define阶段技能

1. idea-refine

2. spec-driven-development

Plan阶段技能

3. planning-and-task-breakdown

Build阶段技能

4. incremental-implementation

5. test-driven-development

6. context-engineering

更多技能

📦 安装配置

方式一：Claude Code npx安装（推荐）

# 安装到全局
npx skills add addyosmani/agent-skills --skill agent-skills -g

# 或安装到当前项目
npx skills add addyosmani/agent-skills --skill agent-skills

方式二：手动安装

# 克隆仓库
git clone https://github.com/addyosmani/agent-skills.git

# 复制技能到Claude Code技能目录
cp -r agent-skills/skills ~/.claude/skills/

# 复制命令
cp -r agent-skills/.claude/commands ~/.claude/

验证安装

# 在Claude Code中输入
/help

# 应该看到7条新命令
/spec, /plan, /build, /test, /review, /code-simplify, /ship

🎯 核心工程原则

七大黄金原则

Anti-Rationalization表

Agent Skills包含anti-rationalization表，防止AI在测试失败时编造借口：

📊 质量门控

代码质量门控

┌─────────────────────────────────────┐
│           Code Quality Gate         │
├─────────────────────────────────────┤
│ ✅ 单元测试通过                      │
│ ✅ Lint检查通过                     │
│ ✅ 类型检查通过                     │
│ ✅ 覆盖率 ≥ 80%                    │
│ ✅ 无安全漏洞                       │
│ ✅ 性能基准达标                    │
└─────────────────────────────────────┘

Ship前检查清单

🔧 与其他框架对比

💡 最佳实践

1. 从/spec开始

# 不要直接写代码
# 先明确要做什么

/spec
# 输入: "我想做一个用户认证系统"

2. 小步快跑

# 每次只做一个功能
/build
# 任务: 实现登录功能（不包含注册、OAuth等）

# 测试通过后再做下一个

3. 测试驱动

# 先写测试
/test
# 先定义期望行为

# 然后实现满足测试

4. 频繁提交

# 每完成一个小切片就提交
git commit -m "feat: 实现登录表单基础样式"
git commit -m "feat: 添加表单验证"
git commit -m "feat: 集成登录API"

📚 资源链接

✅ 总结

Agent Skills是将专业软件工程师的工程实践转化为AI可复用技能的框架：

1. 结构化生命周期：Define→Plan→Build→Test→Review→Ship
2. 7条slash命令：直观触发不同开发阶段
3. 20个结构化技能：每个技能都是最佳实践的封装
4. 自动技能激活：上下文感知，智能响应
5. 质量门控：防止AI降低代码质量
6. Anti-Rationalization：确保AI诚实面对错误

这是一套让AI编码专业化、工程化、可信赖的实战框架。

🦞