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 布局或样式问题
分析控制台错误或警告
检查网络请求与 API 响应
性能剖析与 Core Web Vitals 评估
npx skills add addyosmani/agent-skills --skill browser-testing-with-devtools -g -y
自动化CI/CD流水线配置，涵盖质量门禁、测试运行器及部署策略。用于新项目初始化、检查添加或CI故障排查，确保代码在合并前通过严格验证。
设置新项目CI流水线
修改自动化检查规则
配置部署流程
排查CI构建失败
npx skills add addyosmani/agent-skills --skill ci-cd-and-automation -g -y
执行多维代码审查，涵盖正确性、可读性、架构、安全性和性能五个维度。用于合并前评估PR或代码变更，确保代码质量并持续改进，不追求完美但需提升整体健康度。
合并任何PR或代码变更前
需要评估其他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
优化智能体上下文配置以提升输出质量，涵盖规则文件、架构文档及代码加载策略。
开始新编码会话
智能体输出质量下降
切换任务或代码模块
配置项目上下文
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或功能，以及将用户从旧实现平滑迁移至新方案。涵盖决策评估、迁移策略（建议/强制）及核心原则，旨在降低维护成本并安全下线遗留代码。
需要移除不再使用的旧系统、API或库
计划下线特定功能或合并重复实现
在生产环境中进行数据库 schema 迁移
评估是否应维护或终止现有代码的生命周期
npx skills add addyosmani/agent-skills --skill deprecation-and-migration -g -y
记录架构决策和文档，捕获技术选型、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符合设计系统规范，避免AI生成感。
构建新的UI组件或页面
修改现有用户界面
实现响应式布局
添加交互或状态管理
修复视觉或UX问题
npx skills add addyosmani/agent-skills --skill frontend-ui-engineering -g -y
通过结构化发散与收敛思维，将模糊想法精炼为可执行概念。适用于需求澄清、假设压力测试及方案扩展，输出包含问题陈述、MVP范围等的Markdown文档。
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
通过单轮提问澄清用户真实意图，在需求模糊时避免错误假设。适用于需求不明确或用户主动要求深度探讨的场景，旨在构建高置信度的目标认知。
需求描述模糊或缺少关键背景（如用户、成功标准）
用户显式请求进行深度访谈或压力测试思考
npx skills add addyosmani/agent-skills --skill interview-me -g -y
指导为生产环境代码添加日志、指标、追踪和告警，确保系统可观测性。用于新功能上线前定义遥测问题、选择合适信号类型及规范结构化日志编写，提升故障诊断效率。
构建将运行在生产环境的特性
新增服务或外部集成
生产事故因缺乏数据导致诊断困难
设置或审查告警规则
npx skills add addyosmani/agent-skills --skill observability-and-instrumentation -g -y
提供基于测量的应用性能优化工作流，涵盖前后端及数据库。指导如何识别瓶颈、修复问题并验证效果，防止过度优化。
存在性能要求或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
指导基于测试驱动开发(TDD)的实践，强调红绿重构循环。用于新功能实现、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
规范 Git 工作流与版本控制，涵盖提交、分支管理、PR 审查及语义化版本发布。提供原子提交、描述性消息等最佳实践，确保代码变更可追溯、易回滚且利于协作。
进行代码提交或编写提交信息
处理合并冲突或拆分未提交的工作
制定发布计划或选择版本号
npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning -g -y
提供Web应用安全开发与加固指南，涵盖威胁建模、STRIDE分析及输入验证、认证授权、数据加密等核心实践。
审计代码漏洞
处理用户输入或登录流程
检查第三方集成安全
评估依赖包风险
涉及隐私合规
npx skills add addyosmani/agent-skills --skill security-and-hardening -g -y
