Communitygithub.com

KimYx0207/元技能创建器

一个可移植的 AI 代理技能,用于设计、重构和审查可复用的技能包。

元技能创建器 是什麼?

此技能旨在引导 AI 代理将可重复的工作流程系统化地打包成一个可执行、可验证、可迁移的技能包。它强调从用户的实际工作流出发,而非预设模板,并通过轻量入口 `SKILL.md` 和按需加载的参考文件实现模块化和高效。该技能支持多种工作模式,包括创建新技能、重构现有技能、评估技能质量以及制定打包计划。它通过强制实行严格的契约(例如在写代码前先证明有技能化的必要性)、分阶段的研究与设计、以及结构化的验证(包括包校验、闭环校验和领域校验)来确保技能包的质量,并最终以中文输出清晰的最终报告。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add KimYx0207/meta-skill-creator

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

元技能创建器 是做什麼的?

用這個技能把可重複工作流程做成能運行、能驗收、能遷移的技能包。產物不是「更長的提示詞」,而是一個預設入口很輕、細節按需載入、校驗方法可重現的能力包。

核心契約

  • 從用戶真實工作流程出發,不從個人偏好的模板出發。
  • 寫檔案前先證明這件事值得技能化;一次性任務不要硬做成技能包。
  • SKILL.md 只保留路由面:觸發、第一動作、漸進載入、硬停止和驗證。
  • 詳細研究、產品設計、包計畫、觸發評測、驗收方法和模板放到 references/、assets/、evals/、scripts/。
  • 需要補全模糊意圖、讓用戶多次選擇或先鎖 MVP 再批量生成的 skill,必須設計 Codex request_user_input / Claude Code AskUserQuestion 等宿主原生決策面;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.mdSkill 要產出檔案、媒體、截圖、簡報、報告、儀表板或其他可見產物。
產品化設計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.mdSkill 依賴 Image2、宿主媒體能力、MCP、本地渲染器或腳本;先記錄本地能力清單和多模態簡報。
互動式決策與 MVP 門references/interactive-mvp-product-skill.mdSkill 要在模糊意圖下彈多決策、鎖定風格/封面/首屏/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/ 只在校驗、轉換或打包時運行,不要把腳本內容黏進對話上下文。

工作流程

  1. 分類:判斷是 new-skill、refactor-skill、evaluate-skill、package-plan,還是 not-a-skill。
  2. 取得與研究:只收集會改變包決策、產物表面、工具路線或驗收標準的證據。
  3. 設計:確定結果、觸發邊界、輸入輸出、本地能力路線、互動式決策面、MVP 鎖定門、包結構和公開失敗模式。
  4. 構建:只創建或修改當前目標必須碰觸的最小檔案集。
  5. 驗證:運行包校驗、閉環校驗和領域校驗;報告結構證據、產物證據、運行證據和人為確認分別證明了什麼。
  6. 閉環:填寫運行記錄;決定 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 .

如果生成的包有自己的腳本,也要按實際產物運行。驗證時必須分清結構檢查、生成產物證據、運行/工具證據和人工驗收;一個層級的通過不能替代全部通過。

最終報告

用中文報告:改了哪些檔案、包決策、觸發邊界、漸進載入圖、校驗命令、證明層級、閉環決策和剩餘風險。給一個小的前後對照或輸出片段,讓用戶能判斷這個技能包是否真的更容易使用。

相關技能