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 (24)
指导稳定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响应
性能分析与核心网页指标评估
npx skills add addyosmani/agent-skills --skill browser-testing-with-devtools -g -y
自动化CI/CD流水线配置，涵盖质量门禁、测试运行器及部署策略，确保代码在合并前通过Lint、类型检查、单元测试等验证，提升发布安全性与效率。
设置新项目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
优化智能体上下文配置，通过分层管理规则文件、架构文档和代码片段，解决幻觉和偏离规范问题，提升编码会话质量。
开始新的编码会话
智能体输出质量下降
切换代码库不同部分
配置项目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
发布新功能
为新成员提供项目背景
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符合WCAG标准并具备高质量视觉表现，适用于前端页面开发与交互优化。
构建新的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文档。
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
指导为生产代码添加日志、指标、追踪和告警等可观测性设施。强调在开发阶段同步编写遥测数据，定义关键问题以选择合适信号（结构化日志、指标、追踪），确保生产环境行为可见且易于诊断。
构建将在生产环境中运行的功能
添加新服务、端点或后台任务
生产事故难以诊断时补充数据
审查涉及I/O或跨服务调用的PR
npx skills add addyosmani/agent-skills --skill observability-and-instrumentation -g -y
提供基于测量的性能优化工作流，涵盖前端、后端及数据库。指导通过合成测试和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应用安全加固指南，涵盖威胁建模、输入验证、身份认证及数据隐私合规（GDPR/CCPA），旨在通过安全约束保护用户数据和系统边界。
处理用户输入或外部集成
实现身份认证与授权
涉及个人数据或隐私合规
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
在编码前创建结构化规范，明确目标与验收标准。适用于需求模糊、涉及多模块或需架构决策的场景。通过分阶段流程（范围检查、指定、计划、任务、实现）确保开发方向正确，减少返工。
启动新项目或功能
需求不明确或不完整
变更涉及多个文件或模块
需要进行架构决策
npx skills add addyosmani/agent-skills --skill spec-driven-development -g -y
指导在实现逻辑、修复bug或修改功能时遵循TDD流程，强调先写失败测试再编码。包含环境发现及RED/GREEN/REFACTOR循环步骤。
实现新功能逻辑
修复现有Bug
修改已有行为
添加边界情况处理
npx skills add addyosmani/agent-skills --skill test-driven-development -g -y
Agent技能元技能，用于发现并调用适用于当前开发阶段的具体工程工作流技能。通过识别任务类型（如编码、测试、审查等）来引导选择正确的子技能，确保遵循高级工程师的最佳实践流程。
需要发现或应用特定开发阶段的技能时
启动会话或不确定当前任务适用何种技能时
npx skills add addyosmani/agent-skills --skill using-agent-skills -g -y
