BAIZE AI RESOURCE

AI 编程工程技能集合

agent-skills

agent-skills 是 Addy Osmani 维护的 AI 编程技能集,将需求、规划、编码、测试、评审和发布阶段的工程实践封装为可复用 Skill。

agent-skills

资源介绍

agent-skills 是一套面向 AI 编程 Agent 的工程技能库,目标是把资深工程师在真实项目中使用的流程、质量标准和最佳实践固化为 Agent 可遵循的技能。仓库以 SKILL.md 为核心载体,每个技能描述适用场景、核心原则与操作规范,覆盖 API 与接口设计、前端 UI 工程、测试驱动开发、代码评审、安全加固、性能优化、可观测性、CI/CD、文档与 ADR、发布上线等开发环节。除技能外,仓库还提供映射开发生命周期的斜杠命令(如 /spec、/plan、/build、/test、/review、/ship)、子 Agent 定义、共享参考清单以及用于验证技能触发与行为效果的三层评测体系。它适合使用 Claude Code、Cursor、Codex、Gemini CLI 等工具的开发者,用于减少 Agent 随意发挥、提升代码质量与流程一致性。

Skill 能力

覆盖完整开发生命周期

技能按需求定义、规划、构建、验证、评审、发布等阶段组织,并配有对应的斜杠命令,形成从想法到上线的完整工作流。

以 SKILL.md 为载体的技能规范

每个技能用 SKILL.md 描述适用场景、核心原则与操作要求,Agent 可依据描述自动匹配并激活相应技能。

内置质量门禁与工程实践

包含测试驱动开发、代码评审、安全加固、性能优化、可观测性、CI/CD 等实践,强调在流程中强制执行质量检查。

三层技能评测体系

通过结构校验、触发与路由评测、行为评测三个层级,验证技能能否被正确触发、彼此区分并真正改变 Agent 行为。

多工具集成与共享参考

提供面向 Claude Code、Cursor、Codex、Gemini CLI 等工具的安装与配置说明,并附带安全、性能、测试等共享检查清单。

资源配置

适用平台

Claude CodeCodexCursorGemini CLI通用 Agent

支持模型

模型无关

调用方式

自动触发命令调用

安装与调用

  1. 把需要的 Skills、命令和子 Agent 安装到 Claude Code、Cursor、Codex 或 Gemini CLI。

  2. 根据开发阶段选择 /spec、/plan、/build、/test、/review 或 /ship,并提供项目背景、目标和验收标准。

  3. 让 Agent 按对应技能完成规划、实现和验证,不必一次启用整个技能库。

  4. 检查测试、安全、性能和代码评审等质量门禁通过后,再合并或发布改动。

使用案例

测试驱动修复缺陷

使用场景修复金额分摊丢失分币的缺陷

在 test-driven-development 技能下,Agent 先为 BUG.md 描述的丢分场景编写失败测试,再修改实现,使结果同时满足总额精确与分币公平两条不变量,并运行完整测试套件。

浏览器运行时验证

使用场景调试只在浏览器中出现的前端问题

借助 browser-testing-with-devtools 技能与 Chrome DevTools MCP,Agent 读取真实 DOM、控制台日志与网络请求,基于运行时证据定位并验证修复,而不是仅凭静态代码猜测。

搭建 CI 质量门禁

使用场景为新项目配置持续集成流水线

使用 ci-cd-and-automation 技能配置 lint、类型检查、单元测试、构建、集成测试与安全审计等门禁,并把 CI 失败输出回传给 Agent 进行修复。

包含内容

agent-skills-source.zip
LICENSE-MIT.txt
README-中文安装说明.md
SHA256.txt

常见问题

agent-skills 仓库的 evals 分为哪三个层级,各自检查什么?
evals/README.md 将评估分为三层:Tier 1 Structural 检查 frontmatter、命名、必需章节和命令一致性,由 CI 中的 validate-skills.js、validate-commands.js 运行;Tier 2 Trigger & routing 检查正向提示能否把对应 skill 排进 top-k、负向提示不会、以及两个描述是否近似冲突,由 CI 中的 run-evals.js 运行;Tier 3 Behavioral 检查 agent 遵循 skill 后是否满足其 expectations[],按需通过 run-evals.js --behavioral 运行并消耗 tokens。
agent-skills 的 Tier 2 触发与路由评估采用什么方法?
evals/README.md 说明 Tier 2 是路由的词汇近似(lexical approximation),对 skill 描述做词干化 TF-IDF;它检查正向提示是否把对应 skill 排进 top-k、负向提示是否不会、以及任意两个描述是否近似冲突,并且是 CI 中免费运行的确定性检查。
browser-testing-with-devtools skill 依赖什么 MCP 服务器,如何配置?
skills/browser-testing-with-devtools/SKILL.md 说明该 skill 需要配置 chrome-devtools MCP 服务器;在项目的 .mcp.json 或 Claude Code 设置中加入 mcpServers.chrome-devtools,command 为 npx,args 为 ["-y","chrome-devtools-mcp@latest","--isolated"]。其中 -y 跳过 npx 安装确认,--isolated 使用临时 profile 并在结束时清除。
browser-testing-with-devtools 的示例 fixture 如何复现注册流程?
evals/fixtures/browser-testing-with-devtools/README.md 的 Signup reproduction 示例要求运行 node server.js,打开 http://127.0.0.1:4173,输入邮箱并提交表单;报告应基于运行时 console、network 和 DOM 证据。
test-driven-development 的 split-payment fixture 中 splitCents 的 API 与不变量是什么?
evals/fixtures/test-driven-development/README.md 说明 splitCents(totalCents, n) 返回 n 个整数分金额,totalCents 为非负整数、n 为正整数,全程使用整数分、不涉及浮点。结果须满足两个不变量:Exactness(各份之和恰好等于 totalCents)和 Fairness(任意两份相差不超过一分,不能整除时余数从最早的份额开始各加一分);例如 splitCents(100, 7) 为 [15,15,14,14,14,14,14],测试命令为 npm test。