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端点
定义模块间或团队间的契约与边界
创建组件属性接口
建立影响API形态的数据库模式
npx skills add addyosmani/agent-skills --skill api-and-interface-design -g -y
通过 Chrome DevTools MCP 在真实浏览器中测试和调试前端应用。支持 DOM 检查、控制台日志分析、网络请求监控、性能剖析及视觉验证，桥接静态代码分析与运行时状态，确保 UI 修复有效。
需要调试 UI 布局或样式问题
需要分析页面性能瓶颈
需要验证前端修复在浏览器中的实际效果
需要捕获运行时控制台错误或网络请求
npx skills add addyosmani/agent-skills --skill browser-testing-with-devtools -g -y
自动化 CI/CD 流水线配置，涵盖质量门禁、构建部署流程及 GitHub Actions 实现，确保代码变更经过严格验证后安全发布。
设置新项目 CI 流水线
修改或添加自动化检查
配置部署管道
调试 CI 失败
npx skills add addyosmani/agent-skills --skill ci-cd-and-automation -g -y
提供多维度代码审查能力，涵盖正确性、可读性、架构、安全性和性能。适用于合并前、重构或Bug修复后的代码评估，旨在通过质量门禁促进代码持续改进并批准符合规范的变更。
合并PR或变更前
代码重构后
修复Bug后
审查其他Agent生成的代码
内联粘贴Diff时
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
提供系统化根因调试指南，涵盖测试失败、构建中断等场景。遵循‘停线’原则，通过复现、定位、诊断等结构化步骤查找并修复根本原因，防止错误累积。
测试失败
构建中断
运行时行为异常
收到Bug报告
日志或控制台出现错误
npx skills add addyosmani/agent-skills --skill debugging-and-error-recovery -g -y
管理代码废弃与迁移流程，涵盖旧系统下线、API替换及数据库平滑升级。旨在降低维护成本，通过决策框架平衡保留与移除，确保用户安全过渡并清理技术债务。
移除不再需要的旧系统或功能
将用户从旧实现迁移到新实现
生产环境无停机数据库模式变更
决定维持或淘汰现有代码
npx skills add addyosmani/agent-skills --skill deprecation-and-migration -g -y
用于记录架构决策(ADR)和设计选择背后的理由，捕捉上下文与权衡。适用于重大技术选型、API变更或新人入职等场景，旨在为未来工程师和Agent提供关键背景信息，避免重复解释。
需要记录架构决策
设计公共API变更
重要技术选型
新人入职引导
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组件或页面
修改现有用户界面
实现响应式布局
添加交互逻辑或状态管理
修复视觉或UX问题
npx skills add addyosmani/agent-skills --skill frontend-ui-engineering -g -y
规范 Git 工作流与版本管理，涵盖原子提交、描述性消息、Trunk-Based 开发及语义化版本控制。适用于代码变更、分支管理、冲突解决、PR 审查及发布流程，确保历史可追溯且易于回滚。
进行代码修改或提交时
创建或合并分支时
解决代码冲突时
准备发布新版本或编写 Changelog 时
npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning -g -y
通过结构化发散与收敛思维，将模糊想法提炼为可执行概念。引导用户澄清问题、压力测试假设并生成包含MVP范围的一页纸文档，辅助决策与创新构思。
ideate
refine this idea
stress-test my plan
npx skills add addyosmani/agent-skills --skill idea-refine -g -y
指导以细粒度、可验证的增量方式实现功能，通过小步快跑确保代码质量与系统稳定性。适用于多文件变更、大型重构或复杂特性开发，避免一次性编写过多代码。
实现涉及多个文件的变更
从计划中承接下一个任务
准备使用功能标志发布更改
需要编写大量代码时
任务规模过大需拆分时
npx skills add addyosmani/agent-skills --skill incremental-implementation -g -y
通过一问一答的交互方式，在需求模糊时挖掘用户真实意图，消除歧义并建立95%置信度的理解。适用于需求定义前、显式调用或发现隐性假设时，避免过早构建导致的返工。
需求描述模糊或缺失关键背景（如谁用、为何做）
用户明确发出'采访我'、'压力测试我的想法'等指令
助手察觉自己在无计划前盲目填充了模糊需求
npx skills add addyosmani/agent-skills --skill interview-me -g -y
指导在代码中添加日志、指标、追踪和告警，以增强生产环境的可观测性。适用于新特性开发、故障排查准备及PR审查，强调基于问题定义信号并采用结构化记录规范。
添加生产环境所需的日志或监控指标
排查因缺乏数据导致的故障诊断困难
设计新的服务或集成时的可观测性方案
npx skills add addyosmani/agent-skills --skill observability-and-instrumentation -g -y
指导如何系统化优化应用性能，强调先测量后修复。涵盖前端、后端及数据库瓶颈识别，提供Core Web Vitals标准与五步工作流（测量、定位、修复、验证、防护），防止过早优化。
存在性能需求或SLA指标
怀疑引入性能回归
Core Web Vitals不达标
N+1查询模式需修复
Profiling发现瓶颈
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，监控代码变更防止质量下降。用于设定覆盖率和性能阈值，阻止代理静默降低质量或跳过测试。
用户要求设置约束或定义标准
项目启动时无书面质量规范
代理静默禁用检查或跳过测试
需要设定覆盖率或性能阈值
npx skills add addyosmani/agent-skills --skill constraint-driven-development -g -y
提供Web应用安全加固指南，涵盖威胁建模、输入验证、认证授权及依赖审计。指导开发者防范OWASP Top Ten漏洞，确保数据处理与集成的安全性。
代码安全审计
处理用户输入或认证逻辑
检查第三方集成风险
依赖包漏洞排查
涉及隐私合规的场景
npx skills add addyosmani/agent-skills --skill security-and-hardening -g -y
