Agent Skills
› addyosmani/agent-skills
addyosmani/agent-skills
GitHub指导稳定、防误用的 API 和接口设计，涵盖 REST/GraphQL、模块边界及组件契约。强调合同优先、错误语义一致性及 Hyrum 定律，确保接口健壮性与向后兼容性。
Install All Skills
npx skills add addyosmani/agent-skills --all -g -y
Skills in Collection (25)
指导稳定、防误用的 API 和接口设计，涵盖 REST/GraphQL、模块边界及组件契约。强调合同优先、错误语义一致性及 Hyrum 定律，确保接口健壮性与向后兼容性。
设计新的 API 端点
定义模块间或团队间的接口契约
创建组件属性接口
npx skills add addyosmani/agent-skills --skill api-and-interface-design -g -y
利用 Chrome DevTools MCP 在真实浏览器环境中进行前端测试与调试。支持 DOM 检查、控制台日志分析、网络请求监控及性能剖析，帮助验证 UI 渲染、排查错误并确认修复效果。
需要验证浏览器端 UI 渲染或布局样式是否正确
需要诊断前端控制台错误或网络请求异常
需要进行前端性能分析和 Core Web Vitals 评估
npx skills add addyosmani/agent-skills --skill browser-testing-with-devtools -g -y
自动化 CI/CD 流水线配置，涵盖质量门禁、测试运行器及部署策略。用于新项目搭建、检查项修改及调试 CI 失败，确保代码在合并前通过 lint、类型检查、构建及安全审计。
设置或修改 CI/CD 流水线
配置自动化质量门禁和测试运行器
建立部署策略
调试 CI 流程失败
npx skills add addyosmani/agent-skills --skill ci-cd-and-automation -g -y
提供多维度代码审查技能，涵盖正确性、可读性、架构、安全和性能五个维度。用于在合并前评估PR或内联Diff，确保代码质量持续改进并符合项目规范。
合并代码前审查
评估他人或Agent生成的代码
重构后检查
Bug修复后的回归测试审查
npx skills add addyosmani/agent-skills --skill code-review-and-quality -g -y
用于简化代码以提升清晰度，在保持行为不变的前提下降低复杂度。适用于重构难以阅读、维护或扩展的代码，以及审查中识别出的复杂逻辑。
代码功能正常但可读性差
代码审查中发现复杂性过高
重构因赶工而编写的代码
消除深层嵌套或过长函数
npx skills add addyosmani/agent-skills --skill code-simplification -g -y
优化智能体上下文配置以提升输出质量，涵盖规则文件、架构文档及源码的层级管理。适用于新项目初始化、会话启动、任务切换或修复幻觉与规范偏离问题。
开始新的编码会话
智能体输出质量下降或出现幻觉
在不同代码库部分间切换
为新项目配置AI辅助开发环境
npx skills add addyosmani/agent-skills --skill context-engineering -g -y
提供系统化根因调试指南，涵盖测试失败、构建中断及运行时异常等场景。通过停止开发、保留证据、复现问题、定位故障层及修复根因的结构化流程，避免盲目猜测，确保高效解决未知错误。
测试用例失败
构建过程报错
运行时行为与预期不符
遇到日志或控制台中的意外错误
npx skills add addyosmani/agent-skills --skill debugging-and-error-recovery -g -y
管理代码废弃与迁移，包括移除旧系统、API或功能，以及将用户从旧实现平滑过渡到新方案。涵盖数据库无停机迁移、决策是否维持或下线现有代码，旨在降低维护成本并消除技术债务。
移除旧系统、API或库
下线不再需要的功能
生产环境数据库架构迁移（如重命名列）
决定维持或弃用现有代码
npx skills add addyosmani/agent-skills --skill deprecation-and-migration -g -y
指导记录架构决策（ADR）和技术设计背景，捕捉决策的上下文、约束与权衡。适用于重大架构选择、API变更或新功能上线时的文档沉淀，确保未来工程师和Agent能理解代码背后的原因。
进行重大架构决策
设计数据模型或数据库模式
添加或更改公共API
上线改变用户行为的新功能
为团队新人或Agent提供项目背景
npx skills add addyosmani/agent-skills --skill documentation-and-adrs -g -y
在关键决策前引入对抗性审查，通过模拟新上下文审查员质疑假设，以发现隐藏缺陷。适用于高 stakes、架构变更或代码不熟悉场景，确保正确性优先于速度。
涉及分支逻辑修改或跨模块边界
进行生产部署或数据迁移等不可逆操作
在不熟悉代码中做出非平凡决策
需要验证线程安全或不变量等编译器无法检查的属性
npx skills add addyosmani/agent-skills --skill doubt-driven-development -g -y
用于构建高质量、可访问且响应式的用户界面。涵盖组件开发、布局实现、状态管理及无障碍标准，确保UI具备生产级品质与设计感。
构建新的UI组件或页面
修改现有用户界面
实现响应式布局
添加交互逻辑或状态管理
修复视觉或用户体验问题
npx skills add addyosmani/agent-skills --skill frontend-ui-engineering -g -y
规范 Git 工作流与版本管理，涵盖原子提交、描述性消息、Trunk-Based 开发及语义化版本控制，确保代码变更可追溯且易于协作。
进行代码提交或分支操作
解决合并冲突
发布版本或编写变更日志
npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning -g -y
通过结构化发散与收敛思维，将模糊想法提炼为可执行概念。适用于需要完善创意、压力测试假设或扩展选项的场景。
idea is still vague and needs shaping
stress-test assumptions before committing to a plan
expand options before converging on one
npx skills add addyosmani/agent-skills --skill idea-refine -g -y
指导以细粒度切片方式实现功能，确保每步可测试验证。适用于多文件修改、新特性开发及重构，避免一次性编写过多代码。
需要修改多个文件的任务
从计划中接手新任务
准备进行大型代码编写时
使用功能开关发布变更
npx skills add addyosmani/agent-skills --skill incremental-implementation -g -y
通过一问一答的方式澄清用户真实意图，适用于需求模糊、缺少背景或明确约束的场景。在制定计划前挖掘核心目标，避免基于错误假设构建，确保需求定义准确。
需求描述模糊或缺少关键上下文
用户明确要求进行深度访谈或压力测试
npx skills add addyosmani/agent-skills --skill interview-me -g -y
指导为生产代码添加日志、指标、追踪和告警，确保系统可观测性。适用于新功能上线、服务集成及排查因数据缺失导致的故障，强调在编码阶段同步实施遥测采集。
构建将在生产环境运行的功能
添加新服务或外部集成
生产故障因缺乏数据难以诊断
设置或审查告警规则
npx skills add addyosmani/agent-skills --skill observability-and-instrumentation -g -y
提供性能优化技能，指导基于测量的瓶颈识别与修复流程。覆盖前端、后端及数据库，包含Core Web Vitals标准、合成/RUM测量方法及防回归策略，避免过早优化。
存在性能指标要求或SLA
怀疑引入性能回退
Core Web Vitals评分低
N+1查询问题
需要分析性能瓶颈
npx skills add addyosmani/agent-skills --skill performance-optimization -g -y
将需求分解为有序、可验证的任务，明确依赖关系与验收标准。适用于需求过大、需并行处理或实现顺序不明的场景。通过垂直切片和依赖图规划，确保任务小而专注，提升交付可靠性。
需求规格清晰但任务规模过大难以着手
需要估算工作量或并行分配任务
实现顺序不明确或存在复杂依赖
npx skills add addyosmani/agent-skills --skill planning-and-task-breakdown -g -y
提供生产环境发布前的全面检查清单，涵盖代码、安全、性能及基础设施等维度，并包含特性开关策略与回滚方案指导。
准备部署到生产环境
制定发布前检查清单
规划灰度发布或分批上线
设计回滚策略
npx skills add addyosmani/agent-skills --skill shipping-and-launch -g -y
一种基于官方文档的开发技能，通过检测技术栈版本、获取权威文档并严格遵循其最佳实践来生成代码，确保实现的准确性与时效性，适用于对正确性要求高的框架开发场景。
用户要求基于官方文档验证实现方案
需要生成符合最新最佳实践的框架特定代码
用户明确要求引用来源以确保代码权威性
npx skills add addyosmani/agent-skills --skill source-driven-development -g -y
规范驱动开发技能，要求在编码前编写结构化规格说明书。适用于新项目、需求模糊或复杂变更场景，通过分阶段工作流确保目标明确，避免盲目编码。
启动新项目或功能开发
需求不明确或存在歧义
涉及多模块的架构决策
npx skills add addyosmani/agent-skills --skill spec-driven-development -g -y
指导使用红绿重构循环进行开发，强调先写失败测试再实现代码。适用于新逻辑、修复Bug或修改行为场景，确保代码正确性。
实现新功能逻辑
修复现有Bug
修改已有功能行为
为函数添加测试
npx skills add addyosmani/agent-skills --skill test-driven-development -g -y
这是一个元技能，用于发现、选择并调用其他工程工作流技能。它帮助代理根据当前任务阶段（如需求澄清、编码、测试、审查等）匹配最合适的专用技能，确保按资深工程师的标准流程执行。
开始新会话或任务时
需要决定适用哪个技能或工作流时
npx skills add addyosmani/agent-skills --skill using-agent-skills -g -y
建立项目质量标准的书面契约，通过访谈确定维度与阈值并记录在CONSTRAINTS.md中。监控代码变更防止质量降级，确保可访问性、性能和覆盖率等指标得到强制执行。
用户要求设置质量标准或约束
项目启动时无明确质量规范
Agent静默降低质量阈值或跳过测试
需要设定具体的覆盖率和性能目标
npx skills add addyosmani/agent-skills --skill constraint-driven-development -g -y
提供Web应用安全开发实践，涵盖威胁建模、输入验证、认证授权及合规性检查。用于审计漏洞、加固代码及评估供应链风险。
审计输入处理程序或登录流程的安全性
构建涉及用户输入、会话管理或第三方集成的功能
审查依赖包漏洞或隐私合规问题
npx skills add addyosmani/agent-skills --skill security-and-hardening -g -y
