技能系统

一项技能具有 paths frontmatter 场是 条件技能。 它在启动时加载，但是 not 直到用户打开或编辑路径与 glob 模式之一匹配的文件时，Claude 才会发现这一点。

这使您可以保持特定于支付、特定于基础设施或特定于 iOS 的工作流程不可见，直到它们真正相关为止，从而避免在不相关工作的技能列表中出现噪音。

---
paths: src/payments/**
description: "Stripe refund workflow"
---

# Stripe Refund
Steps to issue a refund via the Stripe API...

模式使用与以下相同的语法 .gitignore /CLAUDE.md 条件规则。 一个图案 ** （匹配所有）被视为 unconditional （与省略相同 paths).

条件技能也与 动态技能发现：当模型在项目树中更深入地读取文件时，Claude Code 会向上走 cwd 并且可能会发现更多 .claude/skills/ 启动时未找到目录。 跳过 Gitignored 目录。

Bundled 技能包含在 Claude Code 二进制文件中，并在启动时通过以下方式注册 registerBundledSkill()。 他们遵循相同的 BundledSkillDefinition 界面作为基于文件的技能，但提供 getPromptForCommand(args, context) 函数而不是 SKILL.md 文件。

众所周知的捆绑技能包括：

• /simplify — 产生三个并行审查代理（重用、质量、效率）
• /loop — 解析间隔 + 提示并创建 cron 作业（带有功能标记）
• /remember, /verify, /debug, /stuck
• /skillify — 采访您有关当前会话的信息并编写 SKILL.md（Anthropic-内部）

Bundled 技能还可以通过以下方式包含参考文件 files 财产。 这些在第一次调用时被提取到每个进程的随机数目录中（使用 O_EXCL | O_NOFOLLOW | 0o600 防止符号链接攻击的标志），以及 Base directory for this skill: ... 前缀添加到提示符之前，以便 Claude 可以读取/Grep 它们。

一些捆绑技能以功能标志为条件（feature('AGENT_TRIGGERS'), feature('KAIROS')）或运行时检查（isKairosCronEnabled()）。 无需修改磁盘上的 SKILL.md 即可添加或删除它们。

// Registering a bundled skill
registerBundledSkill({
  name: 'simplify',
  description: 'Review changed code for reuse, quality, and efficiency.',
  userInvocable: true,
  async getPromptForCommand(args) {
    return [{ type: 'text', text: SIMPLIFY_PROMPT }]
  },
})

MCP 服务器除了工具之外还可以公开技能。 当 Claude Code 使用以下命令连接到 MCP 服务器时 MCP_SKILLS 功能启用，它调用 fetchMcpSkillsForClient()，它使用相同的方法解析技能的 frontmatter parseSkillFrontmatterFields() and createSkillCommand() 用于基于文件的技能的函数。

MCP 技能出现在 SkillsMenu 在他们自己的“MCP 技能”组下。 他们的名字遵循惯例 server-name:skill-name.

与本地技能的主要区别：

• 无外壳注入: !backtick and ```! 块被默默地跳过。 代码注释说： “安全性：MCP 技能是远程且不受信任的 - 切勿从其 Markdown 主体执行内联 shell 命令。”
• ${CLAUDE_SKILL_DIR} 没有意义: MCP 技能没有本地目录，因此不替换该变量。
• 单独注册：MCP 技能存在于 AppState.mcp.commands，而不是本地技能注册表。 技能工具通过以下方式合并它们 getAllCommands() 在调用时。
• 注册表桥: mcpSkillBuilders.ts 是一个依赖图叶模块，包含对 createSkillCommand and parseSkillFrontmatterFields，解决之间的循环导入问题 client.ts → mcpSkills.ts → loadSkillsDir.ts.

// How getAllCommands() merges MCP and local skills
const mcpSkills = context.getAppState().mcp.commands
  .filter(cmd => cmd.type === 'prompt' && cmd.loadedFrom === 'mcp')
const localCommands = await getCommands(getProjectRoot())
return uniqBy([...localCommands, ...mcpSkills], 'name')

每次技能工具调用都会经过 checkPermissions()。 该决定遵循以下瀑布：

1. 拒绝规则：如果一个 deny 规则与技能名称（或带有前缀 :*），立即封锁。
2. 远程规范技能：自动允许（仅限蚂蚁实验功能）。
3. 允许规则: 如果明确 allow 规则匹配，无需询问即可继续。
4. 安全属性检查：如果技能仅使用“安全”属性（没有允许的工具、没有模型覆盖、没有钩子、没有路径等），则它会自动允许，而不提示用户。
5. Ask：否则，系统会提示用户添加精确或前缀的建议（:*) 允许本地设置规则。

这意味着简单的信息技能无需任何权限对话框即可运行，而获得 Bash 访问权限或覆盖模型的技能必须得到明确批准。

参数解析使用 shell-quote 因此带引号的字符串可以用作单个标记：

/myskill "hello world" foo  →  ["hello world", "foo"]

支持三种替换模式，按顺序处理：

如果技能体包含 no 占位符和用户提供的参数，它们会自动附加： ARGUMENTS: <args>。 这可以防止在未声明占位符的简单技能中悄悄删除参数。