---
site: "zyx.tw"
title: "Skill 保存同類任務的做法，個案細節留在專案"
description: "用適用範圍判斷哪些步驟值得重用，哪些資料應留在專案。"
url: "https://www.zyx.tw/map/basics/skill-loads-on-demand"
---

# Skill 保存同類任務的做法，個案細節留在專案

紀錄 039，觀念 L1，559 字，1 分鐘，v2.0.0，更新 2026-11-16

Skill 是寫給 agent（執行任務的 AI 助手）的任務做法，例如撰寫文章或製作新頁面的步驟。在不同對話反覆交代相同步驟時，就可以整理成 Skill。

新對話只載入 Skill 的名稱與說明。Claude Code 依名稱與說明判斷是否適用，符合時才載入全文；CLAUDE.md 則是每次新對話都載入全文的規則檔。詳細過程見 Skill 的載入過程。

## 先判斷規則適用的範圍

每個任務都需要知道的要求，放進 CLAUDE.md。只有特定類型任務需要的步驟，才寫成 Skill。

全文載入後會持續佔用 context，也就是一次請求送給模型的全部內容。無關個案也會跟著載入，過時的網址等細節則可能讓 agent 沿用舊做法。

同類任務共用的做法放進 Skill，專案名稱、網址與個案資料留在專案文件。

是否載入取決於說明，因此 description 要寫出適用任務與常見說法，例如「撰寫文章、製作新頁面」。下圖對照不同任務需要讀取的內容。

**新對話的任務 修改錯字**

每次載入:
- CLAUDE.md 全文
- Skill 的名稱與說明

任務需要才載入:
- 範例任務沒有用到 Skill

未載入的內容:
- Skill 全文

假設任務未符合任何 Skill 說明。Claude Code 就不載入 Skill 全文。

**新對話的任務 撰寫文章**

每次載入:
- CLAUDE.md 全文
- Skill 的名稱與說明

任務需要才載入:
- article 全文

未載入的內容:
- 其他 Skill 全文

任務符合 article 的說明。Claude Code 載入 article 的全文。

**新對話的任務 製作新頁面**

每次載入:
- CLAUDE.md 全文
- Skill 的名稱與說明

任務需要才載入:
- simple-first 全文

未載入的內容:
- 其他 Skill 全文

任務符合 simple-first 的說明。Claude Code 載入 simple-first 的全文。

## 通則仍然要能執行

通則不能只剩抽象要求。例如接新系統時，可以保留「先辨識底層平台，優先使用官方 API」的探索方法，但不保留特定站點的網址。

收到糾正時，先判斷其他同類任務是否也適用。適用時，可以這樣交代：

```
請把這次的做法寫回 Skill，整理成同類任務都能用的通則。
```

下圖示範如何依糾正的適用範圍，選擇保存位置。

**糾正適用的範圍 同類任務都適用**

寫到哪裡:
- 寫進通用 Skill

誰會讀到:
- 之後執行同類任務的 Claude Code

把通則與本次修正放在同一個 pull request。

**糾正適用的範圍 只適用於特定專案**

寫到哪裡:
- 寫進該專案的文件

誰會讀到:
- 在該專案工作的 Claude Code

個案留在專案文件，不寫進通用 Skill。

**糾正適用的範圍 相同糾正仍然出現**

寫到哪裡:
- 改成自動檢查
- 刪除 Skill 裡對應的文字規則

誰會讀到:
- 由自動檢查擋住違規修改

文字規則未能擋住問題時，改用自動檢查。

## 專案專用的內容有不同邊界

但只供單一專案使用的驗證 Skill，可以保留該專案的驗證指令。

## 來源

- [Agent Skills specification](https://agentskills.io/specification), agentskills.io
- [Extend Claude with skills](https://code.claude.com/docs/en/skills), Claude Code docs
- [Equipping agents for the real world with Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills), Anthropic
- [Operating Systems: Three Easy Pieces](https://pages.cs.wisc.edu/~remzi/OSTEP/), Arpaci-Dusseau
- [Agent Skills](https://agentskills.io/), agentskills.io

## 地圖

- 原理：[Skill 的載入由模型決定，harness 負責把全文送進對話](https://www.zyx.tw/map/basics/how-a-skill-loads.md)
- 原理：[Plugin 發版要同步更新目錄，跨 agent 才能安裝同一版本](https://www.zyx.tw/map/basics/plugin-ships-by-version.md)
- 應用：[我先讀懂開源做法，再把適用步驟寫成自己的規則](https://www.zyx.tw/map/principles/read-before-adopting.md)
- 相關：[先確認任務缺什麼，再選擇擴充方式](https://www.zyx.tw/map/basics/four-ways-to-extend.md)
- 相關：[CLAUDE.md 依範圍串接規則，寫好後仍要用新任務確認落實](https://www.zyx.tw/map/basics/claude-md.md)
- 相關：[我先刪掉不需要的功能，再讓主要動作最顯眼](https://www.zyx.tw/map/craft/simple-first.md)
- 回到：[基礎](https://www.zyx.tw/map.md)
