代理專區 · SKILL.md
每個資料夾都是一個技能
這裡的每個資料夾都一式兩份：給人的一份——執行腳本、簡報、道具卡、海報、反思引導表；給機器的一份， SKILL.md。代理讀 frontmatter 認出哪個資料夾匹配需求，再照著指令把準備工作跑完。
技能到底是什麼
SKILL.md 是一個分兩半的 markdown 檔案。frontmatter 是資料——規範核心
（name、description、version、license、
allowed-tools）外加收進 metadata: 的匹配欄位，與
catalog.json 一致，於是「要一個溝通活動、雙人、15 分鐘、實體進行」
就是按條件篩，不是滿站搜。正文是指令——真實可跑的命令，命名遵循 Agent Skills 慣例。
一個技能的兩半
--- name: blind-portrait description: 15 分鐘兩人背對背畫圖練習，讓單向溝通的失真被看見——含撲克規格道具卡、 8 問反思引導，以及配對級前後測評。 version: 1.1.0 license: CC-BY-4.0 allowed-tools: Read, Write, Bash(curl:*), Bash(unzip:*), Bash(npm:*) metadata: # 匹配欄位——與 catalog.json 相同 category: communication group_size: 2 duration_minutes: 15 setting: offline depth: assessment-type updated: 2026-10-07 --- # 盲畫肖像 ## 把這個活動交給 AI 代理執行 # 可執行的準備——命令照抄就能跑
代理工作流，從頭到尾
1 —— 發現
skills.json 一個檔案列出全部技能：描述、包網址、sha256—— 代理動手前先篩的那張短清單。catalog.json 再補全資料夾資料： 類目、人數、時長、場景、深度、檔案大小、歸檔狀態。匿名，不用金鑰。
2 —— 安裝
一個資料夾一個 zip。curl 下載，unzip 解壓——得到的就是以技能命名的目錄：
SKILL.md、全部引用檔案、manifest，正是 skills 載入器要的形狀。
安裝工具就是 curl 本身：沒有 SDK，也沒有圍牆。
3 —— 執行準備
技能裡的指令把準備全包了：取回撲克道具卡、搭好線上前後測、備齊反思引導問題。 每份檔案都自帶無頭環境的登入降級分支，CI 裡跑的代理不會卡在登入介面。 代理跑命令；你走進教室時一切就緒。
三步，就是三條命令
# 1 —— 發現（匿名） $ curl https://workshopskill.com/zh-hant/skills.json # 2 —— 安裝（匿名）：一條命令，裝出載入器認的目錄 $ curl -LO https://workshopskill.com/zh-hant/activities/blind-portrait/files/blind-portrait.zip $ unzip blind-portrait.zip $ mv blind-portrait ~/.claude/skills/ # Claude Code 例；完整對照表見下 # 3 —— 執行準備（線上前後測需 FormLM 免費帳號） $ npm install -g @formlm/cli $ formlm-cli auth login # 無頭環境？保留 curl 步驟，這一行讓人來登 $ formlm-cli smart generate --input "盲畫肖像雙人練習前後測：6 道李克特題，涵蓋指令清晰度、核對假設、換位理解、修復溝通——活動前後答同一批 6 題，自動計算每個人的變化"
技能放到哪：各代理速查
| 代理 | skills 目錄（個人級） | 專案級 |
|---|---|---|
| Claude Code | ~/.claude/skills/blind-portrait/ | .claude/skills/blind-portrait/ |
| OpenAI Codex | ~/.codex/skills/blind-portrait/ | ./.codex/skills/blind-portrait/ |
| Qoder | ~/.qoder/skills/blind-portrait/ | .qoder/skills/blind-portrait/ |
| Gemini CLI | 貼上 SKILL.md，或用 GEMINI.md 匯入 | — |
| Cursor | 無 skills 載入器——把 SKILL.md 轉成 .cursor/rules/ 規則 | — |
| ChatGPT / Claude.ai | 無 shell——把 zip 傳進對話，或只讀知識部分做方案 | — |
| 其他任意代理 | 能讀檔案、能跑 shell 的：貼檔案、照做，即可 | — |
每份 SKILL.md 結尾都寫好了你自己代理的那兩個路徑；頁面底部的教程逐個代理帶全流程—— 安裝、首跑、排障。
從資料夾到現代工作坊
資料夾是內容，技能是它的搬運方式。引導師的代理一旦能讀懂這個抽屜，下面這些就變了：
-
準備工作會滾雪球。需求——「12 人、90 分鐘、沒投影」——放到 catalog.json 面前就是道算術題：
六對人、每對一套道具，暖場 + 活動 + 反思引導剛好塞滿這九十分鐘。採購清單來自
props欄位，不用憑記憶。 - 材料能重新生成。 guide.md 與 debrief.md 是純 markdown：代理能按人數縮放、翻譯， 或改寫成引導師講義。紙面永遠和頁面一致。
-
測量是自帶的。測評型資料夾帶
assessment.json——就是柯氏二級評估 「到底有沒有人真的學到東西」用的那套預設。第 3 步把預設變成能跑的線上前後測； 每位參與者的變化量自動算好，配對層面的全貌，就是桌上那沓評審卡加反思引導。 笑臉表成了可選項，不再是標配。
誠實的邊界
- 這些是開放格式的技能——SKILL.md、frontmatter 加可執行指令，走純 HTTPS。 任何能讀檔案、能跑 shell 的代理都能用：不鎖定，也不需要專用執行時。
- 離線算前後測的變化量不需要帳號——演算法就自帶在每份測評型資料夾裡。需要 FormLM 免費帳號的只有第 3 步那張可選的線上表單，表單與報告都存在你自己的工作空間，不在我們這兒。第 1、2 步匿名。
- 人類列印，代理解析：PDF 是印給人看的；markdown 和 JSON 是留給機器讀的—— 同一份資料夾，同一份事實。
目前已收錄的技能
四十六個技能已全部歸檔，一個資料夾一個技能，之後隨新資料夾陸續補齊。目錄是唯一的事實來源——不在 catalog.json 裡的都還沒歸檔。
已收錄技能（46）
blind-portrait — communication · 2 人 · 15 分鐘 · 測評型 paper-tower — communication · 8–20 人（3–5 人一隊） · 30 分鐘 · 測評型 two-truths — icebreakers · 8–20 人 · 15 分鐘 · 測評型 blanket-drop — icebreakers · 8–20 人（兩隊） · 10 分鐘 · 測評型 common-ground — icebreakers · 8–20 人（3–5 人一組） · 15 分鐘 · 測評型 minefield — trust · 8–20 人（兩人一組） · 20 分鐘 · 測評型 silent-lineup — leadership · 8–20 人 · 10 分鐘 · 測評型 the-orange — conflict · 兩隊各 2–4 人 · 20 分鐘 · 測評型 worst-idea-first — creativity · 8–20 人（3–4 人一組） · 20 分鐘 · 測評型 start-stop-continue — reviews · 一個 4–8 人團隊 · 30 分鐘 · 測評型 post-training-survey — feedback-forms · 任意人數 · 填寫 5 分鐘 · 測評型 workshop-feedback-form — feedback-forms · 任意人數 · 填寫 90 秒 · 測評型 training-evaluation-form — feedback-forms · 任意人數 · 當場 7 分鐘 + 第 30 天 3 分鐘 · 測評型 advantage-compass — self-assessment · 單人 · 25 分鐘 · 測評型 smile-sheet-alternative — feedback-forms · 不限人數 · 10 分鐘 · 工具包 training-needs-survey — feedback-forms · 不限人數 · 15 分鐘 · 工具包 exit-ticket — feedback-forms · 不限人數 · 3 分鐘 · 工具包 the-listening-ladder — communication · 2 人（每對） · 15 分鐘 · 測評型 relay-brief — communication · 8–20 人（每列 4–6 人） · 20 分鐘 · 測評型 draw-what-i-mean — communication · 2 人（背對背） · 12 分鐘 · 工具包 one-minute-meetup — icebreakers · 6–20 人 · 15 分鐘 · 工具包 paper-plane-intros — icebreakers · 8–20 人 · 15 分鐘 · 工具包 same-boat — conflict · 6–16 人（兩方） · 20 分鐘 · 工具包 yes-and-ramp — creativity · 4–12 人 · 15 分鐘 · 工具包 four-lens-sweep — creativity · 4–10 人 · 20 分鐘 · 工具包 assumption-audit — creativity · 3–8 人 · 20 分鐘 · 工具包 storyboard-the-journey — creativity · 4–12 人 · 25 分鐘 · 工具包 escalation-map — conflict · 4–12 人 · 25 分鐘 · 工具包 the-delegation-map — leadership · 4–10 人 · 25 分鐘 · 工具包 the-reliability-ledger — trust · 4–10 人 · 25 分鐘 · 工具包 the-premortem — reviews · 4–12 人 · 25 分鐘 · 工具包 the-values-sort — self-assessment · 1–8 人 · 20 分鐘 · 工具包 the-trust-timeline — trust · 4–10 人 · 25 分鐘 · 工具包 the-not-anymore-list — reviews · 4–12 人 · 25 分鐘 · 工具包 the-leader-checkup — leadership · 3–10 人 · 25 分鐘 · 工具包 the-energy-audit — self-assessment · 1–2 人 · 15 分鐘 · 工具包 the-third-story — conflict · 4–10 人 · 25 分鐘 · 工具包 the-decision-rights-map — leadership · 4–10 人 · 25 分鐘 · 工具包 the-turning-point — reviews · 4–12 人 · 25 分鐘 · 工具包 the-feedback-digest — self-assessment · 1–2 人 · 20 分鐘 · 工具包 the-safety-check — trust · 4–12 人 · 20 分鐘 · 工具包 roleswap-argument — conflict · 6–16 人 · 20 分鐘 · 工具包 rotate-the-lead — leadership · 8–16 人 · 25 分鐘 · 工具包 mad-sad-glad — reviews · 6–20 人 · 20 分鐘 · 工具包 skill-radar — self-assessment · 6–16 人 · 20 分鐘 · 工具包 step-in-if — trust · 8–20 人 · 15 分鐘 · 工具包
開啟資料夾：盲畫肖像 · 紙塔 · 兩真一假 · 毯子落名 · 共同點 · 地雷陣 · 無聲排隊 · 一個橘子 · 最糟主意 · 開始·停止·繼續 · 課後回饋問卷 · 工作坊回饋表 · 培訓評估表 · 優勢羅盤。
技能教程：情境走完整條鏈路
十二篇繁體中文情境教程，每篇獨立可讀、指令可抄；總目錄見 skill-guides。 逐代理教程（英文）見 skill-guides (English)。
- Claude Code——裝進 ~/.claude/skills 自動命中，含首跑與排查。
- OpenAI Codex——~/.codex/skills 加 AGENTS.md 帶路，終端代理照打執行。
- ChatGPT——無終端用法：上傳資料夾做方案、Projects 固化工作流、與執行方接力。
- Gemini CLI——GEMINI.md 的 @ 匯入掛上技能，shell 照打執行。
- Cursor——一分鐘把包轉成 .cursor/rules 依描述觸發的規則。
- Windsurf——Cascade 的規則 + 啟動模式，最接近原生載入器。
- Cline & Roo Code——.clinerules 常駐短規則 + 真實終端，產出全進 repo。
- Qoder——原生技能目錄：~/.qoder/skills 放下即載入。
- Trae——一條專案規則帶出整個 skills/ 抽屜。
- Zed——AGENTS.md 帶路；要完整載入器可 ACP 掛 Claude Code。
- Amp——執行緒不記事：盤上一個目錄 + 一條常駐指令。
- opencode——開源終端代理讀同一套約定，零訂製。
- GitHub Copilot——指令檔當載入器，Copilot CLI 照打跑。
- npx skills 註冊表——一行流、自建註冊表、以及 curl 什麼時候更好。
- 無載入器代理——通用貼上即跑法：貼檔案、留約束、指令變清單。
- 自建代理——開發者向：skills.json 欄位、sha 校驗、function-calling 迴圈。
- 個人評估——優勢羅盤技能，代理陪你施測，解讀依據 AssessWiki。
- 理論學習——每個概念對一個可執行資料夾，出處鏈到 AssessWiki 叢聚。
- 改作上架——CC BY 機制：換內容、留形狀，打包成自己的技能上架販售。
- QR Code 與投影——資料夾 + QRCARD-AI：回饋上牆，每張活碼都有紙本孿生。
- 評估報告——測評預設.json 經 FormLM 變成逐人變化量報告。
- 30 分鐘備課——discover → install → run 全程附計時。
- 遠距與混合——setting 欄位替你預判：能搬、要換、別試。
- 回顧到 30 天報告——開始·停止·繼續接上量測三節拍。
用代理的人，常問這幾個
什麼是工作坊技能？
每個活動資料夾裡那份 SKILL.md：一半是供匹配的 frontmatter（類目、人數、時長、場景、道具）， 一半是給代理跑準備的指令。和資料夾裡其他檔案一樣，CC BY 4.0 免費開放。
哪些 AI 代理能用這些技能？
只要能讀 markdown、能跑 shell 命令的代理都行——程式設計代理、終端助手，或你自己寫的腳本。 檔案就是 HTTPS 上的純文字：讀取和安裝不用 SDK、不用鑑權。
怎麼把技能裝進我的代理？
一條命令：curl 下載資料夾的 zip 包，unzip 解壓。得到的是以技能命名的目錄——
SKILL.md、它引用的全部檔案、manifest。把這個目錄放進代理的 skills 目錄：
Claude Code 放 ~/.claude/skills/，OpenAI Codex 放 ~/.codex/skills/，
Qoder 放 ~/.qoder/skills/。頁面底部的教程逐個代理帶全流程。
什麼東西需要帳號？
瀏覽、下載、列印、跑活動、算前後測的變化量都不用帳號——每個測評型資料夾都自帶一份標準函式庫演算法，離線就能算出每位參與者的變化量。需要 FormLM 免費帳號的只有線上表單那一步（代理工作流的第 3 步，或活動頁的「變成線上版」段落）；表單和資料都留在你自己的工作空間。
資料夾教人怎麼跑活動，技能教代理怎麼準備。 兩邊讀的是同一份 catalog.json——代理查到的，就是你頁面上看到的。