一、常见方案模式
不同类型的需求对应不同的 Skill 设计模式。以下四种模式覆盖了绝大多数实际场景。
单文件知识注入
最简结构——一个 SKILL.md 包含全部内容。Claude 匹配到 description 后加载整个文件,按其中的规则和知识执行任务。
适用场景:编码规范、审查清单、文档格式标准、API 使用约定。
设计要点:body 控制在 200 行以内。超过时考虑拆分为多资源协作模式。description 写明做什么(WHAT),when_to_use 写触发场景和排除条件——两者合计 1,536 字符上限。
参数化动作
通过 $ARGUMENTS 或命名参数接收用户输入,根据参数执行不同操作。适用于需要用户指定目标的任务型 Skill。
设计要点:disable-model-invocation: true 阻止 Claude 自动触发——部署这类有副作用的操作必须由用户手动 /deploy production 调用。arguments: environment 将第一个参数绑定到 $environment 变量,比手动解析 $1 更清晰。
$ARGUMENTS 的完整参数化机制(位置参数、默认值、引号处理)见 复杂 Skill 编写。
安全隔离 Agent
通过 context: fork 在独立 SubAgent 中运行,隔离上下文。allowed-tools 预批准可用工具集。
context: fork 的意义:SubAgent 拥有独立上下文窗口,审计过程中读取的大量文件内容不会污染主对话。审计结果作为报告返回主会话。
allowed-tools 的意义:预批准只读工具(Read、Grep、Glob)和受限 Bash,减少执行过程中的权限询问。
agent: Explore 指定 SubAgent 类型为只读探索模式。其他选项包括 Plan(规划模式)和自定义 Agent 路径。
fork 与普通执行的完整决策框架见 context: fork 隔离运行。