AI AGENT WORK RECORDER · OPEN SOURCE

工作往前走。
航跡留下來。

你的 AI agent 不需要再填一份起飛計畫。讓它直接做事；flightwake 在關鍵時刻留下狀態、決策與證據，下一個 session 才能安全接手。

開始安裝看實際工作流程

npm 已發佈 0.15.00.16.0 工作版已在 main，尚未發佈

SESSION 01 → 02 → 03

REPO / FLIGHT RECORDER↗

01 /fw-coldstart

讀取 STATE + 最近的 record

02 專心建造、測試、審查

決策與坑，當下留下線索

03 /fw-record

下一位 agent 從這裡接手 →

●STATE.mdREADY

01 / THE GAP

模型有上下文限制。專案沒有。

一個 session 的推理會結束，repo 的工作不會。真正昂貴的是下一位 agent 又要猜：做到哪裡？哪裡沒驗過？為什麼走這條路？

STATE

現在在哪

一眼看見目前狀態、健康度與下一步入口。

RECORDS

做過什麼

每次有意義的收尾，留下變更與驗證證據。

DECISIONS + TRAPS

為什麼與哪裡會跌倒

關掉其他選項的理由，以及真實踩過的坑。

記錄追隨工作，不引導工作。

少一份要維護的計畫，多一條能追溯的航跡。

02 / ONE CONTINUOUS LOOP

人只要說「開始」。其餘跟著事件發生。

01 / 冷啟動

讀狀態，安全接手

新 session 先讀 STATE 和最近一筆 record。沒有證據，不把健康度猜成綠燈。

/fw-coldstart

02 / 工作中

做事，順手留痕

做了排除其他路徑的決策，記一行 why；遇到不直覺的坑，立刻寫進 TRAPS。

DECISIONS + TRAPS

03 / 收尾

把證據交給下一位

重要工作收尾時記錄測試、風險與下一步；STATE 保持短而真實。

/fw-record

04 / 再出發

換模型也接得上

Claude Code、Codex、Gemini CLI 讀同一份 repo 航跡，不靠某個聊天視窗記得。

git + Markdown

START

CONTINUE ↗

03 / FIELD NOTES / ORCA × FLIGHTWAKE

多 agent 真的一起工作時，誰記得全貌？

這個專案自己就用 flightwake。一次工作裡，Orca 讓多個 agent 的討論與審查留在可見的分頁；flightwake 把採納的結論、測試與待驗證項目放回 repo。

CASE STUDY · FLIGHTWAKE REPOSITORY 2026.10

ORCA / 協作現場

平行派工與審查

多個 agent 分頭檢查 Fleet、安裝流程與邊界情境；主導者把結果整合並重跑關卡。

FLIGHTWAKE / 共同記憶

一位寫手，一份真相

審查 agent 不各自改 STATE；主導者把採納的結論寫入 record，下一輪從同一處接手。

真實結果 / 2026.10

工作有證據，也有未完

這輪收尾記錄了 46 節 smoke 與 465 個 mod 測試通過，也明列 Fleet 仍待真機驗證的情境。

閱讀這次真實飛行紀錄 ↗ORCA × FLIGHTWAKE

* Orca 是選配的協作工具；flightwake 不要求 Orca。Fleet 是未發佈的 0.16.0 工作版功能，部分真機情境仍待驗證。

另一個現場 / 匿名產品團隊

兩個 repo，四種角色，一條可查的工作線。

一個 repo 承載產品決策，另一個承載工程實作。Orca 讓 agent 在各自的工作分頁協作；flightwake 在兩邊都留下現況、交接與驗證邊界。

01 / 產品負責

定義與派工

產品 agent 整理目標與驗收條件，核准有限範圍的計畫，再把實作交給工程角色。

02 / 技術帶領

檢查風險

技術 agent 檢視實作邊界與方案，讓程式碼開始前的假設可以被挑戰。

03 / 工程實作

寫碼與自測

工程 agent 在產品 repo 實作、跑本機測試與型別檢查，記下尚未凍結的變更。

04 / 獨立審查

驗證後才算完成

審查與安全角色待實作凍結後獨立檢查；未通過前，狀態維持進行中。

2026.10 現場快照：實作進行中，獨立審查尚未完成；不宣稱產品已驗收或上線。

04 / WHAT YOU GET

夠輕，才能一直用。

純 Markdown，跟著 git 走

不另開資料庫。STATE、records、決策與陷阱就放在 repo 裡。

三種 coding agent

Claude Code、Codex、Gemini CLI 各有原生 skill 與收尾 hook，讀同一份工作記錄。

事件觸發的紀律

冷啟動、決策、踩坑、收尾各有對應動作；不把日常工作變成表單。

先看清楚才安裝

引導式 setup 會列出語言、agent、選配元件與寫入路徑，再請你確認。

唯讀健康檢查

doctor 檢查安裝結構；STATE 的 health 誠實標示已驗證與未驗證狀態。

按需加上協作能力

儀表、Orca 指引、團隊角色與 Claude Code mod 都是選配。

05 / START HERE

從你的 repo 開始，幾個問題就裝好。

需要 Git 與 Node.js 18 以上。setup 會詢問語言、使用的 agent、選配元件與 repo 類型，先預覽寫入路徑，再執行安裝。

閱讀完整安裝文件 ↗

01 / 引導式安裝

$ cd your-repo
$ npx flightwake setup

02 / 自動化 / 非互動

$ npx flightwake init --lang=zh-TW --agents=claude,codex,gemini

安裝後，在 repo 裡開一個 agent session，執行對應的 coldstart skill；此後讓事件驅動記錄。

已安裝？執行 npx flightwake update；新版尚未發佈前，npm 仍會取得 0.15.0。

06 / FAQ

常見問題

flightwake 會替我規劃工作嗎？

不會。它是工作記錄框架：agent 直接做事，在冷啟動、決策、踩坑與收尾時保存足以讓下一個 session 接手的資訊。

一定要用 Orca 或 Claude Code 嗎？

不用。flightwake 支援 Claude Code、Codex 與 Gemini CLI；Orca 協作和 Claude Code mod 都是選配。

資料存在哪裡？需要雲端服務嗎？

核心資料是 repo 裡的 Markdown，例如 .flightwake/STATE.md 與 records/。不需要 flightwake 雲端帳號，也沒有執行期套件依賴。

0.16.0 可以安裝了嗎？

目前 npm 已發佈版本是 0.15.0。預計納入 0.16.0 的安裝流程升級與 Fleet 功能已在 main，但尚未發版，部分 Fleet 真機情境仍待驗證。

原本的 repo 已經裝過，怎麼升級？

執行 npx flightwake update。它保留既有選項與你的 .flightwake 使用者資料；新附加元件不會自動加裝。

工作往前走。航跡留下來。