Note
本專案為 Pi Coding Agent (pi-mono) 提供通用的配置增強與外部模組管理。透過 Git Submodule 與橋接機制，為本地 AI 代理人建立明確的行為約束、記憶管理與安全防禦。
- 100% 乾淨透明：無任何封閉二進位檔案，所有配置與腳本完全公開。
- MIT 授權許可：本專案採用 MIT 授權，保障使用者之使用、修改與散布權益。
git clone --recursive https://github.com/Chiakai-Chang/CKs_PI_Code_Agent_Harness.git
cd CKs_PI_Code_Agent_Harness- Windows: 雙擊或執行
install.bat - macOS / Linux: 執行
bash install.sh
安裝時可依需求選擇以下配置模式：
minimal(極簡核心)：適合對對話 Token 敏感的輕量開發。- 📦 僅載入：
Core 核心（含hello-reflect自我演進）、Caveman（極簡對話防護）、ECC（通用工程實踐）。
- 📦 僅載入：
standard(預設標準版)：適合日常通用軟體開發。- 📦 載入項目：包含本專案整合之所有 17 個外部子模組與所有本地擴充（TDD 方法論、Wiki 知識庫、AST 圖譜導航等）。
本專案將 AI 增強功能分為三大維度，兼顧開發效率與系統安全性：
- 紀律守護 (ECC)：在 AI 執行高風險操作（語法錯誤、金鑰外洩、敏感指令）前自動攔截。
- 工程方法論 (Superpowers)：強迫 AI 遵循 TDD 測試驅動與規劃步驟，避免無效代碼重構。
- 指令攔截 (YES.md)：設定白名單與防呆 Hooks，禁止 AI 修改系統關鍵配置或變數檔（.env）。
- 任務管束 (C.A.S.E.)：利用「憲法-架構-狀態-執行」檔案協定，為 AI 劃定清晰的任務邊界。
- 任務套疊 (CASE & PWF)：解決並行開發時注意力污染的問題，將任務上下文獨立隔離。
- 海馬迴進化 (hello-reflect)：自動從對話中提煉新知識並寫入規範檔案（如
CLAUDE.md、.agents/AGENTS.md、.cursorrules等），實現規則自演進。 - Token 節約 (Caveman)：對上下文進行無損語意壓縮，大幅延長長對話的 Token 生命期。
- AST 圖譜導航 (Graphify)：利用 Tree-sitter 分析代碼 AST 拓撲，降低檢索代碼時的 API 消耗。
- 專案 Wiki (LLM Wiki)：建立雙向鏈接的原子化 Wiki，協助 AI 快速檢索長篇日誌與文件。
- 提示變異 (Darwin & Evolver)：針對失敗的對話模式進行 Prompt 自我演變與抗體生成。
本專案整合了以下開源專案與方法論的最佳實踐（圖示：✅ 完全啟用 |
| 領域 | 來源專案 / 概念 | 導入方式 | 核心功能 | Minimal | Standard |
|---|---|---|---|---|---|
| 工程紀律 | ECC | Git Submodule | 安全審查與品質門檻 | ✅ | |
| 工作流 | Planning-with-Files | Git Submodule | 任務規劃與狀態快照 | ❌ | ✅ |
| 專案知識 | LLM Wiki | Git Submodule | 知識庫沉澱與鏈接文件 | ❌ | ✅ |
| 方法論 | Superpowers | Git Submodule | TDD 方法論與微步提交 | ❌ | ✅ |
| 資源防禦 | Caveman | Git Submodule | Token 壓縮防禦 | ✅ | |
| 行為準則 | Karpathy | Git Submodule | LLM 寫入防護指引 | ❌ | ✅ |
| 提示工程 | Prompt Master | Git Submodule | 提示詞優化範本 | ❌ | ✅ |
| 安全治理 | YES.md | Git Submodule | 指令安全與攔截 Hooks | ❌ | ✅ |
| 美學/UX | Taste Engine | Git Submodule | 設計樣式與視覺引導 | ❌ | ✅ |
| 基因優化 | Evolver | Git Submodule | 失敗模式與 Prompt 演化 | ❌ | ✅ |
| 提示微調 | Darwin | Bridge (橋接) | Prompt 變異優化 | ❌ | ✅ |
| 辯證分析 | Qiushi | Bridge (橋接) | 重構前後對照分析 | ❌ | ✅ |
| 除錯實踐 | Best Practices | Bridge (橋接) | 系統化除錯引導 | ❌ | ✅ |
| 圖譜導航 | Graphify | Bridge (橋接) | AST 本地圖譜分析 | ❌ | ✅ |
| 循環工程 | Loopy | Bridge (橋接) | 工作流閉環控制 | ❌ | ✅ |
| 環境治理 | C.A.S.E. | Bridge (橋接) | C.A.S.E. 任務管束協定 | ❌ | ✅ |
| 多維推理 | MECE-Autopilot | Bridge (橋接) | 互斥窮盡多角色辯論與收斂 | ❌ | ✅ |
| 記憶進化 | claude-reflect | 本地移植 (蒸餾) | 專案規則檔案自演進 | ✅ | ✅ |
- 本地優先：所有代碼分析（如 AST 拓撲）完全於本地運行，不對外洩漏專案結構。
- 防寫保護：防禦規則禁止 AI 任意修改或刪除系統關鍵配置（如
.env與設定檔）。 - 完全透明：所有防呆 Hooks 與約束規則完全開源且透明。
- 本專案採用 MIT 授權。
- 致謝所有被整合倉庫的作者與貢獻者。詳細決策脈絡請參閱各模組目錄下的
RATIONALE.md。
由 CK (Chiakai Chang) 維護。本專案純屬實驗性質。