Claude Code 非工程师实战・第 4 篇・约 13 分钟

把每周都要做的事变成一张技能卡：Agent Skills 入门（会议记录与发票归档）

写作时版本：Claude Code 2.1.x／2026 年 11 月（内容依官方文档 2026-11 查阅整理）。 Claude Code 更新很快，界面文字、指令名称、默认值都可能改变。看到的界面和本文不一样时，请以官方文档为准。

这篇文章要帮你做到什么

上一篇我们把「每次都该知道的规则」写进了 CLAUDE.md。但你一定还有另一种事：每周（或每次开完会）都要照同一套步骤做一遍的工作。

例如：

• 开完会，把逐字稿整理成「决议、待办、负责人、期限」的会议记录
• 月底，把这个月的发票照片／PDF 按月份、类别归档，再列一张清单

这类「好几个步骤的固定流程」，如果每次都重新打一大段指示给它，很累，也容易漏讲。解法是做成一张技能卡（官方名称 Skill，文件名 SKILL.md）：写一次，之后输入一个斜杠命令，或直接说一句话，它就照着你写的流程做。

官方文档的建议时机也很直白：当你「不断把相同的指示、检查清单或多步骤程序粘贴到聊天中」，或 CLAUDE.md 的某一段已经长成「流程」而不是「事实」时，就该做成技能卡。

读完这篇你会：

• 分清 CLAUDE.md 和技能卡各放什么
• 知道技能卡要放在哪个文件夹、长什么样子
• 手把手做出第一张「会议记录」技能卡，并用两种方式调用
• 做出第二张「发票归档」技能卡，学会用 disable-model-invocation 让它只有你喊才会动
• 技能卡没反应时怎么查

需要准备：

• 已按第 1 篇装好并登录 Claude Code
• 沿用 Claude练习 文件夹；建议顺手看过第 3 篇
• 约 40 分钟

先搞懂：技能卡 vs. CLAUDE.md

官方文档的说法是：skill 的主体只在使用时才加载，所以再长的流程，平常几乎不占空间。所以：规则放 CLAUDE.md，流程放技能卡。

技能卡放在哪里

技能卡是「一个文件夹，里面一个叫 SKILL.md 的文件」。官方文档列了很多种位置，非工程师记这两个就够：

文件夹名称就是斜杠命令的名字。 例如 .claude/skills/meeting-minutes/SKILL.md 会变成 /meeting-minutes。

提醒三件事（都来自官方文档）：

1. 同名时，优先顺序是：企业 > 个人 > 项目。不要在两处放同名的卡。
2. 官方文件说，Claude Code 会监看这些技能文件夹，你在工作中新增或修改技能卡，不用重新启动就会生效。（例外：你是在「启动位置的下一层子文件夹」才有的 .claude/skills/，要等它读到那个子文件夹的文件才会加载。）
3. 本文为了好懂，英文文件夹名称用 meeting-minutes、invoice-archive；名称建议用英文小写加连字符，避免特殊符号（官方有名称字符限制，名称被拒绝时启动时会有通知）。

技能卡长什么样子

一张技能卡由两段组成：

---
description: 這張卡做什麼、什麼時候該用
---

（這裡用白話寫步驟，它會照著做）

上面两条 --- 之间叫「说明区」（frontmatter）。重点是 description：Claude 靠它判断「现在这件事该不该用这张卡」。官方建议把最关键的用途放在最前面，并写进你平常会自然说出口的字眼（例如「会议记录」「逐字稿」）。

两条 --- 底下是正文，就是你的步骤。官方也提醒：说明区的 --- 必须是文件的第一行，否则整份都会被当成正文。

步骤 1：创建文件夹（会议记录技能卡）

先在练习文件夹准备一份假的逐字稿。用记事本新建 C:\Users\你的名字\Claude练习\逐字稿\20261105_采购检讨.txt，粘贴进：

小安：今天要討論新供應商報價。
大明：A 廠比 B 廠便宜 8%，但交期要 21 天。
小安：我們庫存只剩兩週，我覺得 B 廠比較穩。
大明：那就決定先跟 B 廠下一小批試單，下週三前我去談。
小美：我來整理兩家的比較表，週五前給大家。
小安：好，下次會議 11 月 19 日再看試單結果。

（人名、公司均为虚构。）

接着用 PowerShell 创建技能卡文件夹（只给这个练习文件夹用）：

cd "$env:USERPROFILE\Claude練習"
mkdir .claude\skills\meeting-minutes

（若出現「已存在」的提示就代表之前建過，直接下一步）

想要「所有文件夹都能用」，就改建在 $env:USERPROFILE\.claude\skills\meeting-minutes。

步骤 2：写 SKILL.md

