Résumé des modifications

SKILL.md

参考示例

---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Instructions

1. First, run the shell command `git diff HEAD` to retrieve the current uncommitted changes.
2. If the diff is empty, simply state that there are no uncommitted changes.
3. Otherwise, summarize the changes in two or three bullet points.
4. Finally, list any risks you notice, such as missing error handling, hardcoded values, or tests that need updating. 

配置skills

Skills 通过 SKILL.md 顶部的 YAML frontmatter 和随后的 markdown 内容进行配置。

Skill 内容的类型

Skill 文件可以包含任何说明，但思考你想如何调用它们有助于指导要包含的内容：

• 触发机制: 先想好你怎么“使唤”它（写好 description，保证它能被精准触发）。

参考内容添加 Claude 应用于你当前工作的知识。约定、模式、风格指南、领域知识。此内容内联运行，以便 Claude 可以将其与你的对话上下文一起使用。

• “背景知识库”（怎么让它懂行）： 再把你团队的“独家秘籍”塞给它（写好参考内容，让它在后台随时查阅，保证它干活符合你们的规矩）

任务内容为 Claude 提供特定操作的分步说明，如部署、提交或代码生成。

Frontmatter 参考

除了 markdown 内容外，你可以使用 SKILL.md 文件顶部 --- 标记之间的 YAML frontmatter 字段来配置 skill 行为：

---
name: my-skill
description: What this skill does
disable-model-invocation: true
allowed-tools: Read Grep
---

Your skill instructions here...

|字段|必需|描述| |-|-|-| |name|否|Skill 的显示名称。如果省略，使用目录名称。仅小写字母、数字和连字符（最多 64 个字符）。 |description|推荐|Skill 的功能以及何时使用它。Claude 使用它来决定何时应用该 skill。如果省略，使用 markdown 内容的第一段。前置关键用例：组合的 description 和 when_to_use 文本在技能列表中被截断为 1,536 个字符以减少上下文使用。| |when_to_use|否|关于 Claude 何时应该调用该 skill 的额外上下文，例如触发短语或示例请求。附加到技能列表中的 description，并计入 1,536 个字符的上限。| |argument-hint|否|自动完成期间显示的提示，指示预期的参数。示例：[issue-number] 或 [filename] [format]。| |arguments|否|用于 skill 内容中$name 替换的命名位置参数。接受空格分隔的字符串或 YAML 列表。名称按顺序映射到参数位置。| |disable-model-invocation|否|设置为 true 以防止 Claude 自动加载此 skill。用于你想使用 /name 手动触发的工作流。也防止该 skill 被预加载到 subagents 中。默认值：false。| |user-invocable|否|设置为 false 以从 / 菜单中隐藏。用于用户不应直接调用的背景知识。默认值：true。| |allowed-tools|否|当此 skill 处于活动状态时，Claude 可以使用而无需请求权限的工具。接受空格分隔的字符串或 YAML 列表。| |model|否|当此 skill 处于活动状态时要使用的模型。覆盖适用于当前轮的其余部分，不保存到设置；会话模型在你的下一个提示时恢复。接受与 /model 相同的值，或 inherit 以保持活动模型。| |effort|否|当此 skill 处于活动状态时的工作量级别。覆盖会话工作量级别。默认值：继承自会话。选项：low、medium、high、xhigh、max；可用级别取决于模型。| |context|否|设置为 fork 以在分叉的 subagent 上下文中运行。| |agent|否|当设置 context: fork 时要使用的 subagent 类型。| |hooks|否|限定于此 skill 生命周期的 hooks。有关配置格式，请参阅 Skills 和代理中的 Hooks。| |paths|否|Glob 模式，限制何时激活此 skill。接受逗号分隔的字符串或 YAML 列表。设置后，Claude 仅在处理与模式匹配的文件时自动加载该 skill。使用与路径特定规则相同的格式。| |shell|否|用于此 skill 中 !command 和 ```! 块的 shell。接受 bash（默认）或 powershell。设置 powershell 在 Windows 上通过 PowerShell 运行内联 shell 命令。需要 CLAUDE_CODE_USE_POWERSHELL_TOOL=1。|

---

可用的字符串替换

|变量|描述| |-|-| |$ARGUMENTS|调用 skill 时传递的所有参数。如果内容中不存在 $ARGUMENTS，参数将作为 ARGUMENTS: <value> 追加。| |$ARGUMENTS[N]|按 0 基索引访问特定参数，如 $ARGUMENTS[0] 表示第一个参数。| |$N|$ARGUMENTS[N] 的简写，如 $0 表示第一个参数或 $1 表示第二个参数。| |$name|在 arguments frontmatter 列表中声明的命名参数。名称按顺序映射到位置，因此使用 arguments: [issue, branch] 时，占位符 $issue 扩展为第一个参数，$branch 扩展为第二个参数。| |${CLAUDE_SESSION_ID}|当前会话 ID。适用于日志记录、创建会话特定文件或将 skill 输出与会话关联。| |${CLAUDE_EFFORT}|当前工作量级别：low、medium、high、xhigh 或 max。使用此来根据活动工作量设置调整 skill 说明。| |${CLAUDE_SKILL_DIR}|包含 skill 的 SKILL.md 文件的目录。对于插件 skills，这是插件内 skill 的子目录，而不是插件根目录。在 bash 注入命令中使用它来引用与 skill 捆绑的脚本或文件，无论当前工作目录如何。|

索引参数使用 shell 风格的引用，因此用引号包装多词值以将其作为单个参数传递。例如，/my-skill "hello world" second 使 $0 扩展为 hello world，$1 扩展为 second。$ARGUMENTS 占位符始终扩展为完整的参数字符串，如输入的那样。

---
name: session-logger
description: Log activity for this session
---

Log the following to logs/${CLAUDE_SESSION_ID}.log:

$ARGUMENTS