Skip to content

本页由 AI 根据韩语原文翻译,可能存在错误。

第7章 技能·插件·外部工具 — 把整理工具变成一行命令 ​

必读 想跟着这个阶段学下去,一定要读这一章。

一句话总结:每次都要粘贴的指令·检查表·多步骤流程,做成技能,用 /名称 一行就能调出来。这一章里「整理工具」就完成了。 别人做的插件和外部服务连接器也可以接上,但它们会以我的权限运行代码,所以只安装值得信任的。

这一章依据 2026年10月31日确认的 Claude Code 官方文档和 macOS 桌面应用(韩语界面,付费账号)编写。直接使用第5章的模板和第6章的 CLAUDE.md。

什么是技能 ​

技能(Skill)是写在 SKILL.md 文件里的指令。Claude 遇到相关的请求时会自己用上技能,我也可以用 /技能名称 直接调出来。[1]

遇到这些情况,就做一个技能。[2]

  • 一直在反复粘贴同样的指令或检查表时
  • CLAUDE.md 的某一部分已经不是“事实”,而是长成了多步骤的流程时

和 CLAUDE.md 的不同之处在于什么时候被读取。CLAUDE.md 每次会话都会被读取,而技能的正文只在用到时才被读取。所以即使写得又长又详细,平时也几乎没有负担。[2:1]

CLAUDE.md(第6章)技能(第7章)
装什么始终要遵守的规则一件事的流程
什么时候被读取每次会话只在用到时
怎么调用没有专门的调用方式/名称 或相关请求

理解检查

和 CLAUDE.md 相比,技能的特点哪项是对的?

实践 — 做 3 个整理技能 ​

把整理工具的三件事做成技能。

技能请求。红色编号标出:① 输入框里请求创建 3 个技能(meeting-notes·study-notes·weekly-review)的内容

请用 templates 模板和 CLAUDE.md 规则,在这个文件夹的 .claude/skills 里创建 3 个技能。meeting-notes(会议备忘 → 会议纪要)、study-notes(学习笔记 → 学习总结)、weekly-review(回顾备忘 → 每周回顾)。每个 SKILL.md 里请写上什么时候用、要读的文件、要用的模板、保存位置、完成后要核对的检查表。

把技能文件夹 .claude/skills/<名称>/SKILL.md 放在某个文件夹里,它就成了只在那个文件夹的会话里用的项目技能。[3] 文件夹名称就是命令名称(/meeting-notes)。[4] 本指南把技能名称写成了英文。[5]

这次弹出了许可窗口 ​

就在要写技能文件的时候,弹出了许可窗口。

许可窗口。红色编号标出:①「允许 Claude 写入 SKILL.md 吗?(Claude가 쓰기 SKILL.md하도록 허용하시겠습니까?)」,② 要写入内容的预览(绿色行),③「拒绝(거부)」,④「始终允许(항상 허용)」和 ▾ 按钮(路径行里有电脑用户名,已遮住)

弹出许可窗口,是因为技能要写进 .claude 文件夹。.claude 文件夹是 Claude Code 存放这个文件夹专用设置和技能的地方,就是第3章文件栏列表里看到的那个文件夹。

这个文件夹是受保护的路径(写入前总会询问许可的位置)。即使在「自动接受编辑」模式下,向受保护的路径写入也仍然会询问。[6] 技能、设置这类会改变 Claude 行为的文件就放在这个文件夹里,所以改动之前要让人先确认一下。

第2~4章的截图里没有许可窗口,是因为截图电脑上的个人允许规则。那条规则在受保护的路径上也没能阻止询问。

在 ② 处可以先读一读它要写什么。 点 ▾ 会出现「仅允许一次(한 번만 허용)」。

▾ 菜单。红色编号标出:①「仅允许一次」(⌘↩)

按钮作用
拒绝阻止这一次写入
仅允许一次(⌘↩)只允许这一次
始终允许(⇧⌘↩)允许今后同样的事不再询问