用记事本新建文件，另存到 meeting-minutes 文件夹里，文件名 SKILL.md（保存类型选「所有文件」、编码选 UTF-8，不然会变成 SKILL.md.txt 或乱码）。粘贴入：

---
description: 把會議逐字稿整理成會議紀錄（決議、待辦、負責人、期限）。當使用者提到會議紀錄、逐字稿、整理會議時使用。
---

# 會議紀錄整理流程

使用者會指定一份逐字稿檔案（txt 或 docx）。請依序做：

1. 讀取該檔案。如果使用者沒說是哪一份，列出「逐字稿」資料夾的檔案，問使用者選哪一份。
2. 整理成下面的格式，用繁體中文（台灣用語）：
   - 會議名稱、日期（逐字稿檔名開頭若有 YYYYMMDD 就用它；找不到就標「待確認」）
   - 出席者
   - 決議事項（條列，每條一句話）
   - 待辦事項（表格：事項｜負責人｜期限）
   - 下次會議時間（沒提到就寫「未提及」）
3. **不要猜**：逐字稿沒有明講的負責人或期限，一律填「待確認」，不要自己補。
4. 把結果存成新檔案，放在「會議紀錄」資料夾（沒有就建立），檔名格式：
   YYYYMMDD_會議_主題_v1.md。若同名檔案已存在，版本號加 1，**不要覆蓋舊檔**。
5. 最後用 3 行說明：存到哪裡、有幾項決議、有幾項待確認。

几个小设计，是这张卡好用的原因：

• 「不要猜」：最容易出事的就是它帮你补上不存在的期限。明确叫它填「待确认」。
• 「不要覆盖旧文件」：延续第 2 篇的安全习惯。
• 最后的 3 行回报：让你不用打开文件就知道结果是否正常。

步骤 3：调用它（两种方式）

在 Claude练习 文件夹启动：

cd "$env:USERPROFILE\Claude練習"
claude

方式一：直接输入斜杠命令（最稳）

/meeting-minutes 逐字稿\20261105_採購檢討.txt

斜杠后面的文字，会当成「你给这张卡的额外信息」一起交给它（官方文档：调用时传入的参数会附加进去）。

方式二：用说的

幫我把採購檢討的逐字稿整理成會議紀錄

因为 description 写了「会议记录、逐字稿」，Claude 会判断要不要自动加载这张卡。自动判断有时会失手，没用到也不意外，这时直接用方式一就好。

预期结果：会议记录\20261105_会议_采购检讨_v1.md 出现，内容应该像这样（你的输出文字会有差异，重点是结构与「待确认」）：

決議事項
- 先向 B 廠下一小批試單
待辦事項
| 事項 | 負責人 | 期限 |
| 與 B 廠洽談試單 | 大明 | 下週三前（具體日期待確認） |
| 整理兩家比較表 | 小美 | 週五前（具體日期待確認） |
下次會議：11 月 19 日

这里有个值得注意的细节：逐字稿只说“下周三”“周五”，没有给日期。好的结果会把它们标成待确认，而不是自己换算成日期。 如果它直接写了具体日期，就回到 SKILL.md 把“不要猜”那条讲得更具体，再试一次。

步骤 4：确认它在列表里

技能卡没反应时，第一件事是确认它有没有被加载。在 Claude Code 里输入：

/skills

官方文档有这个命令，会列出当前可用的技能。你的 meeting-minutes 应该在里面。也可以直接问：

你現在有哪些技能可以用？

（界面因版本而异，作者未逐版核对。）

步骤 5：第二张卡——发票归档（只准我喊才动）

会议纪要是“整理完存为新文件”，风险低。发票归档要移动文件，这种事不该让它自己判断要不要做。

官方文档为此提供一个字段：disable-model-invocation: true。意思是：Claude 不会自动加载这张卡，只有你输入 /名称 时才会动。官方文档的说明是，这适用于“有副作用、你想控制时机”的工作流程，例如部署、提交。

创建文件夹并写入：

mkdir "$env:USERPROFILE\Claude練習\.claude\skills\invoice-archive"

SKILL.md 内容：

---
description: 把「待歸檔發票」資料夾裡的發票檔案，依月份歸檔並產生清單。
disable-model-invocation: true
---

# 發票歸檔流程

使用者會告訴你要處理哪個月份（例如 2026-10）。請依序做：

