01章节
入门定位
Skill 可以理解为“可复用的任务说明书 + 边界约束 + 参考材料入口”。它不是单纯的一段提示词，而是让某类任务有固定做法。
当同一种事情会被反复做，例如修 CI、做代码审查、写 ADR、上线检查，Skill 的价值就会非常明显。
AI 编程文档
这里整理 AI 编程、工具使用、自动化和开发流程里的高频实战说明，按主题持续沉淀。
左侧选择目录。
中间查看正文。
右侧使用本页导航。
正文
Skills（技能）
Skills 适合把重复性协作方式沉淀成可复用能力单元，让代理在固定触发条件下按既定流程做事，而不是每次都从零提示。
02章节
和普通提示词的区别
普通提示词偏一次性，Skill 偏制度化。前者解决当前对话，后者解决某类任务长期怎么做。
所以 Skill 更强调触发规则、执行顺序、参考文件和失败时的降级策略。
03章节
一个好 Skill 要写清什么
一个好 Skill 至少要写清楚四件事：什么时候用、先做什么、要读哪些材料、什么情况下不要继续。
如果只有原则没有动作，或者只有动作没有边界，这个 Skill 都很难稳定复用。
04章节
什么任务值得抽成 Skill
适合沉淀成 Skill 的通常是高频、可拆步骤、验收方式明确的任务，例如提测前检查、PR 回评审、构建失败定位和发布清单。
低频且高度依赖临场判断的任务，不一定值得抽成 Skill。
05章节
实操建议
先从一个高频痛点开始做 Skill，例如“多文件功能实现要先切片再验证”。当它在几个真实任务里都有效，再继续抽更多能力。
Skill 的成熟不是看写了多少，而是看它能否连续在真实任务里减少返工。
06章节
常见坑
误区一是切得太碎，导致调用成本高于收益。误区二是写得太宽泛，变成任何事都能套但任何事都做不精。
误区三是只写理念，不写命令、检查项和输出要求，这种 Skill 基本无法稳定执行。
07章节
第一个例子怎么做
第一个 Skill 最好针对一个高频、重复、可验证的任务，例如“做多文件功能时先切片再验证”或“修 CI 时先查日志再定位根因”。
只要这个 Skill 真能在 2 到 3 个真实任务里减少返工，它就值得保留和继续扩展。
08章节
推荐学习顺序
建议先写单一场景 Skill，再写相邻场景，最后再做路由型或组合型 Skill。
不要一开始就做过于抽象的大 Skill，否则看起来什么都能管，实际上什么都管不好。
09章节
和其他主题怎么组合
Skills 和 Codex、Claude Code、OpenCode、Agent 都能结合。它的作用不是代替模型，而是把协作方法固定下来。
你可以把它理解成“给代理加工作制度”，这样同类任务每次都能走相近流程。