軟體代表作/Flywheel

Flywheel

AI 代理長時間開發的 Claude Code 外掛,每個工作階段只做一個功能,以交接紀錄接力。

客戶
工程方法
領域
工程方法
合作形式
獨立專案
角色
設計與開發
期間
2026
狀態
GitHub 公開,可直接安裝

起點

AI 代理一長跑,就會遺失上下文、留下半成品。

大型專案交給 AI 開發代理時,上下文視窗很快燒光,結果是半成品功能、被跳過的測試,以及工作階段之間遺失的上下文。每個新的工作階段都沒有上一班的記憶,就像每次換班都失憶的工程師;交班紀錄寫得好,下一班幾分鐘就能接手。

範圍

  • Claude Code 外掛:初始化、接力、功能清單、待辦與重設指令
  • 可插拔的規劃、多代理與審查元件
  • 9 種平台的驗證設定
  • 端到端測試組
  • 在 Hoist 上的實際運作

難題

讓代理長時間開發,又不累積半成品、不遺失上下文、不自己替自己打分。

  1. A
    跨工作階段失憶

    每個工作階段都從零開始;沒有可靠的交接,第一個小時就花在重建上下文,而且常常理解錯。

  2. B
    範圍蔓延與半成品

    代理會一路擴大範圍,直到上下文用完,留下做到一半的提交。

  3. C
    寫的人自己驗收

    寫程式的模型太會替自己打高分,驗收必須由另一個角色來做。

做法

一個工作階段只做一個功能,要嘛合併,要嘛還原。

三條核心規則:每個工作階段只做一個功能;結束時可以合併,否則還原,不留半成品;交接紀錄必須機器可讀。初始化只跑一次,建立設定、功能清單(JSON)與交接紀錄(JSONL);之後每個工作階段都跑 10 步接力。

審查分四層:作者清理、新代理同儕審查、跨模型審查、端到端測試,再到真實平台驗證。審查強度依功能的重要性調整,節省 token;每個工作階段結束時列出一張合規表,使用者確認後,功能才標記為已驗收。

實跑之後,把怎麼打造穩健的代理 skill 整理成六條公開原則:做事的代理不自我驗收、以證據取代宣稱、自主程度越高隔離越強、平行的代價是正交、外圈無狀態且只有一個寫入者、文件品質決定吞吐量。

讀最近的交接追加交接SPEC規格文件拆成功能與驗收條件CHECKLIST功能清單(JSON)唯一事實來源HANDOFF交接紀錄(JSONL)每次結束追加一筆RELAY工作階段接力一次一個功能・10 步REVIEW四層審查清理・同儕・跨模型・E2EVERIFY平台驗證9 種平台GIT合併或還原不留半成品

← 左右滑動查看完整系統圖 →

一個工作階段的接力交接回到下一班

驗證設定讀交接選功能與審查強度啟動環境冒煙測試規劃實作與測試四層審查平台驗證提交與交接

架構決策

狀態放在檔案裡,驗收交給別人。

  1. 狀態格式決策功能清單用 JSON、交接用 JSONL,不用 Markdown確保代理不會悄悄改掉結構
  2. 範圍紀律決策一個工作階段一個功能,可以合併或還原確保程式庫隨時乾淨,下一班可以直接接手
  3. 驗收分離決策跨模型審查,做事的代理不能自己標記已驗收確保另一個模型抓得到作者的盲點
  4. 審查強度決策完整、標準、輕量、草稿,或依優先序自動選擇確保低優先的功能不必付同樣的審查成本
  5. 平行化決策功能之間檔案不重疊;外圈無狀態、只有一個寫入者確保平行的代理互不干擾,可以中斷、可以續跑

專案時程

2026.03.26

Flywheel 公開於 GitHub

3 月 30 日可直接安裝;Hoist 於 5 月 24 日起以它開發

出處 +
2026 年 3 月2026 年 5 月4 月123
  1. 12026 年 3 月公開於 GitHub,可用 /plugin install 直接安裝
  2. 22026 年 4 月重構為 10 步接力,加入平台驗證與待辦清單
  3. 32026 年 5 月Hoist 以 Flywheel 開發,6 月 1 日 66 個功能全數驗收

成果

Hoist 以 Flywheel 起步,66 個功能全數經人工驗收。

66個功能

Hoist 早期以 Flywheel 完成,全數經人工驗收

10 份功能清單、196 條測試情境;到 2026 年 6 月 1 日共 367 次提交

10步

每個工作階段的接力流程

讀交接、選功能、實作、四層審查、平台驗證、提交與交接

  • 外掛公開於 GitHub,可以直接安裝。
  • 實跑的教訓整理成六條公開原則。
  • Hoist 後來於 2026 年 10 月 1 日交付,正式環境服務中。

技術

Claude Code 外掛,狀態都放在檔案裡。

外掛
Claude Code 外掛:指令與 skills(Markdown)
狀態
功能清單 JSON・交接紀錄 JSONL
隔離
git worktree
審查
同儕代理・跨模型審查・端到端測試
測試
Shell 端到端測試組(以模擬專案執行)
工程備註

外掛 v1.11.0,31 次提交端到端測試組 15 個測試、約 57 項斷言Hoist 的 Flywheel 階段:1 次 34 個功能的大波次加 9 個增量波次,共 66 個功能到 2026-06-01 共 367 次提交、196 條 Given/When/Then 情境

更多案例