企业官网建设流程全解析

agent-skills 使用指南：如何给 AI 编码代理装上 24 项生产级工程技能

【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills

agent-skills 是一套面向 AI 编码代理的生产级工程技能包，把测试驱动开发、代码审查、安全加固等 24 项工程流程写成 Markdown 文件，让 Claude Code、Cursor、Gemini CLI 等代理在每个开发阶段按固定流程执行。下面从克隆仓库讲起，目标是 20 分钟内跑通第一个技能。

为什么值得试

你让 AI 代理实现一个登录接口，它 10 分钟交活：功能能跑，但没有测试、没做输入校验、密钥写死在代码里。AI 代理默认走最短路径，跳过规格、测试和安全检查，产出是原型级的。agent-skills 把高级工程师的流程——先写规格再写码、测试即证明、合并前过五轴审查——固化成技能文件，代理必须走完每一步并给出验证证据，"看起来对"不算完成。

克隆仓库，两种工具各验一次

先克隆，两种方式都基于本地目录：

git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills

Claude Code（本地插件）：在项目根目录启动时直接指定插件目录：

claude --plugin-dir ./agent-skills

进会话后输入/，能看到 /spec、/test、/review 等 8 个斜杠命令，说明装好了。

Gemini CLI：装成原生技能，CLI 自动发现、按需激活：

gemini skills install ./agent-skills/skills/

在 Gemini CLI 里执行/skills list，看到 test-driven-development、code-review-and-quality 等 24 个技能名即成功。

核心能力速览 🧭

24 个技能覆盖完整开发生命周期，按你实际会碰到的场景分四组：

写代码时

• incremental-implementation：把改动切成"薄垂直片"，每片走完实现→测试→验证→提交再进下一片
• test-driven-development：红-绿-重构循环，先写会失败的测试，配 80/15/5 测试金字塔
• frontend-ui-engineering / api-and-interface-design：前者管组件架构与 WCAG 2.1 AA 无障碍，后者用契约先行和 Hyrum 定律设计接口

提交前检查

• code-review-and-quality：五轴审查，单次改动约 100 行上限，意见按 Nit/Optional/FYI 分级
• code-simplification：用"切斯特顿栅栏"原则——先弄清一段代码为什么存在，再决定删不删
• security-and-hardening：OWASP Top 10 防御、认证模式、密钥管理

调试排错时

• debugging-and-error-recovery：五步排查——复现、定位、缩小、修复、加回归防护
• browser-testing-with-devtools：用 Chrome DevTools 拿真实运行时数据（DOM、控制台、网络请求）

发版上线时

• shipping-and-launch：灰度发布、回滚预案、上线前清单
• observability-and-instrumentation：结构化日志、RED 指标、症状式告警
• git-workflow-and-versioning：主干开发、原子提交

完整实操一遍：用 TDD 跑通一个函数 🧪

选一个最小完整的例子：让代理实现 slugify 函数（把标题转成 URL 安全的短字符串）。

1. 打开装好插件的会话，一句话指定技能并给出任务："按 test-driven-development 流程实现 slugify(text)，输入 'Hello, World!' 应输出 'hello-world'。"
2. 代理先探查仓库怎么跑测试——看 package.json、现有测试的命名，而不是猜 npm test。
3. RED：先写一个必然失败的测试。测试没跑红之前，它不写实现代码。
4. GREEN：写最小实现让测试通过，再 REFACTOR 清理，并要求全量测试仍通过。
5. 提交：按 git-workflow-and-versioning 生成单个原子提交，commit message 说明变更意图。

产出是一套可运行的测试加 1 个提交记录，而不是"应该没问题"。全程约 5 分钟，你只做了两件事：给任务、看测试输出。

接入你的工具链 🔌

Cursor：技能放.cursor/skills/，短规则放.cursor/rules/*.mdc。官方文档明确要求不要把整份 SKILL.md 粘进 rules，那会和技能目录重复、浪费上下文：

cp -r ./agent-skills/skills/test-driven-development .cursor/skills/

Gemini CLI（工作区级）：只装到当前项目，不占全局：

gemini skills install ./agent-skills/skills/ --scope workspace

高频坑点 ⚠️

1. 单装技能后共享清单不可用：现象是技能能跑但引用不到检查单；原因是单技能安装只拷贝 skills/ 下的子目录，缺仓库级 references/；解法：克隆整仓，或把所需清单拷进该技能的 references/ 目录。
2. 全量加载 24 个技能后回答变慢：技能本就按任务按需激活，全塞进常驻上下文会挤占 token；解法：按当前任务只加载 1-2 个，做 UI 就加载 frontend-ui-engineering。
3. Claude Code 提示 "commands/ folder is ignored"：根目录 commands/ 属于 Antigravity CLI，与 .claude/commands/ 刻意分离；解法：忽略该提示，8 个斜杠命令加载正常。

下一步

• 读 docs/getting-started.md 的"最小三技能"方案：spec-driven-development、test-driven-development、code-review-and-quality，覆盖 AI 辅助开发中质量缺口最大的三处。
• 试 /build auto：规划一次、批准一次，代理自主跑完整个计划——每个任务仍是测试驱动、逐个提交，失败或高风险步骤会暂停等待。
• 想写自己的技能：先读 docs/skill-anatomy.md 的格式规范（含"借口与反驳"表这类固定部件），再对照 CONTRIBUTING.md 提交。

【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills