> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> 為外部代理程式與 Automations 建立可重複使用的套件

Skills 是由指示與選用支援檔案組成的可重複使用套件。它們讓您的團隊只需定義一次完成某項任務的可重複方式，便能在 Flowglad 中一致地套用。

每個 Skill 都有名稱、斜線指令 slug、說明，以及以 Markdown 撰寫的指示。支援檔案可提供遵循這些指示所需的額外脈絡或資源。

## 將 Flowglad 作為團隊的 Skill 程式庫

Flowglad 會將每個 Skill 保存為具版本控制的套件。發布變更會建立新的修訂版本，而不是就地取代先前的套件。組織管理員可以開啟 Skill 的 **History**，在相關操作可用時檢視其修訂版本、比較變更、還原較早的修訂版本，或捨棄草稿。

這讓您的團隊有一個受管控的地方來維護可重複使用的指示，同時保留在特定時間點啟用的是哪個版本。草稿與被拒絕的修訂版本不會取代目前啟用的版本。

### 透過 MCP 管理 Skills

連接 Flowglad MCP 伺服器後，代理程式即可代您檢視並管理組織的 Skill 程式庫：

* `skills.list` 會傳回該連線可見的 Skills。
* `skills.get` 會傳回單一 Skill 最新及啟用中修訂版本的中繼資料。
* `skills.create` 會提交新的 Skill 套件。
* `skills.create_candidate` 會為既有 Skill 提交新的修訂版本。
* `skills.publish_revision` 會驗證並發布延後的修訂版本。
* `skills.create_package_upload_session` 與 `skills.finalize_package_upload_session` 用於傳輸過大而無法內嵌傳送的套件。
* `skills.get` 會回報已接受請求的驗證與升級結果。

建立或更新 Skills 需要團隊成員的組織成員資格與 MCP 連線授權兩者都具備 `skills:write` 權限。如果您在連接伺服器後才新增權限，請重新連接 Flowglad MCP 並授權 `skills:write`，寫入工具才會變為可用。

**權限：** 管理員預設具有 Skill 撰寫權限。若要給予 Contributor 相同權限，請開啟 **Settings** → **Team**，選取該團隊成員，然後啟用 **Skill Authoring**。這會授予建立與更新組織 Skills 的權限，而不會讓該團隊成員成為管理員。

## 將 Flowglad MCP Skills 載入您的代理程式

Flowglad MCP 伺服器會在 MCP 初始化期間宣告 `io.modelcontextprotocol/skills`。這會告知相容的用戶端，該伺服器實作了代理程式 Skill 方法 `skills/list` 與 `skills/get`。每個傳回的 Skill 都包含 `skill://` 資源 URI 與內容摘要；用戶端可以使用 `resources/read` 擷取檔案。

連接伺服器並不保證用戶端會呼叫 `skills/list` 或安裝傳回的套件。各用戶端的支援程度不一。若您希望代理程式在每個工作階段開始時重新整理 Flowglad registry，請為 ChatGPT / Codex 或 Claude 加入啟動指示。

**MCP 命名：** 這些名稱是刻意設計成不同的。以點號分隔的 `skills.list` 是 Flowglad 工具，用於組織具版本控制的 Skill 紀錄。以斜線分隔的 `skills/list` 是 MCP 協定擴充方法，用於探索面向代理程式的 Skill 套件。

### 加入啟動指示

在開始新的工作階段之前，先建立一次目標目錄，然後加入下方對應的指示區塊。

#### ChatGPT / Codex

使用 `mkdir -p ~/.agents/skills` 建立 ChatGPT / Codex 的目標目錄。

將下列區塊放入 `~/.codex/AGENTS.md` 以套用至每個專案，或放入儲存庫的 `AGENTS.md` 以與該儲存庫的團隊共用。

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

使用 `mkdir -p ~/.claude/skills` 建立 Claude 的目標目錄。