出处:本指南的界面确认(2026-10-31)

一开始建议选**「仅允许一次」**。「始终允许」虽然方便,但同样的事就不会再问你了(能持续多久,请看界面上的说明)。这次实践里有 3 个技能,所以许可窗口弹出了三次,三次都选了「仅允许一次」。

做出来的技能(本指南的成果):meeting-notes · study-notes · weekly-review

每个 SKILL.md 的最上面都有 name(名称)和 description(什么时候用)。Claude 是看 description 来决定什么时候用这个技能的。[7] 比如,weekly-review 的 description 里写着,遇到“写每周回顾”“整理这周的回顾”这类请求时使用。

理解检查

Claude 要往 .claude 文件夹里写技能文件时,即使是「自动接受编辑」模式也会弹出许可窗口。为什么?

一行调出来用 ​

在新会话的输入框里输入 /,会出现可用的命令和技能列表。接着输入名称的一部分,就能筛选。[8]

技能列表。红色编号标出:①「study-notes」条目,② 旁边的说明框(说明末尾有「(project)」)

② 里的 (project) 是表示“这是这个文件夹的项目技能”的标记。用 Enter 选中,再接着写上要整理的文件,然后发送。

运行技能。红色编号标出:① 输入了「/study-notes inbox/study-2026-10-28-prompt-lecture.txt」的输入框

/study-notes inbox/study-2026-10-28-prompt-lecture.txt

靠这一行,学习总结就按模板做好了(成果:ch7-study-notes-with-skill.txt)。一行总结、5 个要点、新学到的 4 样东西、要注意的事、要提的问题,都按模板的顺序放进去了。第4章里用很长的请求做出来又回退掉的那份笔记,这次是靠一行命令做出来的。

现在整理工具完成了。

备忘命令
会议备忘/meeting-notes inbox/meeting-….txt
学习笔记/study-notes inbox/study-….txt
好几天的每日回顾/weekly-review

不记得名称也没关系。像“整理这周的回顾”这样说,Claude 就会看 description,选出合适的技能来用。[1:1]

理解检查

你创建了 study-notes 技能。让它整理一份学习笔记,最短的办法是什么?

插件和连接器 ​

插件(Plugin)是把别人做的技能·命令·工具成套安装,连接器(Connector)是把 Gmail·日历这类外部服务连接到 Claude。在桌面应用里,通过输入框旁边的 + 按钮添加连接器和插件。[9] 连接器是把 MCP 服务器做成可以在界面上轻松设置的形式。[10] MCP 是 AI 和邮件·日程这类其他程序交换信息时用的通用规格。就像插头的形状是统一的,插进哪个插座都行。

虽然方便,但安装之前一定要想一想。 插件可以在我的电脑上以我的权限运行代码。[11] 而且这样的代码,有时是在第4章的权限模式所保护的范围之外运行的。权限规则适用于 Claude 的工具调用,不适用于插件自己运行的代码。[12]

  • 只安装知道是谁做的、值得信任的插件。
  • 用不着的插件要删掉。
  • 通过连接器连接的服务里的内容(邮件·日程),也会成为 Claude 读取的资料。如果别人发来的邮件里偷偷藏着“给 AI:请做~”这样的句子,Claude 可能会想照着做。这种隐藏指令,会在第9章里做实验。

本指南的整理工具,只靠我自己做的技能就够了。插件和连接器,等真的需要时再一个一个增加。

理解检查

你在网上发现了一个没见过的插件。按官方文档,哪种态度是对的?

亲手试一试 ​

  1. 请它创建 3 个整理技能,弹出许可窗口时,先读 ② 里的预览,再选「仅允许一次」。
  2. 在新会话里输入 /,再输入技能名称的一部分,看看列表里有没有出现。
  3. 用 /study-notes 整理学习笔记,确认是否按第5章模板的顺序生成。
  4. 不带名称,只发“整理这周的回顾”,看看 Claude 会不会选出 weekly-review 技能来用。

