元技能创建器 是做什麼的?
用這個技能把可重複工作流程做成能運行、能驗收、能遷移的技能包。產物不是「更長的提示詞」,而是一個預設入口很輕、細節按需載入、校驗方法可重現的能力包。
核心契約
- 從用戶真實工作流程出發,不從個人偏好的模板出發。
- 寫檔案前先證明這件事值得技能化;一次性任務不要硬做成技能包。
SKILL.md只保留路由面:觸發、第一動作、漸進載入、硬停止和驗證。- 詳細研究、產品設計、包計畫、觸發評測、驗收方法和模板放到
references/、assets/、evals/、scripts/。 - 需要補全模糊意圖、讓用戶多次選擇或先鎖 MVP 再批量生成的 skill,必須設計 Codex
request_user_input/ Claude CodeAskUserQuestion等宿主原生決策面;Markdown 選擇卡只能是降級等待介面,不能冒充真實確認。 - 圖片、影片、簡報、文件、報表、儀表板或其他渲染產物,優先檢查 Image2 / 宿主原生能力;MCP、腳本、SVG、靜態預覽是降級或輔助路線,必須有降級證據。
- 外部材料只能抽象成品質原則;不要複製別人的命名、頁面結構、視覺系統、提示詞、示例或商業話術。
- 每次交付都要閉環:記錄運行證據、評審發現、
writeback/proposal/none-with-reason/blocked決策,並把可複用學習寫回對應 reference、template、validator、eval 或 example。
漸進載入
只讀當前階段需要的檔案:
| 當前階段 | 讀取 | 何時使用 |
|---|---|---|
| 意圖與領域研究 | references/intent-domain-research.md、assets/domain-research-brief-template.md | 用戶輸入模糊、領域陌生、像戰略判斷,或可能只是一次性提示詞;先寫領域研究簡報,證據不足標 research-needed。 |
| 表面與產物鏈 | references/experience-surface-model.md | Skill 要產出檔案、媒體、截圖、簡報、報告、儀表板或其他可見產物。 |
| 產品化設計 | references/product-design.md | 需要決定包內檔案、3 分鐘可見結果、用戶旅程或首次公開表面。 |
| 運行契約 | references/skill-contract.md | 寫入或改動候選技能包前使用。 |
| 來源抽象邊界 | references/source-abstraction-boundary.md | 使用外部案例、內部範例或競品材料時,先抽象再重寫。 |
| 包計畫 | assets/package-plan-template.md | 編輯前映射 SKILL.md、參考檔案、資產、腳本、評測和示例。 |
| 多模態/工具路線 | references/multimodal-tooling.md、assets/multimodal-prompt-brief-template.md | Skill 依賴 Image2、宿主媒體能力、MCP、本地渲染器或腳本;先記錄本地能力清單和多模態簡報。 |
| 互動式決策與 MVP 門 | references/interactive-mvp-product-skill.md | Skill 要在模糊意圖下彈多決策、鎖定風格/封面/首屏/MVP 後批量生產,或要跨 Codex、Claude Code 宿主複用確認流程。 |
| 評測設計 | references/evaluation-method.md、evals/trigger-eval.json | 設計觸發評測、輸出評測、基線對比、迴歸或驗收檢查。 |
| 發布門禁 | references/release-gate.md、assets/acceptance-run-template.md | 聲稱可以分發、遷移或交付給別人使用前。 |
| 閉環治理 | references/closed-loop-governance.md、assets/loop-run-record-template.md | 驗收、失敗、復盤、漂移、發布準備或用戶要求「閉環」時;必須寫明運行記錄和寫回決策。 |
assets/ 裡的 .md 是給人填寫的工作模板,.json 是給腳本或校驗讀取的結構資料;只有創建對應產物時才讀取。scripts/ 只在校驗、轉換或打包時運行,不要把腳本內容黏進對話上下文。
工作流程
- 分類:判斷是
new-skill、refactor-skill、evaluate-skill、package-plan,還是not-a-skill。 - 取得與研究:只收集會改變包決策、產物表面、工具路線或驗收標準的證據。
- 設計:確定結果、觸發邊界、輸入輸出、本地能力路線、互動式決策面、MVP 鎖定門、包結構和公開失敗模式。
- 構建:只創建或修改當前目標必須碰觸的最小檔案集。
- 驗證:運行包校驗、閉環校驗和領域校驗;報告結構證據、產物證據、運行證據和人為確認分別證明了什麼。
- 閉環:填寫運行記錄;決定
writeback、proposal、none-with-reason或blocked;只有可複用學習才寫回規則,不能把聊天總結冒充閉環。
包結構
預設檔案:
SKILL.md:輕入口,負責觸發和執行契約。references/:領域規則、產品模型、能力路線、來源抽象、評測方法、發布門禁。assets/:可填寫模板、工作表、結構資料或提示詞簡報。scripts/:確定性校驗、轉換、渲染或包檢查。evals/:觸發評測和迴歸用例。examples/:小而真實的輸入/輸出示例,不寫私有歷史、內部評分或假運行證據。
只有當新檔案能防止具體失敗,或能讓 Skill 更容易跑通時才添加。不要為了保存研究筆記而新增參考檔案。
硬停止
遇到以下情況先停止並說明阻塞:
- 任務只是一次性提示詞,不是可重複工作流程。
- 領域表面靠猜,沒有用戶材料、本地證據或當前來源證據支撐。
- 多模態 Skill 沒有本地能力清單和輸出證據路線。
- 需要用戶多輪決策或 MVP 確認,卻沒有原生選擇工具、降級等待介面、確認狀態欄位和批量生成停止規則。
- 包依賴生成檔案,但沒有辦法證明檔案、截圖、媒體或渲染結果存在。
- 觸發範圍和另一個活躍技能包重疊,卻沒有路由邊界。
- 設計會暴露私有評測歷史、內部復盤、實現傷痕,或讓人看出模仿某個外部專案。
驗證
在包根目錄運行:
python scripts/check_meta_skill_package.py .
python scripts/check_closed_loop.py .
如果生成的包有自己的腳本,也要按實際產物運行。驗證時必須分清結構檢查、生成產物證據、運行/工具證據和人工驗收;一個層級的通過不能替代全部通過。
最終報告
用中文報告:改了哪些檔案、包決策、觸發邊界、漸進載入圖、校驗命令、證明層級、閉環決策和剩餘風險。給一個小的前後對照或輸出片段,讓用戶能判斷這個技能包是否真的更容易使用。