技能教程 · 代理
工作坊技能裝進 Claude Code
Claude Code 會把 skills 目錄裡的每個資料夾依 description 自動載入——WorkshopSkill 的包正是這個形狀:一條 curl、一次解壓、一次 mv,發現→安裝→執行的整條迴路兩分鐘跑完。
技能能為 Claude 做什麼
裝上 blind-portrait 之後,Claude Code 看得到它的名字與描述;一句「幫我備一場 15 分鐘的雙人溝通練習」就會命中這個技能,技能裡照打即可跑的指令負責取道具卡、取反思引導、取執行腳本——有 FormLM 帳號的話,把線前後測一併搭好。
安裝——個人層或專案層
個人層放 ~/.claude/skills/,所有專案可用;專案層放 .claude/skills/,跟著 repo 走——培訓團隊 commit 一次,全組的 Claude Code 都帶著這個抽屜。
一個技能進 Claude Code
mkdir -p ~/.claude/skills cd "$(mktemp -d)" curl -LO https://workshopskill.com/zh-hant/activities/blind-portrait/files/blind-portrait.zip unzip blind-portrait.zip # 解壓得到 blind-portrait/:SKILL.md + 全部檔案 + manifest mv blind-portrait ~/.claude/skills/ # 專案層:最後一步換成 mv blind-portrait ./.claude/skills/
首跑
一句需求,一套備料
> 給 12 人備盲畫肖像,實體進行,90 分鐘場 Claude 載入技能後: 取回撲克規格道具卡組、答卷、反思引導、執行腳本(curl 步驟) 算好:12 人 = 6 對,每對一套卡,2+15+2 = 19 分鐘 問你要不要建線上前後測(formlm-cli) 交回採購清單與列印順序
卡住了?
- 沒命中技能?description 裡的觸發詞就是類目、人數、時間——把約束說全,或直接點名:
用 blind-portrait 技能
。 - 副本過期?每個技能有 metadata.updated 與帶逐檔校驗和的 manifest.json;catalog 的 updated 日期換了就重新 curl。
- formlm-cli 卡在登入?技能裡有無互動環境的降級動線:照跑 curl 步驟,把測評預設留給人處理登入。
接著讀
常見問題
裝完要重啟 Claude Code 嗎?
不用。技能以工作階段為單位重新掃描,放進目錄後開個新對話(或清一次上下文)即生效。
代理能全程無人值守跑完嗎?
curl 步驟可匿名跑完;只有 FormLM 線上測量那一步需要人登入一次,技能會在那條指令前停下來告訴你。
能用能用於收費工作坊嗎?
能——CC BY 4.0:照跑、照改、換廠牌,保留出處標示就行。