RSS

给 AI 写规矩:把重复劳动固化成技能、子代理和钩子,让它在你的仓库里照章办事

难度
进阶
章节
10 章
阅读时长
约 55 分钟
最后更新

你已经会用 Claude Code 了。你能把话说清楚,能管住权限,能在一个真实任务里跟它走完一轮。但有件事你大概每天都在重复:每次要它写发布说明,你都得把团队的格式规范再贴一遍;每次要它查一处调用链,它读了二十个文件,把主对话塞得又满又慢;每次它改完代码,你都得记得手动跑一遍格式化——忘一次,diff 里就混进一堆无关的空格改动。

这些都不是”把话说得更客气”能解决的。它们是规矩没有被固化。你把规矩留在自己脑子里,于是每次都要口述一遍;模型没记住,是因为你没把它写进它每次都会读到的地方。

这份教程解决的就是这件事:把你反复口述的东西,变成仓库里的四类产物——技能、命令、子代理、钩子。它们各自适合固化不同的东西,你要学会的第一件事就是分清楚哪件事该用哪一个。

读完之后,你会亲手做出三件能直接用的产物:

最后,我们把这三件产物加上一个 /release 命令一起打包成插件 release-kit,让团队里任何人 clone 下来就能用。

全篇围绕同一个场景展开:把一个多人 web 项目的发布流程,固化成一套团队资产。前两章建立判断力并做出第一个最小产物;第 3 到 5 章把技能吃透;第 6 章做子代理;第 7、8 章做钩子;第 9 章打包;第 10 章组合演练,并收口在最该慎重的地方——信任边界。

需要的前置只有三样:你会用终端和 git,能读懂 JSON 与 YAML,并且已经在自己的仓库里用 Claude Code 跑过任务。不假设你读过任何官方文档。

这是《Claude Code 上手指南》第 8 章”四选一决策象限”的动手续篇。那一章告诉你该选哪一个,这一篇带你把它们真正做出来

读完之后你应该能够

  • 一个技能:release-notes,自动按团队格式起草发布说明,还能把实时的 git 记录灌进去
  • 一个子代理:release-scanner,在一个独立上下文里翻完提交历史,只把分好类的摘要交回来,不污染你的主对话
  • 一个钩子:编辑后自动格式化,外加一道拦下危险操作的守门
适合谁已经会基本使用 Claude Code 的开发者
前置要求会用终端与 git,能读懂 JSON / YAML / Markdown,已在真实仓库里用过 Claude Code 跑过任务
广告位 · In-article 响应式 正文段落间隙

章节目录

10 章 · 约 55 分钟
  1. 01 你在给 AI 写规矩,不是写代码 四件套不是四选一:用确定性和常驻两条轴,动手前就选对工具,并厘清命令已并入技能。 4 min
  2. 02 五分钟热身:把一段提示变成 /命令 五分钟把一段反复输入的提示变成 /命令:最小技能只有一个 SKILL.md。 7 min
  3. 03 产物一·技能(上):SKILL.md 的解剖 SKILL.md 的解剖:frontmatter、正文、参考知识 vs 任务流程,放个人还是项目目录。 6 min
  4. 04 让技能触发得准:description 就是它的 API 技能为什么不触发?description 就是它的 API,一张模糊到精准的改写表。 4 min
  5. 05 技能加料:动态上下文、附属文件与渐进式披露 给技能加料:动态注入实时数据、附属文件与脚本,理解渐进式披露怎么省上下文。 7 min
  6. 06 产物二·子代理:给脏活单独开一个上下文 给调查工作单独开一个上下文:写一个只读子代理,用 tools 和 model 把它收窄。 5 min
  7. 07 产物三·钩子:唯一不靠模型判断的那一档 唯一不靠模型判断的那一档:写第一个 PostToolUse 钩子,看懂 stdin JSON 与退出码。 5 min
  8. 08 钩子的完整生命周期:事件、决策与守门 钩子的完整生命周期:核心事件、用 permissionDecision 守门,以及它的信任风险。 6 min
  9. 09 打包成插件,一键分发给团队 把四件套打包成插件:plugin.json、目录结构、hooks.json,本地测试与市场分发。 5 min
  10. 10 组合演练与信任边界 用一条 /release 串起四件套,一张组合决策复盘表,收口于信任边界。 6 min

延伸阅读:本教程引用的官方文档清单 →

常见问题

需要先读过官方文档吗?

不需要。只假设你已经会基本使用 Claude Code,会用终端和 git,能读懂 JSON 与 YAML。

和《Claude Code 上手指南》第 8 章什么关系?

那一章讲四件套该选哪一个,这一篇是动手续篇,带你把技能、子代理、钩子真正做出来并打包。

可以跳着读吗?

建议 1、3、4、5 章按顺序读透技能;子代理(第 6 章)、钩子(第 7、8 章)相对独立,可按需取用。

教程会跟着工具更新吗?

会。字段名、事件名、命令与技能的关系都可能随版本演进,动手前用 /hooks、/help 或当前官方文档核对一遍。