cotcodec — 在此工作
目的
CoTCodec 是一個研究計畫與可執行的評估框架,用以讓代理編排的選擇變得明確、可衡量且可優化。論文 1 研究語言;共享的框架與證據帳本則涵蓋更廣泛的編排變數計畫。
心理模型與關鍵檔案
memory.json是已編譯的專案狀態與活躍優先級帳本。wiki/log.md是僅供追加的操作時間線。directions/管理研究假說;experiments/管理預先註冊的執行。harness/執行條件與基準測試;scripts/驗證並封存。research/evidence/包含可攜帶的決策套件。原始的/本地的輸出屬於被忽略的data/,絕不會意外進入 Git。README.md是人類的進入點;AGENTS.md是完整的操作參考;目錄SKILL.md檔案擁有各自的本地程序。
需遵循的模式 / 不變量
- 在進行實質工作前,請先閱讀
wiki/SOUL.md、wiki/USER.md、wiki/HEARTBEAT.md以及memory.json。 - 在觀察處理結果之前,先預先註冊偽證者、預算、聲明邊界與停止條件。絕對不要重寫一個已完成的實驗合約。
- 保留負面與結果前的證據。建立版本化的重新執行,而不是覆寫失敗的輸出目錄。
- 將確定性基礎設施的准入與即時模型或科學主張分開。CPU 的符合性絕不代表 H100 的准入或記憶體品質。
- 對於任何用於研究決策的結果,綁定來源修訂版、樹狀結構、授權、依賴項、映像/模型識別碼以及執行雜湊。
- 保持
memory.json的編譯真相與wiki/log.md時間線同步。
常見任務 → 第一步行動
| 任務 | 第一步行動 |
|---|---|
| 繼續研究 | 讀取 memory.json 的優先級以及最新的 wiki/log.md 條目。 |
| 執行實驗 | 讀取 skills/run-experiment.md,然後是其 YAML 合約。 |
| 新增基準測試 | 讀取 harness/benchmarks/SKILL.md 與基礎適配器。 |
| 更改編排邏輯 | 讀取最近的 harness/**/SKILL.md 與配對的測試。 |
| 新增記憶體系統 | 讀取 infra/memory-baselines/SKILL.md 以及組合/來源驗證器。 |
| 交付證據 | 執行路由該工件所需的來源、實驗、證據與組合驗證器。 |
| 更新文件 | 更新 Agent-Docs、README/current-state 頁面、memory.json 以及 wiki/log.md。 |
注意事項
- 許多基準測試適配器故意是存根;存在並不表示準備就緒。
data/可能包含數 GB 的模型、資料庫、原始碼樹以及 Docker 工件。在暫存前檢查被忽略/未追蹤的檔案。- 精確來源的生命週期作業通常會在 GPU 主機上使用 CPU 分配。主機名稱包含
h100並不證明已請求或使用了 GPU。 - 歷史路徑
~/Documents/GitHub/kevin-wiki可能在本地不存在;必要時設定KEVIN_WIKI_ROOT給scripts/run-agent-docs.ts。