hwd32/addyosmani-agent-skills-mirror
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
addyosmani-agent-skills-mirror/ANALYSIS.md
T

7.6 KiB
Raw Permalink Blame History

addyosmani/agent-skills 中文分析

镜像仓库 + 个人分析。本仓存的是核心结构梳理 + 场景依赖评估，不是上游代码搬运。 上游代码请访问 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

# 推荐（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 万 或 作者停止维护任一触发

Reference in New Issue View Git Blame Copy Permalink