框架蒸餾
概覽
萃取架構,而非程式碼。
使用此技能來反向工程框架的形狀、執行模型、擴充點和工程權衡,以便另一個AI或團隊可以在另一種語言或領域中複製類似的架構。
使用時機
- 反向工程超越README和公開API的框架架構
- 研究執行時期、生命週期、狀態機或擴充機制
- 在另一種語言或領域中複製類似的框架
- 建立AI可讀的架構知識套件
- 依據架構和權衡比較框架
典型目標:代理執行時期、工作流程引擎、狀態機框架、插件系統、編排平台。
不應使用時機
- 僅限README摘要
- API教程或使用指南
- 逐行程式碼導覽
- 複製貼上重新實作
- 缺乏權衡分析的功能清單
若請求接近但偏離目標,請先重新調整範圍。
必要輸入
最低要求:
- 儲存庫URL或本地原始碼路徑
建議提供:
- 框架名稱
- 分析目標
- 目標實作語言或領域
- 深度:
mini、standard或deep - 重點領域
核心原則
架構 > 程式碼
理由 > 語法
設計 > API
權衡 > 功能
原則 > 實作
工作流程
- 檢查適用性;拒絕或重新導向教程/API/逐檔案請求。
- 根據目標選擇深度。預設為
standard;使用mini進行快速初版分析,使用deep進行詳盡的反向工程以利複製。 - 在深入閱讀原始碼之前,先掃描文件、測試、範例和儲存庫結構。
- 萃取架構、執行時期、狀態、資料模型、擴充點、決策和權衡。
- 蒸餾出可重複使用的規則,並根據所選模式和複製目標產生輸出。
執行規則
- 以架構為先,而非功能清單。
- 不要偏離為教程、API清單或逐檔案導覽。
- 將主張建立在來自程式碼、文件、測試、範例或提交歷史的證據上(如有)。
- 區分觀察到的事實與推論;當證據不足時,使用
觀察到、強烈推論、暫定推論。 - 明確陳述不完整的儲存庫存取權限或薄弱的證據。
- 根據目標語言、領域、重點領域和比較標準來客製化分析。
輸出模式
mini— 快速初版架構摘要standard— 大部分研究的完整架構萃取deep— 用於框架複製的詳盡反向工程
詳細內容請見:
references/output-modes.mdreferences/analysis-checklist.mdreferences/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— 壓力測試提示與評分卡