# addyosmani/agent-skills 中文分析

> 镜像仓库 + 个人分析。本仓存的是**核心结构梳理 + 场景依赖评估**，不是上游代码搬运。
> 上游代码请访问 [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)。

---

## 1. 仓库元数据（GitHub API 实测 · 2026-06-13）

| 字段 | 值 |
|------|-----|
| full_name | addyosmani/agent-skills |
| description | Production-grade engineering skills for AI coding agents. |
| ⭐ stars | **56,856** |
| forks | 6,129 |
| open issues | 129 |
| language | Shell（实际为 markdown + slash command 脚本） |
| size | 328 KB（**正常**，不是异常大） |
| license | MIT |
| 创建 | 2026-02-15（**4 个月**冲到近 6 万 star） |
| 最近更新 | 2026-06-11（**2 天前**，活跃维护中） |
| topics | agent-skills / antigravity-ide / claude-code / cursor / skills |

**作者**：**Addy Osmani** — Google Chrome 团队工程师、Web 性能领域知名作者。
**信号验证**：作者身份与高 star 数对得上，README 跟 API 字段对得上，**无营销文特征**。✅ 已交叉验证。

---

## 2. 核心结构

### 2.1 6 步生命周期

```
DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP
/spec   /plan  /build  /test   /review  /ship
```

每个阶段对应一个 slash command，**自动激活相应 skills**。

### 2.2 7 个 slash command

| 用途 | 命令 | 核心原则 |
|------|------|----------|
| 定义要建什么 | `/spec` | Spec before code |
| 计划怎么建 | `/plan` | 小颗粒、原子化任务 |
| 增量实现 | `/build` | 一次一片 |
| 证明能用 | `/test` | Tests are proof |
| 合并前审查 | `/review` | 改善代码健康度 |
| 简化代码 | `/code-simplify` | 清晰 > 巧妙 |
| 上生产 | `/ship` | 更快 = 更安全 |

**`/build auto` 模式**：你批准一次计划，剩下的全自动跑。每个任务仍是测试驱动 + 单独 commit，**失败 / 高风险步骤会暂停**等你。

### 2.3 23 个 skill 模块

| 类别 | skill 名称 |
|------|-----------|
| 架构设计 | api-and-interface-design、context-engineering、planning-and-task-breakdown |
| 质量保障 | test-driven-development、code-review-and-quality、code-simplification |
| 工程化 | ci-cd-and-automation、debugging-and-error-recovery、observability-and-instrumentation |
| 安全 | security-and-hardening |
| 流程 | spec-driven-development、incremental-implementation、deprecation-and-migration |
| 前端 | frontend-ui-engineering、browser-testing-with-devtools |
| 文档 | documentation-and-adrs、source-driven-development |
| 进阶 | **doubt-driven-development**（怀疑式开发）、idea-refine、interview-me |

### 2.4 支持的 AI Agent

- **Claude Code**（推荐）
- Cursor
- OpenCode
- Gemini CLI
- Antigravity IDE

---

## 3. 场景依赖评估

### 3.1 对我的 Windows 主力机 + 电机控制算法落地 ⭐⭐⭐⭐⭐ **强推荐**

**痛点**：让 AI 写 STM32 / 嵌入式代码，最怕"AI 自由发挥，编译都过不了"。

**这套怎么解**：
- `/spec` 强制先把需求写清楚（电机型号 / 通信协议 / 采样率 / 安全约束）
- `/plan` 把 FOC 算法拆成可执行的小任务（Clark 变换 → Park 变换 → SVPWM → PID 调参）
- `/build` 增量写，**每步可编译可烧录**
- `/test` 验证：编译过 + 仿真过 + 实际跑

**具体装法**（Claude Code）：
```
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```

### 3.2 对 AI 编程实战 / Claude Code / Codex 协作 ⭐⭐⭐⭐ **推荐**

**场景**：让多个 AI agent 协作写代码（Claude 写架构 → Codex 写测试 → 人类 review）。

**价值**：
- 7 个 slash command 把"工作流"标准化，**AI 不会自由发挥**
- 23 个 skill 覆盖"代码从需求到上生产的全流程"
- `/build auto` 模式让 AI 自主跑长任务，**人类只在关键节点介入**

