Skip to main content
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 以與該儲存庫的團隊共用。
AGENTS.md

​
Claude

使用 mkdir -p ~/.claude/skills 建立 Claude 的目標目錄。 將下列區塊放入 ~/.claude/CLAUDE.md 以套用至每個專案，或放入儲存庫的 CLAUDE.md 以與該儲存庫的團隊共用。
CLAUDE.md
您可以請 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 修訂版本，讓相同的實作在各次執行中重複使用。