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 渲染或样式是否正确
调试浏览器端的 JavaScript 错误或性能瓶颈
进行自动化 UI 测试或可视化对比
分析前端网络请求和 API 响应数据
npx skills add addyosmani/agent-skills --skill browser-testing-with-devtools -g -y
自动化CI/CD流水线配置，涵盖质量门禁、测试运行及部署策略。通过GitHub Actions实现从Lint到安全审计的全流程自动化，确保代码变更在合并前经过严格验证，提升发布效率与安全性。
设置新项目CI流水线
修改自动化检查规则
配置部署管道
调试CI失败问题
npx skills add addyosmani/agent-skills --skill ci-cd-and-automation -g -y
提供多维度的代码审查能力，涵盖正确性、可读性、架构、安全和性能五个维度。在合并前对代码进行质量评估与把关，确保代码健康度持续提升，适用于个人、其他智能体或人类编写的代码审查场景。
合并PR或变更前
完成功能实现后
审查其他智能体生成的代码
重构现有代码
修复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代理上下文配置，通过分层管理规则文件、文档和代码片段，提升输出质量并减少幻觉。
开始新的编码会话
代理输出质量下降或出现幻觉
在不同代码库部分间切换
为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或功能的移除及用户平滑过渡。涵盖决策评估、策略选择（强制/建议）及生命周期规划，旨在降低维护成本并消除技术债务。
移除不再需要的旧系统、API或功能
将用户从旧实现迁移到新实现
决定是否维持或下线现有代码
npx skills add addyosmani/agent-skills --skill deprecation-and-migration -g -y
记录架构决策和上下文文档，特别是编写架构决策记录（ADR），解释技术选型、API变更及功能交付背后的原因与权衡，便于团队理解代码背景。
做出重大架构决策
变更公共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组件或页面
修改现有用户界面
实现响应式布局
添加交互逻辑或状态管理
修复视觉或UX问题
npx skills add addyosmani/agent-skills --skill frontend-ui-engineering -g -y
规范 Git 工作流与版本控制，涵盖提交、分支管理、冲突解决及发布流程。指导团队采用主干开发模式，确保原子化提交和语义化版本，提升代码可追溯性与协作效率。
进行代码变更或提交
创建或合并分支
解决代码冲突
打开或审查 Pull Request
发布新版本或编写更新日志
npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning -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
指导应用性能优化流程，强调先测量后优化。涵盖前端、后端及数据库瓶颈识别，提供 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
提供Web应用安全开发实践，涵盖威胁建模、输入验证、认证授权及数据保护。指导在涉及用户输入、敏感数据存储或外部集成时进行代码加固，防范常见漏洞。
实现身份认证或授权功能
处理用户输入或外部API集成
存储或传输敏感数据如PII
涉及隐私合规要求
npx skills add addyosmani/agent-skills --skill security-and-hardening -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
规范驱动开发技能，要求在编码前编写结构化规格说明书。通过范围检查、指定、规划和实现四个阶段，确保需求清晰和架构决策正确，适用于新项目或复杂功能开发。
开始新项目或新功能
需求模糊或不完整
涉及多个文件或模块的变更
需要进行架构决策
任务预计耗时超过30分钟
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
