Communitygithub.com

yezhwi/framework-distillation

將開源框架轉化為人類和AI可用的架構手冊。

framework-distillation 是什麼?

此技能專注於反向工程與提煉開源框架的架構精髓,而非單純閱讀程式碼或文件。它幫助開發者與AI助理深入理解框架的形狀(shape)、執行模型(runtime model)、擴充點(extension points)以及工程權衡(engineering tradeoffs)。支援 `mini`(快速摘要)、`standard`(完整架構萃取)及 `deep`(詳盡反向工程)三種深度模式,並可指定分析目標與實作語言。核心原則是「架構優於程式碼、設計優於API、權衡優於功能」,產出可跨語言、跨領域複製的架構知識包,避免淪為教學、API清單或逐行程式碼導讀。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add yezhwi/framework-distillation

在你喜歡的 AI 中提問

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

說明文件

框架蒸餾

概覽

萃取架構,而非程式碼。

使用此技能來反向工程框架的形狀、執行模型、擴充點和工程權衡,以便另一個AI或團隊可以在另一種語言或領域中複製類似的架構。

使用時機

  • 反向工程超越README和公開API的框架架構
  • 研究執行時期、生命週期、狀態機或擴充機制
  • 在另一種語言或領域中複製類似的框架
  • 建立AI可讀的架構知識套件
  • 依據架構和權衡比較框架

典型目標:代理執行時期、工作流程引擎、狀態機框架、插件系統、編排平台。

不應使用時機

  • 僅限README摘要
  • API教程或使用指南
  • 逐行程式碼導覽
  • 複製貼上重新實作
  • 缺乏權衡分析的功能清單

若請求接近但偏離目標,請先重新調整範圍。

必要輸入

最低要求:

  • 儲存庫URL或本地原始碼路徑

建議提供:

  • 框架名稱
  • 分析目標
  • 目標實作語言或領域
  • 深度:mini、standard 或 deep
  • 重點領域

核心原則

架構 > 程式碼
理由 > 語法
設計 > API
權衡 > 功能
原則 > 實作

工作流程

  1. 檢查適用性;拒絕或重新導向教程/API/逐檔案請求。
  2. 根據目標選擇深度。預設為 standard;使用 mini 進行快速初版分析,使用 deep 進行詳盡的反向工程以利複製。
  3. 在深入閱讀原始碼之前,先掃描文件、測試、範例和儲存庫結構。
  4. 萃取架構、執行時期、狀態、資料模型、擴充點、決策和權衡。
  5. 蒸餾出可重複使用的規則,並根據所選模式和複製目標產生輸出。

執行規則

  • 以架構為先,而非功能清單。
  • 不要偏離為教程、API清單或逐檔案導覽。
  • 將主張建立在來自程式碼、文件、測試、範例或提交歷史的證據上(如有)。
  • 區分觀察到的事實與推論;當證據不足時,使用 觀察到、強烈推論、暫定推論。
  • 明確陳述不完整的儲存庫存取權限或薄弱的證據。
  • 根據目標語言、領域、重點領域和比較標準來客製化分析。

輸出模式

  • mini — 快速初版架構摘要
  • standard — 大部分研究的完整架構萃取
  • deep — 用於框架複製的詳盡反向工程

詳細內容請見:

  • references/output-modes.md
  • references/analysis-checklist.md
  • references/deliverables.md

反模式

避免:

  • 僅摘要README
  • 列舉API而缺乏架構
  • 解釋範例而未萃取設計
  • 描述程式碼而未探討其存在原因
  • 忽略權衡、失敗路徑或擴充點
  • 複製實作而非蒸餾原則
  • 當證據薄弱時將哲學或理由宣告為事實
  • 僅使用功能清單比較框架

支援參考資料

  • references/output-modes.md — 輸出形狀、模板、圖表
  • references/analysis-checklist.md — 分析檢查清單與品質關卡
  • references/deliverables.md — 交付物結構與AI模擬提示
  • references/self-test.md — 漏洞審查與已套用的修正
  • references/simulated-dialogue-tests.md — 壓力測試提示與評分卡

相關技能