Flightwake – AI編程代理的飛行記錄器，而非導航儀

Flightwake 是一個超輕量級的工作記錄框架，專為強大的 AI 編程代理（如 Claude Code、Codex 和 Gemini）設計。它的核心理念是：記錄跟隨工作，而非引領工作。與需要逐步導航的工具不同，Flightwake 就像行車記錄儀加警示燈和路標——強模型自己駕駛，框架只負責記錄和紀律約束。

安裝只需在項目根目錄運行 npx flightwake init，它會創建 .flightwake/ 目錄（包含模板和鈎子），複製四個技能到 .claude/skills/，並修改代理指令文件（如 CLAUDE.md）。整個過程零運行時依賴，純 Markdown 格式，所有數據都存在於 git 中。

使用方式很簡單：每個會話開始前輸入 /fw-coldstart，模型會自動讀取最新狀態記錄；進行重要決策時手動記錄到 DECISIONS.md（一行帶原因）；遇到陷阱時使用 /fw-trap；會話結束時運行 /fw-record 生成飛行記錄並更新狀態。若會話要跨session，使用 /fw-handoff 生成上下文。忘記記錄時，Stop 鈎子會在提交落後三個提交時發出提醒。

Flightwake 解決了四個模型自身無法克服的結構性問題：會話死亡導致記憶清零；git 只記錄變更不記錄原因；長會話中紀律鬆懈；不同代理和人類之間狀態不共享。通過記錄決策、陷阱和驗證證據，Flightwake 提供了持久性和紀律保證，而非智能輔助。

該項目自身也使用了 Flightwake 進行開發，.flightwake/ 目錄中真實記錄了從開發到開源的全過程。它兼容現有的 GSD（Go, go, go, Stop）工具，可共存並遷移。V0.9 版本將提供英文默認配置，目前安裝模板和技能默認為繁體中文。

此外，Flightwake 還提供了高級安裝選項，如 --private 模式可將記錄保存在本地而不提交到 git，適合在他人倉庫中個人使用。卸載命令可以乾淨地移除框架文件而不影響用户數據。對於大型單倉庫，建議在根目錄安裝一次，避免子目錄安裝導致記錄碎片化。從 GSD 遷移也很簡單，只需初始化後告知代理讀取舊規劃並初始化狀態即可。

Flightwake 還包含可選的 --statusline 功能，在 Claude Code 底部顯示持久的狀態條，包括健康顏色、STATE 滯後程度和上下文使用率。CI 集成也可通過鈎子腳本實現，確保其他代理和人類協作時也遵守同樣的紀律。

總之，Flightwake 是一個輕量且實用的框架，專為日益強大的 AI 編程代理設計，幫助團隊在多個會話和代理之間保持工作連續性和質量。