Glossary
52 terms from "Claude Code Skills：打造你的专属 AI 工作流." Look them up when you get stuck; the first mention in the text carries a hover definition.
| Term | Definition | Source |
|---|---|---|
| Skill | 一个目录加一个 SKILL.md 文件，告诉 Claude 如何完成特定任务的可复用工作流指令包。 | Anthropic 工程博客：Agent Skills 实战指南 |
| SKILL.md | Skill 的核心文件，包含 YAML frontmatter（元数据）和 Markdown instructions（执行指令）两部分。 | Claude Code 官方文档：Skills 扩展指南 |
| YAML frontmatter | SKILL.md 文件开头用三个连字符（---）包裹的元数据区域，包含 name、description 等字段。 | Claude Code 官方文档：Skills 扩展指南 |
| name | frontmatter 中的必需字段，定义 Skill 的唯一标识，只能包含小写字母、数字和连字符。 | Anthropic 工程博客：Agent Skills 实战指南 |
| description | frontmatter 中的必需字段，告诉 Claude 这个 Skill 做什么、什么时候用，是自动触发的唯一依据。 | 构建 Claude Skill 实战教程：YAML Frontmatter 与测试 |
| 自动触发 | 当用户说的话和 Skill 的 description 匹配时，Claude 自动加载该 Skill 并执行，无需手动调用。 | 构建 Claude Skill 实战教程：YAML Frontmatter 与测试 |
| 手动调用 | 用 /skill-name 的格式直接调用 Skill，不依赖 description 的匹配，强制 Claude 加载指定 Skill。 | Claude Code 官方文档：Skills 扩展指南 |
| Markdown instructions | SKILL.md 中 frontmatter 之后的所有内容，用 Markdown 格式编写的具体执行指令。 | Claude Code 官方文档：Skills 扩展指南 |
| 渐进式披露 | 只给 Claude 当前需要的信息，不一次性塞入所有细节，让 Skill 保持简洁和快速加载。 | Anthropic Platform 文档：Agent Skills 概述 |
| supporting files | Skill 目录下除 SKILL.md 外的其他文件，如检查清单、配置文件、脚本，按需加载不消耗初始 context。 | Anthropic Platform 文档：Agent Skills 概述 |
| personal skills | 存放在 ~/.claude/skills/ 的 Skills，只有当前用户能访问，用于个人习惯和跨项目的通用工具。 | 教 Claude Code 你的工作流：自定义 Skills 实操指南 |
| project skills | 存放在项目目录 .claude/skills/ 的 Skills，提交到 Git，团队成员克隆代码后自动获得。 | 教 Claude Code 你的工作流：自定义 Skills 实操指南 |
| 重复性 | 适合用 Skill 的场景特征之一，指任务每天、每周或每月都要做多次。 | Claude Code 官方文档：Skills 扩展指南 |
| 步骤固定 | 适合用 Skill 的场景特征之一，指流程可以写成清晰的步骤列表，不是每次都不同。 | Claude Code 官方文档：Skills 扩展指南 |
| 可验证 | 适合用 Skill 的场景特征之一，指能明确判断 Claude 的输出是对是错。 | Claude Code 官方文档：Skills 扩展指南 |
| description 编写公式 | 编写有效 description 的指导原则：做什么 + 什么时候用 + 关键能力。 | 构建 Claude Skill 实战教程：YAML Frontmatter 与测试 |
| 触发关键词 | description 中用户可能说到的词汇，Claude 通过匹配这些词决定是否自动加载 Skill。 | 构建 Claude Skill 实战教程：YAML Frontmatter 与测试 |
| 输入格式 | instructions 中说明 Skill 接受什么样的输入，包括格式、来源和示例。 | Claude Code 官方文档：Skills 扩展指南 |
| 处理步骤 | instructions 中列出的具体操作顺序，每个步骤应该清晰可执行。 | Claude Code 官方文档：Skills 扩展指南 |
| 输出格式 | instructions 中定义的结果应该长什么样，包括结构、符号和示例。 | Claude Code 官方文档：Skills 扩展指南 |
| 边界情况 | 特殊或异常的输入，如空输入、格式错误、超长内容，需要在 instructions 中明确处理方式。 | Claude Code 官方文档：Skills 扩展指南 |
| 直接调用测试 | 用 /skill-name 手动调用 Skill，观察输出是否符合预期，是最基本的测试方法。 | Claude Code 官方文档：Skills 扩展指南 |
| 测试用例 | 准备好的输入-预期输出对，用于系统化测试 Skill 是否按预期工作。 | Claude Code 官方文档：Skills 扩展指南 |
| 迭代改进 | 测试-发现问题-修复-再测试的循环过程，是 Skill 从能用到好用的必经之路。 | Claude Code Skills：.NET 工作流与可复用提示 |
| 对比测试 | 用 Skill 和不用 Skill 分别完成同一任务，对比时间、质量和稳定性，验证 Skill 是否真的有用。 | Claude Code 官方文档：Skills 扩展指南 |
| 检查清单模式 | 将复杂任务拆解为一系列明确的检查项，每项可独立判断通过或不通过的组织方式。 | Claude Code 官方文档：Skills 扩展指南 |
| 多步骤工作流 | Skill 执行多个顺序步骤完成复杂任务，每个步骤的输出可能是下一步的输入。 | Claude Code 官方文档：Skills 扩展指南 |
| 输出分级 | 将 Skill 的输出按严重性分为通过、需注意、必须修复等级别，帮助用户快速抓住重点。 | Claude Code 官方文档：Skills 扩展指南 |
| 版本控制 | 用 Git 管理 project skills，可以查看历史、回滚、对比版本，像管理代码一样管理 Skills。 | Claude Code Skills：.NET 工作流与可复用提示 |
| Skill 审查 | 像审查代码一样审查新增或修改的 Skill，检查 description、instructions、测试用例是否合格。 | Claude Skills 作为自文档化的 Runbook |
| 命名约定 | 团队统一的 Skill 命名风格，如使用连字符、动词-名词格式、2-3 个词长度。 | Claude Code Skills：.NET 工作流与可复用提示 |
| 定期清理 | 每季度审查一次所有 Skills，删除或改进很少使用的 Skill，避免 Skills 过多干扰 Claude 的选择。 | Claude Code Skills：.NET 工作流与可复用提示 |
| 变更通知 | 修改现有 Skill 后在团队频道通知改动内容和影响，避免成员用旧认知操作新 Skill。 | Claude Code 官方文档：Skills 扩展指南 |
| Skills 组合 | 串联使用多个单一职责的 Skill 完成复杂任务，或在一个 Skill 里引用其他 Skills。 | Anthropic 工程博客：Agent Skills 实战指南 |
| allowed-tools | 可选的 frontmatter 字段，限制这个 Skill 只能使用指定的工具，用于安全敏感的场景。 | Claude Skills 深度解析（First Principles 视角） |
| disable-model-invocation | 可选的 frontmatter 字段，设为 true 时禁止 Claude 自动加载，只能手动调用，避免误触发。 | Claude Skills 深度解析（First Principles 视角） |
| model | 可选的 frontmatter 字段，指定这个 Skill 使用特定模型，如需要更强推理能力时用 claude-opus-4。 | Claude Skills 深度解析（First Principles 视角） |
| MCP 服务器 | Model Context Protocol 服务器，为 Claude 提供工具（如数据库访问、API 调用），Skill 提供使用这些工具的工作流知识。 | Claude Skills 创建完整指南（PDF） |
| 社区 Skills | 其他开发者创建并分享的 Skills，可以在 GitHub 等平台找到并使用。 | Claude Code 官方文档：Skills 扩展指南 |
| Skills 文档化 | 在项目 README 或 .claude/README.md 里列出所有 project skills 的用法和示例。 | Claude Skills 作为自文档化的 Runbook |
| 单一职责 | 每个 Skill 应该只做一件事并做好，不要试图在一个 Skill 里解决多个不相关的问题。 | Anthropic 工程博客：Agent Skills 实战指南 |
| context 消耗 | Claude 加载 Skill 时，SKILL.md 的内容会占用 context window，文件越长消耗越多。 | Anthropic Platform 文档：Agent Skills 概述 |
| 按需加载 | supporting files 的内容只在 Claude 真正需要时才读取，不会在 Skill 初始加载时占用 context。 | Anthropic Platform 文档：Agent Skills 概述 |
| 调用频率 | 记录 Skill 在一段时间内被使用的次数，用于判断这个 Skill 是否值得保留和改进。 | Claude Code 官方文档：Skills 扩展指南 |
| 误报 | Skill 把正常的代码或内容标记为问题，需要在 instructions 中加入「需确认」类别或调整判断标准。 | Claude Code 官方文档：Skills 扩展指南 |
| 漏报 | Skill 没有检测出应该发现的问题，需要补充检查规则或调整判断逻辑。 | Claude Code 官方文档：Skills 扩展指南 |
| 加载失败诊断 | 当 Skill 不能被 Claude 自动加载或手动调用失败时，检查文件路径、frontmatter 格式、name 拼写的排查过程。 | Claude Code 官方文档：Skills 扩展指南 |
| 示例驱动 | 通过提供输入输出示例让 Claude 理解预期行为，比纯文字描述更有效。 | Claude Code 官方文档：Skills 扩展指南 |
| 分支实验 | 在 Git 分支上创建或修改实验性 Skill，验证有效后再合并到主分支，避免影响团队其他成员。 | Claude Code 官方文档：Skills 扩展指南 |
| 描述性命名 | Skill name 应该清楚表达做什么，让人一看就懂，而不是泛化的词汇或缩写。 | Claude Code 官方文档：Skills 扩展指南 |
| 使用场景说明 | 在 description 中举例说明什么时候用这个 Skill，如「用于会议行动项整理」。 | 构建 Claude Skill 实战教程：YAML Frontmatter 与测试 |
| 工作流知识 | 关于如何组织步骤、何时用什么工具、如何判断结果的知识，是 Skill 的核心价值。 | Claude Skills 创建完整指南（PDF） |