一句话

Addy Osmani 的 25 个工程技能，按 define、plan、build、verify、review、ship 生命周期覆盖 AI 编码全流程；全部模型调用，靠 description 自动激活。

定位与安装

• 仓库 addyosmani/agent-skills：把高级工程师的工作流、质量门禁、惯例打包成 SKILL.md，让 agent 每次都照做。
• 技能全部是模型调用：宿主按 description 匹配任务自动激活，用户不点名。
• 安装：npx skills add addyosmani/agent-skills（skills CLI，支持 70+ 宿主）；Claude Code 用插件市场 /plugin install agent-skills@addy-agent-skills；Cursor 放 .cursor/skills/。
• 单技能安装只拷 skills/<name>/，不拷仓库级 references/ 清单，要完整用整库装或手工补。
• 别把仓库根的 AGENTS.md、CLAUDE.md 拷进项目，那是给本仓库贡献者用的。

入口与用法

• 9 个命令（.claude/commands/，另有 commands/*.toml 版本）：/spec 写 SPEC、/plan 拆任务、/build 实现下一片、/build auto 一次批准跑完全部任务、/test 走 TDD（bug 用 Prove-It）、/constraints 定质量底线、/review 五轴评审、/code-simplify 简化、/webperf Web 性能审计、/ship 发布检查。Claude Code 里同名内置命令用命名空间形式，如 /agent-skills:review。
• 4 个人格（agents/）：code-reviewer（五轴评审）、security-auditor（OWASP 审计）、test-engineer（测试策略）、web-performance-auditor（Core Web Vitals）。人格是「谁」、技能是「怎么干」、命令是「什么时候」；/ship 并行扇出前三个人格再合并出 go/no-go；编排的硬规则是用户或命令当 orchestrator、人格不调人格，深度最多一层（references/orchestration-patterns.md）。
• 钩子（hooks/）：sdd-cache-*.sh 给 source-driven-development 做文档缓存，复用时按 304 向源站重验证；simplify-ignore.sh 让 /code-simplify 跳过 simplify-ignore-start/end 标注块；session-start.sh 会话启动钩子。
• 参考（references/）：accessibility-checklist、definition-of-done、observability-checklist、orchestration-patterns、performance-checklist、security-checklist、testing-patterns；技能目录下另有 floor-guard.md、optimization-patterns.md、hardening-patterns.md。

技能索引

按生命周期分组（元技能单独列）：

• 元：addy-using-agent-skills 路由器，宿主没原生路由时才常驻。
• Define：addy-interview-me 访谈出真实意图 · addy-idea-refine 发散收敛成 one-pager · addy-spec-driven-development spec 加人工门禁 · addy-constraint-driven-development 质量底线契约
• Plan：addy-planning-and-task-breakdown 拆带验收标准的任务到 tasks/
• Build：addy-incremental-implementation 竖切片增量 · addy-test-driven-development 红绿重构 · addy-context-engineering 上下文五层 · addy-source-driven-development 官方文档驱动 · addy-doubt-driven-development 对抗性复核 · addy-api-and-interface-design 稳定接口契约 · addy-frontend-ui-engineering 生产级 UI
• Verify：addy-debugging-and-error-recovery 根因调试 · addy-browser-testing-with-devtools DevTools MCP 实测
• Review：addy-code-review-and-quality 五轴评审 · addy-code-simplification 行为不变简化 · addy-security-and-hardening STRIDE 加固 · addy-performance-optimization 先测量再优化
• Ship：addy-git-workflow-and-versioning 原子提交与 semver · addy-ci-cd-and-automation 质量门禁流水线 · addy-observability-and-instrumentation 日志指标 trace 告警 · addy-documentation-and-adrs ADR 与文档 · addy-deprecation-and-migration 退役与迁移 · addy-shipping-and-launch 发布检查与回滚

本机状态

• same 16 个，outdated 9 个，missing 0 个。
• outdated：api-and-interface-design、code-review-and-quality、documentation-and-adrs、frontend-ui-engineering、idea-refine、performance-optimization、shipping-and-launch、spec-driven-development、test-driven-development。多数只差文档段落；code-review、documentation、idea-refine、performance、spec 五个有行为差异，见各笔记的提示框。

使用建议

• 别一次加载 25 个：按阶段加载或交给宿主路由；宿主有原生路由就不要常驻 using-agent-skills，避免两个路由器抢同一任务。
• 最小起步三件套：spec-driven-development、test-driven-development、code-review-and-quality。
• 省 token：命令需要时才敲；/build 单片推进比 /build auto 可控；references 清单按需翻不预载；人格扇出只留给 /ship 或高风险改动。
• 新项目走全生命周期，老项目走 incremental、verification-first 路线（docs/adoption-guide.md）。

关联

• 首页：00-首页 · 对比：02-仓库对比 · 术语：01-术语表
• 工作流：W1-快修、W2-单会话功能、W3-多会话功能、W4-大型模糊项目、W5-接手老项目与技术调研、W6-高风险加固层、W7-交付与运维循环