企业官网建设流程全解析

10 分钟给 AI 编程代理接上生产级开发流程：agent-skills 上手指南

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

agent-skills 是面向 AI 编码代理的生产级工程技能集，把资深工程师的规格、测试、审查流程打包成代理可执行的技能，补上 AI 写代码"能跑但不严谨"的短板。适合日常使用 Claude Code、Cursor、Gemini CLI 等代理的开发者。

它能替你做什么

不用先懂内部结构，先看三个典型时刻：

• 改动以小切片落地：交给代理一个跨 10 个文件的需求，它不再一次产出巨型 diff，而是一切片一推进，每片带测试、可单独提交，也可单独回滚。
• 审查有固定标尺：合并前代理按"资深 staff 工程师"的标准审代码——五个维度、变更规模约 100 行、每条意见带严重级标签。
• 上线前有门禁：发布前过一遍预检清单、feature flag 生命周期和回滚预案，不再凭"在我机器上是好的"发版。

这三个时刻分别对应后文细讲的三个技能。先把它装起来。

按你的工具选一条安装路径

对照你每天用的工具挑一行即可，无需全试：

两点补充：clone 之后，Gemini CLI 也可以指向本地目录安装，即gemini skills install /path/to/agent-skills/skills/；手动接入 Cursor 或 Copilot 以 clone 为前提，直接用第三行。

装完后的第一小时，跑通第一个任务

按顺序做三件事。

一，读选技能的目录。打开skills/using-agent-skills/SKILL.md，里面有一张把任务类型映射到技能流程的图——遇到哪类活该加载哪个技能，先看这张图，后面选择技能不靠猜。

二，接入你的工具（二选一）。

Cursor 用户把技能拷进规则目录：

cp skills/test-driven-development/SKILL.md .cursor/rules/test-driven-development.md

Copilot 用户放到 .github/skills 下：

mkdir -p .github/skills/test-driven-development cp skills/test-driven-development/SKILL.md .github/skills/test-driven-development/SKILL.md

三，挑一个小任务跑完。给代理的指令里直接点名技能："按 incremental-implementation 技能完成这次改动。"验证两件事：测试是否通过、提交是否切成小片。都成立，说明链路通了。

优先上手的 3 个技能

24 个技能不用一次全加载。按"遇到什么问题→哪个技能解"，先配这三个：

• 改动大、不知从哪下手→ incremental-implementation。按薄垂直切片推进，每片走完实现、测试、验证、提交的完整闭环，自带 feature flag 与安全默认值，回滚成本最低。
• 信不过 AI 产出的代码→ test-driven-development。红-绿-重构，代理必须先写测试再写代码；技能内置反合理化表格，"测试后面再补"这类借口会被逐条驳回。
• 代码写完了但不敢合并→ code-review-and-quality。合并前五维审查、变更规模控制与严重级标签，验收标准是"staff 工程师会不会放行"。

让技能长进你的项目 🛠

两个扩展点。

写自己的技能。结构照现有技能抄：frontmatter 给name和description（描述必须写清做什么、何时触发），正文按 Overview、When to Use、Process、合理化借口表、Red Flags、Verification 组织。完整规格见 docs/skill-anatomy.md。

配钩子脚本。用一组 pre/post 命令，在开发任务前后自动处理缓存上下文：

${CLAUDE_PROJECT_DIR}/hooks/sdd-cache-pre.sh # 中间执行你的开发任务 ${CLAUDE_PROJECT_DIR}/hooks/sdd-cache-post.sh

agent-skills 不在项目目录时，把路径换成 hooks 目录的绝对路径即可。

排查清单 ✅

代理提示找不到技能、或加载了却不执行时，按序勾查：

1. 命令里的安装路径是否拼对，该路径下是否真的存在skills/目录。
2. 技能文件是否完整：frontmatter 的name、description都在，description 同时含"做什么"与"何时用"。
3. 工具是否读得到你放的位置：Cursor 看 rules 目录，Copilot 看.github/，Gemini CLI 看技能安装路径。
4. 是否只装了单个技能：单技能安装不带仓库级references/检查单，代理可能跳过引用步骤——整仓 clone 或把需要的检查单拷进技能目录。
5. 以上都过仍异常，翻docs/下对应工具的安装文档，如copilot-setup.md、gemini-cli-setup.md。

下一步

别收藏了事：今天就用 incremental-implementation 或 test-driven-development 跑完第一个任务。之后用 docs/getting-started.md 对照全生命周期接入方式，动手造技能前再看 docs/skill-anatomy.md。

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