Agent Skills

why

Agent Skills 是一套生成级别的工作流，但是起了一个和 Agent Skill 容易起误解的名字，前者是名为 Agent Skills 的工作流/技能集，后者是智能助手中的技能概念。

Agent Skills 项目来自 Google 内部的工程负责人，由 Google 内部验证过的工程文化整理而来。

how

Agent Skills 将工作流分为以下 7 个阶段：spec -> plan -> build -> test -> review -> simplify -> ship。

而每个阶段又由多个技能来实现，技能遵循统一模板，确保 AI 行为可预测、可审核、可重复。

what

○ 技能模板

• Frontmatter：定义技能名称和一句话描述，用于自动发现和路由
• Overview：简要说明这个技能解决什么问题，让 AI 快速判断是否匹配
• When to Use：明确的触发条件
• Process：分步工作流，每一步都有具体操作和中间产出
• Rationalizations：常见的偷懒借口（如“这个改动太小，不需要写测试”）+ 反驳理由，防止 AI 跳过关键步骤
• Red Flags：警告信号，当出现这些迹象时立即停止当前做法并重新评估
• Verification：完成技能后必须满足的证据（测试通过、构建成功、运行时数据等）

○ start

using-agent-skills：根据输入内容选择匹配的技能

○ spec

interview-me：追问需求，直到对目标的理解达到约 95% 的置信度

idea-refine：运用结构化的发散与收敛思维，将模糊的初始想法逐步打磨成具体、可执行的提案

spec-driven-development：在编写任何代码之前，强制输出一份完整的产品需求文档（PRD），确保代码的编写基于明确的设计和边界条件

○ plan

planning-and-task-breakdown：根据 spec，拆分独立可验证的小任务，并为每个任务定义清晰的验收标准和执行顺序

TIP

提示词示例

• 根据 spec 拆分任务，严格遵循 planning-and-task-breakdown 技能

○ build

incremental-implementation：薄的垂直切片——实现、测试、验证、提交。特性标志、安全默认值、可回滚的变更。当任何变更涉及多个文件时使用。

test-driven-development：强制执行“红-绿-重构”的TDD流程，在编写功能代码前先编写失败的测试，以此来驱动设计和保证代码可测性

context-engineering：在正确的时间向智能体提供正确的信息——规则文件、上下文打包、MCP 集成。在开始会话、切换任务或输出质量下降时使用。

source-driven-development：要求所有框架或库的使用决策都必须基于其官方文档，并在代码中引用来源，避免AI产生“幻觉”或使用过时的API

doubt-driven-development：对每个进行中的非平凡决策进行对抗性的“全新上下文”审查：CLAIM → EXTRACT → DOUBT → RECONCILE → STOP，并可选择用户授权的跨模型升级。当风险高（生产、安全、不可逆）、在不熟悉的代码中工作、或现在验证比以后调试更便宜时使用。

frontend-ui-engineering：组件架构、设计系统、状态管理、响应式设计、WCAG 2.1 AA 可访问性。在构建或修改用户面向的界面时使用。

api-and-interface-design：契约优先设计、Hyrum's Law、单版本规则、错误语义、边界验证。在设计 API、模块边界或公共接口时使用。

TIP

提示词示例

• 开始拆分实现，严格遵循 incremental-implementation 技能
• 找出开发方案的问题，严格遵循 doubt-driven-development 技能

○ test

browser-testing-with-devtools：利用Chrome DevTools MCP协议，让AI能实时获取浏览器中的DOM、控制台日志、网络请求和性能数据，进行真实验证

debugging-and-error-recovery：遵循五步故障排查法（复现→定位→简化→修复→防护），在面对错误时提供系统化的解决路径

TIP

提示词示例

• 定位问题根因，严格遵循 debugging-and-error-recovery 技能

○ review

code-review-and-quality：提供一套五维度的代码审查标准，强调约100行代码的变更大小控制，并使用严重程度标签（如“建议”、“可选”）来组织反馈

code-simplification：遵循“契斯特顿围栏”原则，在简化代码的同时确保其行为完全不变，目标不是减少行数，而是提升可读性和可维护性

security-and-hardening：建立基于OWASP Top 10的安全检查清单，并实施三层边界系统，以防止常见的安全漏洞

performance-optimization：强调“先测量，再优化”，并设定Core Web Vitals等关键性能指标目标，通过分析来识别和修复性能瓶颈

TIP

提示词示例

• 简化代码，严格遵循 code-simplification 技能

○ ship

git-workflow-and-versioning：推行基于主干开发的策略，并保持原子化提交。这套工作流旨在让每一次代码变更都可追溯、易管理，并将风险控制在最小范围。

ci-cd-and-automation：落实“尽早集成，更快交付”的理念，建立包含质量门禁的流水线，并提供清晰的失败反馈

deprecation-and-migration：将代码视为需要管理的“负债”，通过评估移除成本、计划安全删除和执行用户迁移，系统地处理技术债务

documentation-and-adrs：强调记录决策的原因，而非结果。通过使用架构决策记录（ADR）来捕捉重大技术决策的上下文、约束条件和权衡过程

shipping-and-launch：提供一份包含发布前检查清单、特性标志生命周期管理和回滚流程的部署指南，确保功能能够安全、可控地上线。

TIP

提示词示例

• 本地提交代码，严格遵循 git-workflow-and-versioning 技能
• 记录会话重大决策，严格遵循 documentation-and-adrs 技能