一、常见方案模式
不同类型的需求对应不同的 Skill 设计模式。以下四种模式覆盖了绝大多数实际场景。
单文件知识注入
最简结构——一个 SKILL.md 包含全部内容。Claude 匹配到 description 后加载整个文件,按其中的规则和知识执行任务。
适用场景:编码规范、审查清单、文档格式标准、API 使用约定。
设计要点:body 控制在 200 行以内。超过时考虑拆分为多资源协作模式。description 前 250 字符包含核心触发信息(Claude 在列表中截断显示)。
参数化动作
通过 $ARGUMENTS 接收用户输入,根据参数执行不同操作。适用于需要用户指定目标的任务型 Skill。
设计要点:disable-model-invocation: true 阻止 Claude 自动触发——部署这类有副作用的操作必须由用户手动 /deploy production 调用。argument-hint 在斜杠菜单中显示为 /deploy <environment>,提示用户传入什么参数。
$ARGUMENTS 的完整参数化机制(位置参数、默认值、引号处理)见 复杂 Skill 编写。
安全隔离 Agent
通过 context: fork 在独立 SubAgent 中运行,隔离上下文。allowed-tools 限制可用工具集,形成沙箱。
context: fork 的意义:SubAgent 拥有独立上下文窗口,审计过程中读取的大量文件内容不会污染主对话。审计结果作为报告返回主会话。
allowed-tools 的意义:限制为只读工具(Read、Grep、Glob)和受限 Bash(仅允许 grep/find 命令),确保审计过程不修改任何文件。
agent: Explore 指定 SubAgent 类型为只读探索模式。其他选项包括 Plan(规划模式)和自定义 Agent 路径。
fork 与普通执行的完整决策框架见 context: fork 隔离运行。