参考型 vs 动作型

Skill 的两种设计意图分类框架,帮助在创建 Skill 时选择正确的内容组织方式。

应用15 分钟

一、为什么需要区分

Skill 的 SKILL.md 按内容性质分为两种倾向:

  • 参考型内容:规范、约定、领域知识、风格指南——Claude 在工作中参考应用的背景知识
  • 动作型内容:编号步骤、操作流程、部署指令——Claude 按顺序执行的具体任务

内容组织方式选错时代价明确:

代价方向具体表现
该给知识却给了步骤把"API 遵循 RESTful + 分页 + 统一错误格式"写成编号步骤序列,Claude 只在手动触发时执行一遍,而非在每次写 API 时自动参考
该给步骤却给了知识把"部署流程:测试→构建→推送→验证"写成散文叙述,Claude 理解了部署概念但不知道按什么顺序执行哪些命令

二、限制与红线

不是所有 Skill 都能清晰归入一类。以下场景不应强行分类:

场景为什么不应强分建议
代码审查 Skill既有"审查标准"(知识),又有"按顺序检查"(步骤)混合型,不需要拆分
TDD 工作流步骤简单但核心价值在规范约束偏动作型,但可保留规范段落
纯知识型 Skill 使用 context: forkfork 后 SubAgent 没有具体任务可执行,收到知识但"没事做"参考型不配 fork

硬约束:参考型 Skill 不应该设置 context: fork。fork 创建独立 SubAgent 执行任务——纯知识类 Skill 在 fork 环境中没有可执行的操作目标,SubAgent 会返回空结果或无意义的"已阅读"回复。

软约束:动作型 Skill 有副作用(部署、删除、提交)时,disable-model-invocation: true 几乎是必须的。Claude 自动触发有副作用的操作是危险的。

三、怎么选

核心判断问题:这个 Skill 是给 Claude 一组"知识"去持续参考,还是给 Claude 一个"任务"去执行?

场景速查表

付费内容

继续阅读完整课程

购买后即可解锁全部 16 个功能模块、实战场景与深度配置。

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 长期访问,持续更新
Skill 完全指南5/12