适合谁

Agent 技能索引：适合快速浏览 Agent 技能的基本分类和组织方式。

Codex 用法

优先按具体技能或原项目安装方式使用，不建议把归档目录整包复制。

作为索引参考；实际安装应选择具体来源包。

许可证 / 风险

来源与 license 需按具体技能包核对。

AgentSkills

Google 出品的 AI 编码代理工程技能包

20 个经过实战检验的工程技能 + 7 个命令，覆盖开发全流程：规划、构建、验证、审查、发布。来自 Google 最佳工程实践。

$ npx agent-skills install

技能

命令

开发阶段

📐 分层架构

🎯 Slash 命令层

用户直接调用的快捷入口，一个命令自动调用一组相关技能。

/spec - 定义规范
/plan - 规划任务
/build - 开始构建
/test - 测试验证
/review - 代码审查
/ship - 发布上线

↓

🔧 垂直技能层 - Ship 发布

发布阶段的完整技能集。

git-workflow-and-versioning - Git 工作流
ci-cd-and-automation - 自动化流水线
deprecation-and-migration - 废弃与迁移
documentation-and-adrs - 文档与决策记录
shipping-and-launch - 发布与上线

↓

🔍 垂直技能层 - Review 审查

代码质量把控层。

code-review-and-quality - 代码审查
code-simplification - 代码简化
security-and-hardening - 安全加固
performance-optimization - 性能优化

↓

🧪 垂直技能层 - Verify 验证

证明代码真的能工作。

browser-testing-with-devtools - 浏览器测试
debugging-and-error-recovery - 调试与错误恢复

↓

🛠️ 垂直技能层 - Build 构建

核心编码技能。

incremental-implementation - 增量实现
test-driven-development - TDD 测试驱动
context-engineering - 上下文工程
source-driven-development - 源码驱动
frontend-ui-engineering - 前端工程
api-and-interface-design - API 设计

↓

📋 垂直技能层 - Define & Plan 定义规划

把想法变成可执行计划的技能。

idea-refine - 想法精炼
spec-driven-development - 规范驱动开发
planning-and-task-breakdown - 任务拆分

⚡ 核心功能

📋 规范驱动开发

Spec-Driven Development - 在写代码前先写 PRD，包含目标、结构、代码风格、测试和边界。

🧩 增量实现

Incremental Implementation - 薄垂直切片：实现→测试→验证→提交，功能开关、安全默认值。

🧪 TDD 测试驱动

Test-Driven Development - 红-绿-重构，测试金字塔（80/15/5），先写测试再写代码。

🔒 安全加固

Security & Hardening - OWASP Top 10 预防、认证模式、密钥管理、三层边界系统。

🚀 自动化发布

CI/CD & Automation - 左移、质量门禁流水线、功能开关、分阶段发布、回滚方案。

📝 代码审查

Code Review - 五轴审查，变更大小约 100 行，严重性标签，审查速度规范。

🛠️ Slash 命令工具箱

/spec

Define 规范

在写代码前先定义清楚要做什么，包含目标、验收标准和实现方案。

/plan

Plan 规划

把大需求拆成小任务，排好顺序和依赖关系，形成可执行计划。

/build

Build 构建

增量实现，每次只做一小块，确保每次提交都能跑通测试。

/test

Test 测试

证明功能真的能用，写测试用例，覆盖各种边界情况。

/review

Review 审查

代码质量审查，检查安全性、性能、可维护性和代码规范。

/ship

Ship 发布

执行发布流程：检查单→分阶段发布→监控设置→回滚方案。

💬 聊天比喻场景

👨‍💻

Hey 团队，我要做一个用户登录功能，新用户能注册、登录、登出，怎么弄？

📋

我是 /plan！先把需求拆成小任务：数据库设计→注册 API→登录 API→前端表单→测试。

🛠️

我是 api-and-interface-design！先设计 API 契约：用户注册需要什么字段？返回什么格式？错误怎么处理？

👤

OK，那开始写代码吧，一次做一点。

⚙️

我是 incremental-implementation！薄切片实现——每次只做一个功能点，能跑通再提交。

👤

写完了，帮我测试一下有没有 bug。

🧪

我是 test-driven-development！先写测试用例，再写实现代码，确保每个场景都覆盖到。

👤

测试通过！现在可以合并到主分支了。

🔍

我是 code-review-and-quality！帮你审查代码质量、潜在安全问题和性能问题。

🚀

我是 /ship！执行发布流程：检查单→分阶段发布→监控→回滚方案准备。

📖 大白话解释

什么是 Agent Skills？

想象你开了一家软件公司，Agent Skills 就是你雇的一群超级专业的工程师：有人专门做设计规划，有人专门写代码，有人专门测试，有人专门做安全审查。遇到什么问题，就叫对应的工程师来处理。

Slash 命令是什么？

就像在Slack里打 /call 能叫人来开会一样，输入 /plan 就能叫"规划师"来帮你拆任务，输入 /review 就能叫"审查员"来帮你审查代码。

薄切片实现是什么？

就像吃披萨，一口吃不完，要切成一小块一小块吃。Incremental Implementation 就是这个意思：不要憋一个大功能写半天，而是分成很小很小的功能点，每个点都能独立运行、独立测试。这样好处是：哪里出问题一眼就能看出来。

TDD 为什么要先写测试？盖房子先做模型？

就像盖房子前先做模型测试风阻一样，TDD (Test-Driven Development) 要求先写测试再写代码。这样做的好处是：你得先想清楚"什么才算成功"，然后再奔着那个目标去实现，不会写着写着跑偏了。