Addy Osmani 工程技能合集（agent-skills）中文使用说明
================================================
来源：GitHub 开源项目 addyosmani/agent-skills（MIT 许可）
版本：main 主分支源码包（2026-09-23 更新）
作者：Addy Osmani（前 Google Chrome 工程负责人）
热度：GitHub 约 9.8 万星，是当前最受关注的 AI 编程技能合集


一、这是什么
------------------------------------------------
一款"把资深工程师的工作习惯写成文件"的技能合集。它不给模型加新能力，
而是把真实的工程纪律（代码审查、测试严谨性、调试方法论、API 设计规范
等）固化成一个又一个可被 AI 助手加载执行的技能。

目录结构：
  skills/      —— 各个可独立安装的技能条目
  agents/      —— 配套的子代理定义
  commands/    —— 快捷指令定义
  hooks/       —— 钩子脚本，用于在关键节点自动校验
  references/  —— 规范与参考文档
  evals/       —— 技能效果评测集
  plugin.json  —— 插件清单（支持插件式加载的工具可直接识别）
  AGENTS.md / CLAUDE.md —— 面向不同工具的入口说明


二、安装方法
------------------------------------------------
方式 A（插件式，推荐）
  在支持 plugin.json 的工具中，把整个解压目录作为插件目录加载。

方式 B（手动挑技能）
  1. 解压本压缩包，进入 skills/ 目录，里面每个文件夹是一个技能。
  2. 只挑你要的，复制到工具的技能目录：
       Claude Code：~/.claude/skills/<技能名>
  3. 新开会话生效。对 AI 说"用 <技能名> 处理这次代码审查"即可。

方式 C（团队共享）
  把整个仓库放到团队仓库中，让每位成员的 AI 工具都指向同一份技能目录，
  这样全队的 AI 输出风格与审查标准就统一了。


三、推荐先装的几个技能
------------------------------------------------
· 代码审查类：让 AI 按资深工程师标准逐条给意见，而不是笼统夸一遍。
· 测试类：要求先写失败用例、再改实现，避免"改完再补测试"。
· 调试类：强制先复现、再定位、后修复，禁止直接猜着改。
· API 设计类：命名、错误码、版本兼容性一次性对齐规范。


四、许可
------------------------------------------------
MIT License，可自由用于个人与商业项目。
