Skills
把有效的做法沉淀为可复用技能：先写出最小可触发结构，再判断哪些内容该移入资源文件，用验证闸门证明它没有变坏，最后纳入团队版本管理。
开始之前
有一条每周重复多次的流程；知道自己所用客户端的 Skill 目录与加载方式更好，不确定时从第一篇开始按客户端确认。
这个主题要掌握什么
- 先判断该写成 Skill、项目规则还是 MCP 工具，不要把所有提示词都塞进 SKILL.md。
- description 决定触发：写清什么时候用、什么时候不用。
- 长参考资料和脚本移到资源文件，按需加载，不让正文变成手册。
- 格式校验、触发矩阵、内容演练三道闸门，跨客户端前先分别验证。
按顺序读： 第一个 Agent Skill：写一份可被发现的 change-summary Agent Skill 设计：什么该写成 Skill，什么不该 Skill 资源拆分：references、scripts 与按需加载
第一个 Agent Skill：写一份可被发现的 change-summary
从目录、frontmatter 到完整 SKILL.md，一步步创建 change-summary，并用 Claude Code 的发现路径做手工验收。
Agent Skill 设计：什么该写成 Skill，什么不该
Skill 不是提示词收藏夹。讲清它和项目规则、MCP 工具、斜杠命令的分工，怎么写可被正确触发的 description，以及为什么同一个 Skill 在不同工具里表现并不一致。
Skill 资源拆分：references、scripts 与按需加载
把 change-summary 拆成 SKILL.md、references、assets 和离线脚本，理解渐进加载、路径与工作目录，并跑通自测。
Skill 验证：格式、触发与内容三道闸门
Skill 的失败大多不是内容错，而是格式不合规范、触发条件太宽或太窄、跨客户端行为不一致。用格式校验、触发矩阵、内容演练三道闸门把它们提前暴露。
团队 Skill 分发：版本固定、兼容矩阵与可回滚交接
把团队 Skill 纳入版本控制，审查改动范围、记录不可变 revision、维护兼容矩阵，并用 revert 安全回滚。