Agent Skills
› addyosmani/agent-skills
addyosmani/agent-skills
GitHub指导稳定API和接口设计，涵盖REST/GraphQL端点、模块边界及组件契约。强调合同优先、一致错误语义及Hyrum定律，确保接口易用且不易误用，适用于新接口设计与现有接口变更场景。
安装全部 Skills
npx skills add addyosmani/agent-skills --all -g -y
集合内 Skills (24)
指导稳定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 布局或样式问题
分析浏览器端控制台错误或警告
检查网络请求和 API 响应数据
进行前端性能分析和优化
npx skills add addyosmani/agent-skills --skill browser-testing-with-devtools -g -y
自动化CI/CD流水线配置，涵盖质量门禁、测试运行器及部署策略设置。用于新项目初始化、检查项修改或CI故障排查，确保代码在合并前通过Lint、类型检查、测试等严格验证。
设置新项目CI流水线
添加或修改自动化检查规则
配置部署管道
调试CI构建失败
npx skills add addyosmani/agent-skills --skill ci-cd-and-automation -g -y
用于在代码合并前进行多维度质量审查，涵盖正确性、可读性、架构、安全性和性能五个维度。旨在评估代码健康度并促进持续改进，适用于个人、其他Agent或人类编写的代码评审场景。
合并PR或变更前
功能实现完成后
需要评估其他Agent生成的代码时
重构现有代码时
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
提供系统化根因调试指南，涵盖测试失败、构建中断及运行时错误等场景。通过停止变更、保留证据、复现问题、定位层级和修复根因的结构化流程，避免盲目猜测，确保高效解决各类意外错误。
测试用例执行失败
项目构建过程报错
代码行为与预期不符
日志或控制台出现异常错误
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调整及新成员入职，旨在为未来工程师和Agent提供必要的理解依据。
进行重大架构决策
设计数据模型或选择框架
添加或修改公共API
为新成员或Agent编写项目上下文文档
npx skills add addyosmani/agent-skills --skill documentation-and-adrs -g -y
一种在关键决策前引入对抗性审查的纪律，旨在通过新鲜上下文验证假设，防止因上下文累积导致的错误判断，适用于高风险或高不确定性场景。
涉及架构决策且存在不确定性时
提交非平凡代码前
断言无法被类型系统验证的属性（如线程安全）时
在不熟悉的代码库中工作时
npx skills add addyosmani/agent-skills --skill doubt-driven-development -g -y
用于构建生产级、可访问且响应式的用户界面。涵盖组件开发、布局实现、状态管理及无障碍规范，确保UI具备专业设计感与高质量交互体验。
构建新的UI组件或页面
修改现有用户界面
实现响应式布局
添加交互逻辑或状态管理
修复视觉或用户体验问题
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范围的文档，适用于创意构思与方案优化阶段。
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
通过单轮提问挖掘用户真实意图，消除模糊需求。适用于需求不明确、需确认目标或显式调用时，在规划前对齐上下文，避免错误构建。
需求描述模糊或缺失关键约束
用户显式要求'interview me'或'grill me'
AI准备基于假设开始行动前
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指标、性能分析工作流（测量、识别、修复、验证、防护），以及针对前端渲染、后端查询、连接池和缓存的具体优化策略与工具使用。
需要满足性能要求或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应用安全加固指南，涵盖威胁建模、输入验证、认证授权及数据保护。指导开发者识别信任边界，防范注入、XSS等漏洞，确保合规与安全设计。
处理用户输入或外部API集成
实现身份认证或权限控制
涉及敏感数据存储或传输
进行安全审计或漏洞修复
npx skills add addyosmani/agent-skills --skill security-and-hardening -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
在编码前创建结构化规范，作为人与工程师的共同事实来源。适用于新项目、模糊需求或涉及多模块的复杂变更，通过分阶段工作流确保需求清晰后再实施。
启动新项目或新功能开发
需求不明确、不完整或存在歧义
变更涉及多个文件或模块，需进行架构决策
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