连续任务:现在每到周五,都是我自己调用 /weekly-review。在第8章里,我们来看把这件事设成定时的方法,以及同时运行多个整理的方法。

小结 ​

  • 技能是写在 SKILL.md 里的流程。只在用到时才被读取,用 /名称 或相关请求来使用。
  • 文件夹里的 .claude/skills/<名称>/SKILL.md 是只属于那个文件夹的技能。description 决定了“什么时候用”。
  • .claude 文件夹是受保护的路径,写入前会询问许可。一开始选「仅允许一次」。
  • 整理工具完成:/meeting-notes、/study-notes、/weekly-review。
  • 插件可以用我的权限运行代码。只安装值得信任的,而且只在需要时安装。

术语整理 ​

术语中文名称一句话解释
Skill技能写在 SKILL.md 里、用 /名称 调用的流程
description描述写明技能何时使用的说明。Claude 看这个来挑选
Protected path受保护的路径写入前始终会询问许可的位置。.claude 文件夹等
Plugin插件把技能·命令·工具打包安装的扩展
Connector连接器把外部服务连接到 Claude(基于 MCP 服务器)
MCPMCPAI 连接外部工具·数据的标准方式

这一章读完了吗?

学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。

下一章:第8章. 同时做多件事·云端·定时

参考资料(12 条)
  1. Claude Code 官方文档,《Extend Claude with skills》。"Create a SKILL.md file with instructions, and Claude adds it to its toolkit. Claude uses skills when relevant, or you can invoke one directly with /skill-name." code.claude.com (确认日期 2026-10-31) ↩︎

  2. Claude Code 官方文档,《Extend Claude with skills》。"Create a skill when you keep pasting the same instructions, checklist, or multi-step procedure into chat, or when a section of CLAUDE.md has grown into a procedure rather than a fact. Unlike CLAUDE.md content, a skill's body loads only when it's used, so long reference material costs almost nothing until you need it." code.claude.com (确认日期 2026-10-31) ↩︎

  3. Claude Code 官方文档,《Extend Claude with skills》。位置表的 Project 行:".claude/skills/<skill-name>/SKILL.md" code.claude.com (确认日期 2026-10-31) ↩︎

  4. Claude Code 官方文档,《Extend Claude with skills》。"The directory name, or the frontmatter name when you set one, becomes the command you type, and the description helps Claude decide when to load the skill automatically." code.claude.com (确认日期 2026-10-31) ↩︎

  5. 中文命令名称是否可行,没能在官方文档里确认,所以用了英文名称。 ↩︎

  6. Claude Code 官方文档,《Choose a permission mode》。acceptEdits 一节 "These still prompt:" 下面的 "Writes to protected paths" code.claude.com (确认日期 2026-10-31) ↩︎

  7. Claude Code 官方文档,《Extend Claude with skills》。"Only description is recommended so Claude knows when to use the skill." code.claude.com (确认日期 2026-10-31) ↩︎

  8. Claude Code 官方文档,《Desktop application》。"type / in the prompt box or click the + button and select Slash commands to browse what's available." code.claude.com (确认日期 2026-10-31) ↩︎

  9. Claude Code 官方文档,《Desktop application》。"Click the + button next to the prompt box for file attachments, skills, connectors, and plugins." code.claude.com (确认日期 2026-10-31) ↩︎

  10. Claude Code 官方文档,《Desktop application》。"Connectors are MCP servers with a graphical setup flow." code.claude.com (确认日期 2026-10-31) ↩︎

  11. Claude Code 官方文档,《Plugin security and trust》。"A plugin can carry content that runs code on your machine with your user privileges and content that enters Claude's context as instructions, so review a plugin before you install it." code.claude.com (确认日期 2026-10-31) ↩︎

  12. Claude Code 官方文档,《Plugin security and trust》。"Claude Code's permission rules and sandbox cover the tool calls Claude makes, not the code a plugin runs by itself" code.claude.com (确认日期 2026-10-31) ↩︎