Kungfu：面向智能體工作的執行基礎設施
代理工作的連續性。繼續使用您現有的代理 kungfu run 代理程式是黃金路徑，而不是 Codex、Claude Code、VS Code、終端或其他代理表面的必需替代品。
秒懂
- 它是什麼？
- 一份以檔案為基礎的指南，介紹 Kungfu 儲存庫、其 Fact 與 Episode 基底，以及執行、擴充與認證該執行環境的方式。
- 適合誰用？
- 適合工作內容與 kungfu README 所列範圍相符，且能維護其依賴、設定與權限的團隊；不適合把檔案未承諾的相容性、效能或安全結果當成既定事實。先在隔離環境執行「依 README 建置並執行 Kungfu」，保存版本、輸入、輸出、錯誤與清理結果，再依這個專案的實際表現決定是否納入正式流程。
- 可以商用嗎？
- 可以。Apache-2.0 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 5 天前。
- 用什麼語言寫的？
- 主要是 C++（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
面向智能體工作的兩個執行環境基底
README 將 Kungfu 介紹為面向真實世界智能體工作的執行基礎設施。其本地語義權威始於一個附加式日誌，該日誌暴露了兩個執行環境基底。Fact 記錄在明確 Cut 處被承認的內容，Episode 記錄工作發生並改變狀態所經過的有界因果經驗。Episode 被描述為旗艦時間工作物件，但不是唯一的基礎物件。儲存庫中繼資料將語言列為 C++，預設分支為 dev/v4/v4.0，專案首頁為 kungfu.tech；README 本身側重概念模型而非實作。
針對 kungfu，第 1 節應連同專案識別字 kungfu-systems-kungfu-deep-analysis 來閱讀。README 明確可核對的入口是「依 README 建置並執行 Kungfu」。執行時記錄指令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把檔案描述與本機結果對上，未被 README 說明的行為則保留為未知。
在 kungfu 的情境中，評估重點是這個入口是否產生預期的專案輸出，以及失敗時是否能指出具體原因。不要用倉庫星數替代測試，也不要把其他工具的慣例套到 kungfu-systems-kungfu-deep-analysis。
第 1 節的實作核對可再觀察 kungfu 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kungfu-systems-kungfu-deep-analysis 的行為。
kungfu 第 1 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kungfu-systems-kungfu-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。
使用三個物件進行首次操作
檔案說明，首次使用只需記住三個物件：Project、Work 和 Agent。開啟或建立一個 Project，描述一個 Work 結果，然後執行一個 Agent。更深入的權威模型在需要證據或復原時可用，但不是開始的前提。Work Control 將持續工作組織為 Initiative，將有限責任組織為 Assignment，透過 Portfolio 彙總精確的工作區觀察，並確定繼任的 Project Cut。根據 README，這些術語都不會重新定義領域無關的 Fact 與 Episode 基底。
針對 kungfu，第 2 節應連同專案識別字 kungfu-systems-kungfu-deep-analysis 來閱讀。README 明確可核對的入口是「依 README 建置並執行 Kungfu」。執行時記錄指令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把檔案描述與本機結果對上，未被 README 說明的行為則保留為未知。
第 2 節的實作核對可再觀察 kungfu 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kungfu-systems-kungfu-deep-analysis 的行為。
kungfu 第 2 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kungfu-systems-kungfu-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。
檔案的組織方式
這份 README 是通往檔案的精選路線，有意比 MAP.md 中的完整索引更短。責任目錄包括 Concepts、Guides、Architecture、Profiles、Qualification、Development、Research、Architecture Decisions、ADR Map、Evolution Map 和 Shifu。每個目錄負責一項工作：Concepts 涵蓋詞彙與原則，Qualification 涵蓋保證與限制，ADR 保存承重決策，Research 保存經測量的選項而不將其變成當前指引。當兩份檔案重疊時，由角色決定歸屬：Vocabulary 擁有公共術語定義，Event Model 擁有日誌與 Replay 機制。
針對 kungfu，第 3 節應連同專案識別字 kungfu-systems-kungfu-deep-analysis 來閱讀。README 明確可核對的入口是「依 README 建置並執行 Kungfu」。執行時記錄指令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把檔案描述與本機結果對上，未被 README 說明的行為則保留為未知。
第 3 節的實作核對可再觀察 kungfu 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kungfu-systems-kungfu-deep-analysis 的行為。
kungfu 第 3 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kungfu-systems-kungfu-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。
執行、嵌入與擴充
操作指南涵蓋 Alpha 狀態、已知問題、健康預檢、Rewind、設定、持久性、CLI 安裝、升級以及退出與版本相容性。已安裝的執行環境透過 `kungfu agent brief`、`kungfu agent capabilities --json` 和 `kungfu agent choose-mode --json` 等指令進行自我描述。在擴充方面，架構部分記錄了事件模型、針對 C++、Python、Node 與框架邊界的轉接器、kfx 拓撲、技能以及 agent-first 的 Profile 編寫。README 指出了這些領域，但沒有說明具體的整合保證。
針對 kungfu，第 4 節應連同專案識別字 kungfu-systems-kungfu-deep-analysis 來閱讀。README 明確可核對的入口是「依 README 建置並執行 Kungfu」。執行時記錄指令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把檔案描述與本機結果對上，未被 README 說明的行為則保留為未知。
第 4 節的實作核對可再觀察 kungfu 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kungfu-systems-kungfu-deep-analysis 的行為。
kungfu 第 4 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kungfu-systems-kungfu-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。
機構評估與已知限制
機構評估從一份決策檔案開始，通向單主機機構信任檔案、持久性與崩潰復原、退出與版本相容性、合約、已知限制、端對端效能認證、Episode 原子性認證以及不變量驗證。README 聲明 Kungfu v4 目前支援機構檔案的工程評估和受控影子使用，並且檔案不會把未經認證的設計目標變成生產保證。資格目錄保存了證據與不承諾事項。
針對 kungfu，第 5 節應連同專案識別字 kungfu-systems-kungfu-deep-analysis 來閱讀。README 明確可核對的入口是「依 README 建置並執行 Kungfu」。執行時記錄指令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把檔案描述與本機結果對上，未被 README 說明的行為則保留為未知。
第 5 節的實作核對可再觀察 kungfu 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kungfu-systems-kungfu-deep-analysis 的行為。
kungfu 第 5 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kungfu-systems-kungfu-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。
貢獻與檔案治理
貢獻指引涵蓋建置、風格、測試、DCO 和拉取請求，以及 Alpha 注意力營運和社群健康基線等開發流程。檔案邊界是可執行的：`./shifu docs:check` 驗證 Markdown 結構、錨點和一致性，`./shifu docs:prose` 套用產生的 Vale 政策。外部 URL 健康被刻意分離，因為遠端可用性不是提交的決定性屬性。README 還指出 docs/README.md 和 docs/MAP.md 是根目錄下僅有的 Markdown 檔案，Kungfu 未發布檔案相容性合約，因此舊的扁平路徑會被移除而非保留為重新導向。
針對 kungfu，第 6 節應連同專案識別字 kungfu-systems-kungfu-deep-analysis 來閱讀。README 明確可核對的入口是「依 README 建置並執行 Kungfu」。執行時記錄指令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把檔案描述與本機結果對上，未被 README 說明的行為則保留為未知。
第 6 節的實作核對可再觀察 kungfu 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kungfu-systems-kungfu-deep-analysis 的行為。
kungfu 第 6 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kungfu-systems-kungfu-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。
授權條款
該儲存庫使用 Apache License 2.0，授予永久、全球性、非獨占、免費、免版稅、不可撤銷的著作權授權，允許複製、準備衍生作品、公開展示、表演、再授權和分發該作品，並提供類似的專利授權，一旦提起專利訴訟即終止。授權摘錄對保證、支援或安全保證沒有任何說明，因此這些主題仍超出授權文本所確立的範圍。
針對 kungfu，第 7 節應連同專案識別字 kungfu-systems-kungfu-deep-analysis 來閱讀。README 明確可核對的入口是「依 README 建置並執行 Kungfu」。執行時記錄指令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把檔案描述與本機結果對上，未被 README 說明的行為則保留為未知。
第 7 節的實作核對可再觀察 kungfu 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kungfu-systems-kungfu-deep-analysis 的行為。
kungfu 第 7 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kungfu-systems-kungfu-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。
編輯結論
適合工作內容與 kungfu README 所列範圍相符，且能維護其依賴、設定與權限的團隊；不適合把檔案未承諾的相容性、效能或安全結果當成既定事實。先在隔離環境執行「依 README 建置並執行 Kungfu」，保存版本、輸入、輸出、錯誤與清理結果，再依這個專案的實際表現決定是否納入正式流程。
社群筆記