1. 列出「待歸檔發票」資料夾的所有檔案，**先不要動任何檔案**。
2. 依檔名或內容判斷日期與類別（交通、餐飲、辦公用品、其他）。判斷不出來的歸「待確認」，不要猜。
3. 產生一張對照表給使用者看：舊檔名｜日期｜類別｜新位置。
4. **等使用者回答「好」才動手。** 使用者沒說好，就不要搬任何檔案。
5. 同意後：
   - 先把「舊檔名清單」存成 CSV（備份，之後可救回）。
   - **複製**（不是搬移）檔案到「發票歸檔\YYYY-MM\類別\」，檔名格式：YYYYMMDD_類別_金額.副檔名。
   - 不刪除、不覆蓋任何檔案。
6. 最後產生 `發票歸檔\YYYY-MM\清單.csv`（日期、類別、金額、檔名），並說明有幾筆、幾筆待確認。

这张卡把前两篇学的三个安全习惯都写进去了：先给对照表、同意才动手、复制而不是移动并保留备份。

调用方式：

/invoice-archive 2026-10

先拿 5 个假发票文件（随便几个命名像发票的 txt／图片）测试，不要一开始就拿真的发票。

提醒：disable-model-invocation 只管“它会不会自动加载这张卡”。真正的刹车还是第 1 篇的权限模式（动手前它会问你）以及卡片里“等我说好”的规则。两层一起用。

技能卡没反应时，怎么查

依官方故障排除顺序，翻成白话：

1. 先 /skills，看卡有没有列出来。 没有 → 文件夹位置错了（应为 .claude/skills/名称/SKILL.md，注意是 .claude 前面有个点）或文件名不是 SKILL.md（常见：变成 SKILL.md.txt）。
2. 直接输入 /名称。 能调用、但说话时不会自动触发，通常是 description 没包含你平常会讲的字眼。改写 description 再试。
3. 说明区的 --- 要在第一行，而且中间的 YAML 格式要正确。格式坏掉时，官方说技能还是会加载正文，所以 /名称 仍然能用，但 Claude 没办法用 description 判断何时该用。
4. /名称 也没反应？ 可能是名称被拒绝（有特殊字符）。可以用 claude --debug 启动查看。
5. 改了卡，结果没变？ 官方说明，技能内容在当前会话中加载后，就是加载当下的版本；如果不确定，离开再重新启动（输入 /exit，再输入 claude）最保险。
6. 要自动化排程的话要注意： 官方说明，只存在你电脑 ~/.claude/skills/ 中的技能卡，云端运行的定时任务读取不到。这点下一篇（定时任务）会再谈。

四个「不要」

1. 不要把密码、账号、客户资料写进 SKILL.md。 技能卡可能被复制、分享给同事。
2. 不要一张卡塞太多事。 一张卡一件事，名称一看就懂。
3. 不要让有副作用的卡（搬文件、删文件、寄信）能自动触发。 加上 disable-model-invocation: true，并写“先给我看、同意才动手”。
4. 不要写了就信。 每张新卡都用假数据跑一次，看结果符不符合你的预期，再拿真的数据。

想直接拿现成的？

自己写第一张最花时间，因为你要摸索“说明要写到多具体、哪些要明讲不准做”。我们整理了一组可以直接放进 .claude/skills/ 的技能卡，包含会议纪要、文件整理、报表等常见办公情境，每张都写好结构与“不要猜”“同意才动手”的安全规则，你只要改成自己的文件夹名称。

👉 看数字商品

（不买也没关系：上面这两张就足以让你开始用，照着改成你自己的流程即可。）

下一篇预告

第 5 篇：《不用守着电脑：让 Claude Code 每天自己跑一次》 技能卡让流程“一句话就能跑”；下一篇教你再往前一步，让它按时间自己跑，以及为什么“权限白名单、记录档、哪些事绝对不要交给定时任务”比怎么排更重要。

参考来源（均为官方文档，2026-11 查阅）

• 使用 skills 扩展 Claude（位置、SKILL.md 格式与字段、disable-model-invocation、参数、实时变更检测、故障排除）：https://code.claude.com/docs/zh-CN/skills
• Agent Skills 开放标准：https://agentskills.io

操作说明：技能卡位置、frontmatter 字段、/skills、disable-model-invocation、实时变更检测与故障排除均依上述官方文档整理，本篇示例技能卡未在作者电脑上逐项实测输出，文中“预期结果”为示意，实际输出会有差异（待验证）；mkdir 命令为 Windows PowerShell 写法，Mac 请改用 Terminal 的 mkdir -p .claude/skills/meeting-minutes，路径 ~/.claude/skills/ 相同。示例中的人名、公司与逐字稿均为虚构。

同系列延伸阅读

• 不用写程序也能用 Claude Code：第一个自动化任务，把乱成一团的下载文件夹整理好
• 100 个“最终版(2)”文件名：用 Claude Code 批量改名，而且改错可以救回来
• 让它记住你的习惯：非工程师的 CLAUDE.md 怎么写

← 返回文章列表