sighworld/low-context-memory

low-context-memory 是做什麼的？

一個輕量級的 Codex 技能，透過將專案狀態持久化到結構化檔案（conductor/ + 每日日誌）來最小化上下文視窗的使用。它提供了一個等冪（idempotent）設定腳本、精簡的進度/決策模板以及檢查點工作流程，讓團隊可以在不同會話之間恢復工作，而僅需最少的聊天歷史紀錄。

設定

1. 確保您的 Codex 環境已安裝此技能。
2. 在專案根目錄執行以下命令以初始化結構：

codex run setup-low-context-memory

這將建立以下目錄結構：

conductor/
├── project-summary.md   # 高層級目標與現狀
├── decisions.md         # 關鍵技術與設計決策
├── progress.md          # 里程碑與待辦事項
└── README.md            (可選)
daily-logs/
└── YYYY-MM-DD.md       # 每日活動日誌

使用方法

每日工作流程

1. 開始會話： 要求 Codex 從 conductor/ 讀取目前狀態。
2. 工作期間： 隨意使用；技能會將資訊儲存到日誌與進度檔案中。
3. 結束會話： 執行檢查點以確保下一會話可以中斷的地方繼續。

記錄決策

若要記錄決策，請使用以下格式：

## 決定：使用 SQLite 而非 JSON 檔案

- **日期：** YYYY-MM-DD
- **理由：** 需要更好的查詢效能與關聯完整性。
- **影響：** 新增 sqlite3 作為依賴項；需要遷移工具。

檢查點工作流程

檢查點會將對話的當前理解寫入 conductor/progress.md。使用以下命令觸發檢查點：

codex run checkpoint-low-context-memory

這會提示 Codex 總結已完成事項、進行中事項以及任何阻礙因素，並寫入上述檔案。

恢復工作

當您開始新的會話時請說：

「從 conductor/ 載入專案狀態。」

Codex 將會讀取結構化檔案，並讓您立即恢復工作，而無需回顧先前的聊天內容。

最佳實踐

• 在每日工作結束時執行檢查點。
• 將 conductor/ 和 daily-logs/ 加入版本控制（.gitignore 選用）。
• 保持 project-summary.md 簡潔（少於 10 行）。
• 與其他團隊成員共享此技能，以標準化工作流程。

平台

• Codex（主要）
• 理論上可適應其他 AI 代理（例如 Cursor、Claude Code），但需要修改提示。

相依性

• bash 或 zsh（用於設定腳本）
• codex CLI

貢獻

請傳送 PR 到此儲存庫或提交問題以改進這個技能。

---

由 sighworld 維護。