將下列區塊放入 `~/.claude/CLAUDE.md` 以套用至每個專案，或放入儲存庫的 `CLAUDE.md` 以與該儲存庫的團隊共用。

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

您可以請 ChatGPT / Codex 或 Claude 將適當的區塊加入其使用者層級的指示檔案。由於該檔案會影響未來的工作階段，請在接受之前先檢查提議的編輯內容。此指示是盡力而為的代理程式啟動程序；如果您的環境必須以確定性的方式重新整理 Skills，請在受信任的 `SessionStart` hook 或您的 MCP 用戶端整合中實作相同的同步機制。

## Skills 的使用位置

Skills 目前有兩種使用者：

* 相容的外部代理程式會透過 Flowglad MCP 探索並同步已啟用的套件，然後自動比對或依名稱呼叫。
* Automations 會將某個已發布的 Skill 修訂版本釘選為 OWS `skill-revision` 程式碼資源。Automation 會選擇套件路徑與進入點；代理程式步驟只會收到經封存之執行能力集授權的 Skills。

第一種路徑將可重複使用的指示提供給外部代理程式。第二種路徑則將不可變的程式碼與支援檔案提供給可重複的 Automation 執行。已發布的 Skills 適用於整個組織，因此經授權的 Automation 可以在任何 Space 中選用相同的 Skill 修訂版本。使用該 Skill 的 Automation 及其執行仍歸屬於其 Space；選用 Skill 不會改變此邊界。

## 建立與維護 Skills

開啟 **organization menu** → **Skills** → **New Skill**。在 **Skill** 分頁中，輸入 **Name**、**Slug**、選填的 **Description**，以及以 **Markdown** 撰寫的可重複使用指示。使用 **Files** 分頁新增任何支援的套件檔案，然後選取 **Create Skill**。

Slug 使用小寫字母、數字與連字號，須以字母或數字開頭，也就是使用者在 `/` 之後輸入的內容。

建立或編輯 Skill 會產生草稿。在 Skill 詳細資料頁面上，編輯內容會自動儲存；選取 **Publish Draft** 即可驗證並發布草稿。如果驗證失敗，請依據顯示的診斷資訊修正草稿，然後再次發布。

在相關操作可用時，使用 **History** 檢視修訂版本、還原已被取代的修訂版本，或捨棄可變的草稿。**Disable Skill** 會將其從外部代理程式探索與 Automation 解析中移除，但不會刪除修訂歷史；**Enable Skill** 則會讓它重新可用。

## 使用 MCP 建立或編輯 Skill

使用已連接的外部 MCP 用戶端進行以套件為主的撰寫。編輯既有 Skill 之前，請先呼叫 `skills.get`。新套件請使用 `skills.create`，以目前啟用中的修訂版本為基礎的修訂則使用 `skills.create_candidate`。

小型套件可以內嵌提供。較大的套件請呼叫 `skills.create_package_upload_session`，上傳所要求的物件，最後以 `skills.finalize_package_upload_session` 完成。如果驗證被延後，請呼叫 `skills.publish_revision`。輪詢 `skills.get` 以取得已接受的生命週期請求及其驗證或升級結果。

發布 Skill 不會建立、修訂或啟用 Automation；需要時請明確使用 Automation MCP 生命週期。

## 從 Skill 範本開始

**Skills** 頁面包含 **Skill Templates**。搜尋或篩選目錄、預覽範本，然後選取 **Copy Skill**。複本會成為組織 Skill，可以像其他 Skill 一樣編輯與發布。

## Skills 與 Automations

Skill 定義如何執行可重複使用的工作，但不決定該工作何時執行。

當工作需要手動執行、依排程執行或回應事件而執行時，請使用 Automation。Automation 可以釘選一或多個 Skill 修訂版本，讓相同的實作在各次執行中重複使用。


## Related topics

- [MCP](/docs/zh-TW/mcp-server.md)
- [Automations](/docs/zh-TW/automations.md)
- [歡迎](/docs/zh-TW/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.