Communitygithub.com

Kevin-Liu-01/cotcodec

研究計畫及可執行的評估框架,旨在讓代理編排的選擇變得明確、可衡量且可優化。

cotcodec 是什麼?

CoTCodec 是一個研究計畫與可執行的評估框架,專注於讓代理(Agent)的編排選擇變得明確、可衡量且可優化。此技能(Skill)定義了完整的操作程序,涵蓋從研究方向、實驗執行、證據管理到文件發布的各個環節。它支援在任何遵循此 Markdown 規範的 AI 代理平台(如 Claude Code、Cursor、Codex)上使用,透過 `memory.json` 的優先級帳本與 `wiki/log.md` 的操作時間線來維持專案狀態同步。使用者必須遵循預先註冊假說、保留負面證據、綁定來源版本與執行雜湊等嚴格規範,以確保研究結果的可重現性與科學嚴謹性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add Kevin-Liu-01/cotcodec

在你喜歡的 AI 中提問

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

說明文件

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。

相關技能