1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | performance-optimization-addyosmani-agent-skills |
| 项目自述名称 | Agent Skills（合集仓库总名；本 skill 子目录名为 performance-optimization） |
| 作者/维护者 | Addy Osmani（创建者，前 Google Chrome 团队工程师），Federico Bartoli、Joan León（协作者） |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/performance-optimization |
| 许可证 | MIT |
| GitHub Stars | 78,573（来源：GitHub API，注：为合集仓库整体数据，非该子技能独占，见第 6 章说明） |
| Forks | 8,436（来源：GitHub API） |
| 最新版本 | 0.6.4（2026-07-12 发布，来源：GitHub Releases API） |
| 安装方式 | npx skills add 通用 CLI，或 Claude Code 插件市场 |
2. 功能介绍与亮点
performance-optimization 是 Addy Osmani 主创的 agent-skills 工程技能合集中的旗舰技能之一，对应合集 README 首图 8 个命令中的 /webperf，并配有专属的 web-performance-auditor 子代理协同工作。核心能力：
- “先测量后优化”工作流：测量→定位→修复→验证→防护五步闭环，明确反对“没有证据的优化”。
- 双轨测量方法：Synthetic（Lighthouse/DevTools Performance）与 RUM（web-vitals 库/CrUX）并重，前者适合 CI 回归检测，后者验证真实用户体验。
- 症状-诊断决策树：从“首屏慢/交互卡顿/导航后慢/后端慢”四类症状出发，逐层引导定位根因，覆盖前端渲染、后端查询、网络链路。
- 反模式代码对照：N+1 查询、无分页拉取、图片未优化、React 无谓重渲染、大包体积、缓存缺失——每类给出“错误示例 vs 正确示例”代码片段。
- 量化性能预算：给出 Core Web Vitals（LCP/INP/CLS）分档阈值与包体积、响应时间等可执行预算，并提供 CI 集成命令（bundlesize、Lighthouse CI）。
亮点：纯 Markdown 提示词技能，零依赖零外联；覆盖前端与后端双侧，不限定单一框架；作者具真实身份与行业公信力；合集近 3 个月持续更新，该子技能本身最近一次提交为 2026-07-07。
3. 适用场景
所属分类：工程效率与代码质量
适合初中级开发者在遇到页面加载慢、交互卡顿、Core Web Vitals 不达标，或怀疑某次改动引入性能回归时使用——先建立测量基线、定位真实瓶颈，再动手修复，避免凭感觉做“过早优化”。功能仍在开发、尚无性能证据的阶段不建议使用，文档本身也明确标注“没有证据不要优化”。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——提供插件市场安装（
/plugin marketplace add+/plugin install）与本地插件目录两种方式 - Codex：✅ 原生支持——README 明确列入“70+ 已验证平台”清单，可通过通用
npx skills addCLI 安装 - OpenClaw：❓ 未验证——官方文档未提及
- Hermes Agent：❓ 未验证——同上
以上结论依据为仓库 README 与 SKILL.md 的公开内容。
5. 推荐理由
先测量后优化的性能工作流，覆盖前后端与数据库，用决策树和反模式对照帮初中级开发者避免无依据的过早优化。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 合集仓库 78.6k stars，但该数字属整个合集、不代表本技能自身热度；就该技能自身而言：README 首图列为 8 个旗舰命令之一（/webperf），并配有专属 web-performance-auditor 子代理（合集中仅少数技能享有此待遇），作者本人博客（addyosmani.com）记录合集从 27K 增长到当前规模的持续关注度，且被 trendshift.io 收录为 GitHub Trending 项目 |
| 可用性 | 9 | 两种一键安装方式（通用 CLI / Claude Code 插件市场）；SKILL.md 含完整方法论、决策树、多语言代码示例与 CI 集成命令；该子目录最近提交 2026-07-07（9 天前，近 3 个月内持续维护）；MIT 许可，无付费依赖 |
| 安全性 | 9 | 该技能目录内仅含一个 SKILL.md 文件，无脚本、无可执行代码；文中出现的 Lighthouse/bundlesize 等命令均为供人参考的可选诊断命令，非技能自动执行；不联网、不要求 API Key/凭据；全文人工审阅未发现可疑指令；作者为可验证真实身份的公开人物，License 明确（MIT） |
| 综合 | 8.7 | 三项均值 |
安全检查清单逐项：①无 shell 执行（纯 Markdown 提示词，文中命令仅供人工参考）②不联网外发数据③不要求凭据④全文审阅无 prompt injection 迹象⑤作者信誉高，真实身份可查⑥License 为 MIT，明确⑦最近一次提交 2026-07-07，维护活跃
7. 跟同类 Skills 相比的优势
| 方案 | 形态 | 生态位 | 差异化 |
|---|---|---|---|
| performance-optimization（本推荐） | 纯 Markdown 技能，随 Agent Skills 装 | 与同合集 debugging-and-error-recovery、code-review-and-quality 等技能互补 | 前后端通吃，非框架绑定；自带量化预算与 CI 集成命令，而非泛泛而谈 |
合集内 code-simplification |
同合集姊妹技能 | 关注可读性而非性能 | 二者互补：本技能关注“跑得快”，它关注“看得懂” |
合集内 debugging-and-error-recovery |
同合集姊妹技能 | 系统化排障 | 性能回归往往由 debugging 流程发现问题、再转交本技能定位与修复 |
核心差异：市面上通用“性能优化建议”多是散装 checklist，本技能的价值在于把“测量先行”做成不可跳过的强制步骤，并把具体反模式代码固化为可复用的对照表，安装成本几乎为零。
8. 用户评价
可查到的公开表述来自作者 Addy Osmani 本人在其博客（addyosmani.com/blog/agent-skills/）中对合集设计理念的说明：“A senior engineer’s job is mostly the parts that don’t show up in the diff”——用工作流强制暴露这些隐性工作，而非依赖 Agent 自觉。该文记录合集当时已“crossed 27K stars”。
除作者本人之外，该技能目前在第三方平台尚无具名用户评价。可参考的客观采用信号是合集仓库的 stars/forks 规模与 GitHub Trending 收录记录（见第一章与第九章）。
9. 其他补充
该技能是合集 24 个技能中的 1 个，合集本身在 GitHub Trending 有收录记录（trendshift.io）。合集采用滚动版本号（当前 0.6.4），未见传统意义上的里程碑式 changelog。
10. 安装使用方式
方式一（通用，推荐用于 Codex / 其他兼容 Agent）：
npx skills add addyosmani/agent-skills --skill performance-optimization方式二（Claude Code 插件市场）：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills方式三（本地开发）：
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills安装后无需重启，Agent 会在检测到“性能问题/Core Web Vitals 不达标/怀疑回归”等场景时自动触发该技能，也可通过 /webperf 命令主动调用。
11. 注意事项
- 该技能强调“先有证据再优化”，对尚处早期原型、性能尚非关注点的项目意义有限
- OpenClaw、Hermes Agent 的兼容性未经官方文档确认，实际使用前建议先小范围验证
- 受欢迎程度数据基于合集仓库整体统计，非该子技能独立数据，需理性看待
- 文档中列出的 Lighthouse/APM 等工具需自行安装配置，技能本身不代为安装