06_SKILL

Agent SkillsAgent 是智能体Skills 是技能的意思Agent Skills智能体技能是将专业知识、工作流规范固化为可复用资产的核心工具。Agent Skills 本质上是一个模块化的 Markdown 文件能教会 AI 工具 如 Claude、GitHub Copilot、Cursor 等 执行特定任务且支持自动触发、团队共享与工程化管理彻底告别重复的提示词输入。Agent Skills 的本质不是工具而是行为规范 专业知识 使用时机的组合Skills核心形式一个 Skill 就是一个文件夹里面必须有一个 SKILL.md 文件包含说明和元数据可选其他资源文件如脚本、示例、参考文档。Skill 是一个 Markdown 文件SKILL.md用于教 Claude 在特定场景下按你的方式做事。本质是其实就是相当于给 AI 代理发放一本专业手册AI 不会每次都从零学习而是根据任务自动调用手册中的知识。简单来说过去我们用提示词prompt教 AI 做事现在用 Agent Skills 可以把提示词 资源打包成可复用、可共享的技能包更高效、更可靠。Skills 和传统 Prompt 最大的区别对比项普通 PromptSkills 机制每次都要重新描述是否只描述一次上下文长度占用每次全量塞入渐进式加载只在触发时才读完整内容一致性依赖每次 prompt 质量高固定 SOP 模板复用性手动复制粘贴自动匹配 / slash 命令 / 项目共享维护方式改一次 prompt 就要重新发修改 SKILL.md 文件全局/项目生效Skills 与 MCP 的区别Skills 用于知识复用MCP 用于能力扩展。Skills知识复用:知识分享经验、最佳实践、工作流程基于简单的 Markdown 文件任何人都可以创建渐进式加载Token 使用效率高无需服务器或后端设置适用于 Web / Desktop / CLIMCP能力扩展:功能扩展连接 API、数据库、外部工具需要编码能力和服务器端配置启动时加载全部工具定义对外部系统集成能力强更高的 Token 消耗与复杂度Skill 的核心结构Skills 的核心就是一个文件夹 一个 SKILL.md 文件。SKILL.md 文件包含元数据至少要有名称和描述告诉 AI 如何完成某一特定任务的指令一个 Skill 本质上就是一个 Markdown 文件文件名固定为 SKILL.mdmy-skill/ └── SKILL.md 唯一必需SKILL.md 基本模板:--- name: pdf-processing description: 从 PDF 中提取文本和表格填写表单并合并文档 --- # PDF 处理 ## 使用场景 当需要对 PDF 文件进行操作时使用例如 - 提取 PDF 文本或表格数据 - 填写 PDF 表单 - 合并多个 PDF 文件 ## 提取文本 - 使用 pdfplumber 提取文本型 PDF 内容 - 扫描版 PDF 需配合 OCR 工具 ## 填写表单 - 读取 PDF 表单字段 - 按输入数据填充并生成新文件最小必填示例:--- name: skill-name description: 说明该 Skill 的功能以及适用场景 ---含可选字段示例:--- name: pdf-processing description: 从 PDF 中提取文本和表格填写表单并合并文档 license: Apache-2.0 metadata: author: example-org version: 1.0 ---字段说明字段必需说明name是Skill 名称最长 64 字符只能使用小写字母、数字和-且不能以-开头或结尾description是功能与使用场景说明最长 1024 字符不能为空license否许可证名称或指向随 Skill 附带的许可证文件compatibility否环境与依赖说明产品、系统包、网络权限等最长 500 字符metadata否自定义键值对用于扩展元数据如作者、版本号allowed-tools否允许使用的工具列表空格分隔实验性功能如果需要一些参考资料参考实例执行脚本可以使用更复杂 Skill 的目录结构my-skill/ ├── SKILL.md # 必需指令 元数据 ├── scripts/ # 可选可执行代码 ├── references/ # 可选文档资料 └── assets/ # 可选模板、资源技能如何工作技能用渐进式加载来高效管理上下文**发现**启动时AI 只加载每个技能的名称和描述只保留最基本的识别信息。**激活**当任务匹配某个技能的描述时AI 才把完整的 SKILL.md 指令读入上下文。**执行**AI 按照指令执行按需加载参考文件或运行代码。这种设计让 AI 保持快速同时能按需获取更多信息。Claude Code SkillsClaude Code 按以下顺序查找并加载 Skill越具体的位置优先级越高级别路径生效范围企业级通过管理控制台配置managed settings组织内所有用户个人级~/.claude/skills/skill-name/SKILL.md你所有项目项目级.claude/skills/skill-name/SKILL.md仅当前项目插件级plugin/skills/skill-name/SKILL.md启用该插件的环境每个 Skill 就是一个文件夹文件夹名即技能标识推荐 kebab-case 小写连字符。SKILL.md 完整格式 --- # YAML frontmatter 开始顶格 name: code-comment-expert # 必填技能名也是 /slash 命令名 description: - # 必填最关键一行Claude 靠它判断是否加载 为代码添加专业、清晰的中英双语注释。 适合缺少文档、可读性差、需要分享审查的代码。 常见触发场景加注释、注释一下、加文档、explain this、improve readability trigger_keywords: # 强烈推荐大幅提升自动触发率 - 加注释 - 注释 - 加文档 - explain code - document - comment this - readability version: 1.0 # 可选 author: yourname # 可选 --- # ← YAML 结束 # 这里开始是正文Markdown—— Claude 真正执行时的指令 你现在是「专业代码注释专家」。 ## 核心原则 - 只在缺少注释或可读性明显不足处添加 - 优先使用英文 JSDoc / TSDoc 风格 - 复杂逻辑 / 非明显意图处额外加一行中文解释 - 注释精炼每行不超过 80 字符 - 绝不修改原有逻辑 ## 输出格式严格遵守 1. 先输出完整修改后的代码块用 语言 包裹 2. 再用 diff 形式展示只改动注释的部分 3. 最后说明加了哪些注释、理由 现在直接开始处理用户提供的代码不要闲聊。