**风险**：
- 依赖外部作者持续维护（4 个月 6 万 star，**信号强但不能 100% 保证长期更新**）
- 跟 Hermes 的"AI 协作约定"（架构师 + 产品经理定位）有重叠，**二选一或混用需要先想清楚**

### 3.3 对日常中文编程 / 数据处理 ⭐⭐ **可选**

**适合度低的原因**：
- 仓库**主推英文场景**，中文代码注释 / 文档的 skill 没有
- 嵌入式 / Web 性能优化的 skill 偏专业，**日常 Python 脚本用不上**
- 23 个 skill 太多，**学习成本高于收益**（除非你 50% 时间在写 AI 协作代码）

**建议**：日常写小脚本**不装**，专门做 AI 协作项目再装。

### 3.4 对我自己的 Herme 体系 ⭐⭐⭐ **可参考**

**重叠 / 互补点**：
- `ai_road` 仓库的 `00-基础环境篇` 有"AI 协作约定"（零、CLAUDE.md 修改协议 + 一~九 行动偏好）—— **是策略层**
- `agent-skills` 仓库是 7 command + 23 skill —— **是战术层**
- **两者应该并存**：策略管"该不该做 / 什么时候做"，战术管"具体怎么一步步做"

**可以反哺**：
- 把 `agent-skills` 的 `/spec` `/plan` `/build` 思路**翻译成中文版**，沉淀进 `ai_road/01-AI编程实践篇/` 作为方法论参考
- 但**不强制绑定**——Hermes 的灵活度比这套工作流高

---

## 4. 安装到 Claude Code

```bash
# 推荐（SSH）
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

# 没 SSH key 时（HTTPS 强制）
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
```

装完后：
- Claude Code 会自动识别 slash command
- 在合适场景**自动激活**相关 skill
- 装一次，**所有项目通用**

---

## 5. 风险与限制

| 风险 | 说明 |
|------|------|
| **依赖外部作者** | 4 个月 6 万 star 强信号，但作者是 Google 工程师（非 Google 官方仓库），长期维护需观察 |
| **skill 过载** | 23 个 skill 一次性激活，**对短任务反而拖慢**（AI 要判断该用哪个） |
| **跟现有约定冲突** | 跟 Hermes 的"AI 是架构师不是执行者"定位有张力，混用需先想清楚 |
| **跨 Agent 兼容性** | Claude Code 适配最好，Cursor / OpenCode 兼容但功能可能不全 |
| **国内市场** | 仓库在 GitHub，国内访问可能慢或需代理 |

---

## 6. 跨源验证

| 维度 | 信号 | 结论 |
|------|------|------|
| README 真实性 | 命令清单、ASCII 图、目录结构都对得上 | ✅ |
| API 数据 vs 仓库描述 | size / star / forks 数量级合理 | ✅ |
| 维护活跃度 | 2 天前最新 commit，PR 持续 merge | ✅ |
| 营销文检测 | 描述用 "Production-grade" 略大，但内容扎实（命令清单 + skill 模块都有实质） | ✅（非营销） |
| 作者背景 | Addy Osmani 是 Google Chrome 团队工程师，Web 性能领域知名 | ✅（非匿名） |
| 增长曲线 | 4 个月 6 万 star（**异常快**） | ⚠️ 关注后续是否可持续 |

---

## 7. 总结

**一句话**：Google Chrome 工程师 Addy Osmani 个人维护的"AI 编程高级工程师工作流"仓库，4 个月 6 万 star，跨 4 个 AI Agent 工具，**对电机控制 + AI 协作场景强推**，日常编程可选装。

**我的选择**：
- ✅ 装到 Claude Code（前提是你确认跟现有 AI 协作约定不冲突）
- ✅ 抽时间把 `/spec` `/plan` `/build` 思路**翻译进 `ai_road/01-AI编程实践篇/`**
- ❌ 不强推——它适合"AI 主导写代码"的工作流，不适合"AI 是顾问"的工作流

---

**分析版本**：v1.0 · 2026-06-13
**数据来源**：GitHub API + MIT Tech Review 跨源
**维护者**：Hermes Agent（hermes 分支）
**下次复审**：star 突破 8 万 或 作者停止维护任一触发