Agent Skills
› addyosmani/agent-skills
addyosmani/agent-skills
GitHub指导稳定API和接口设计，涵盖REST、GraphQL及模块边界。强调契约优先、错误语义一致性及Hyrum定律，旨在创建易用且难误用的公共接口规范。
安装全部 Skills
npx skills add addyosmani/agent-skills --all -g -y
集合内 Skills (25)
指导稳定API和接口设计，涵盖REST、GraphQL及模块边界。强调契约优先、错误语义一致性及Hyrum定律，旨在创建易用且难误用的公共接口规范。
设计新的API端点
定义模块间契约或边界
创建组件属性接口
建立影响API形态的数据库模式
npx skills add addyosmani/agent-skills --skill api-and-interface-design -g -y
通过 Chrome DevTools MCP 在真实浏览器中执行 UI 测试、DOM 检查、网络分析及性能剖析，验证前端运行时行为。
调试 UI 布局或样式问题
分析控制台错误或警告
验证 API 网络请求
进行前端性能优化分析
npx skills add addyosmani/agent-skills --skill browser-testing-with-devtools -g -y
自动化CI/CD流水线配置，涵盖质量门禁、测试运行器及部署策略。用于新项目初始化、检查项修改及CI故障排查，确保代码在合并前通过Lint、类型检查、测试等关卡。
设置或修改构建和部署流水线
自动化质量门禁配置
调试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 Agent上下文配置以提升输出质量，适用于新会话启动、任务切换或模型表现下降时。通过分层管理规则文件、架构文档和源码，确保Agent获取精准信息，减少幻觉并遵循项目规范。
开始新的编码会话
Agent输出质量下降或出现幻觉
在不同代码库部分间切换
为AI辅助开发设置新项目
Agent未遵循项目约定
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变更或功能发布时使用，优先匹配项目现有规范。
需要记录架构决策
解释设计选择的理由
变更公共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
构建生产级、可访问且响应式的用户界面。用于创建组件、实现布局、管理状态及修复UX问题，确保符合设计系统与无障碍标准，避免AI生成感。
构建新的UI组件或页面
修改现有用户界面
实现响应式布局
添加交互或状态管理
修复视觉或UX问题
npx skills add addyosmani/agent-skills --skill frontend-ui-engineering -g -y
规范 Git 工作流与版本管理，指导原子提交、分支策略及语义化版本控制，确保代码变更可追溯且易于回滚。
进行代码提交或分支操作
解决冲突或拆分未提交工作
创建发布标签或编写变更日志
npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning -g -y
通过发散与收敛思维，将模糊想法转化为可执行概念。引导用户澄清问题、压力测试假设并生成包含MVP范围的Markdown文档。
帮助我完善这个想法
对[概念]进行构思
压力测试我的计划
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
提供生产环境发布前的检查清单，涵盖代码、安全、性能及基础设施等维度，并指导特性标志策略与回滚规划，确保发布安全可控。
准备部署到生产环境
制定发布前检查清单
规划灰度发布或分阶段 rollout
制定回滚策略
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，持续监控代码变更防止质量标准降低。
用户要求设置约束或定义标准
项目中无明确的质量门槛
Agent静默降低质量或跳过测试
需要设定覆盖率或性能阈值
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
