tolimarchuk/goalbuddy

GoalBuddy – 長期 AI 輔助編碼任務的輕量級編排層

是什麼

GoalBuddy 是一個透過 npm 分發的 CLI 工具，它在你的程式碼倉儲內建立一個微型、基於檔案的「看板」，用於在使用 OpenAI Codex 或 Anthropic Claude Code 等 LLM 驅動的編碼助手時，組織大型編碼目標。
看板儲存了章程（goal.md）、狀態檔案（state.yaml）、筆記、子目標資料夾以及一個隱藏的 .goalbuddy-board 目錄。所有內容都與你的正常原始碼並列存放，因此你可以暫停、恢復或在不同代理之間無縫交接，而不會遺失上下文。

如何運作

啟動執行 – 執行 npx goalbuddy 安裝工具並列印出 /goal-prep 命令。
目標準備 – 執行 $goal-prep（或在 Claude 內部使用 /goal-prep）會建立看板，並告訴你 LLM 梯度應執行的下一個確切命令。
分派 – goalbuddy dispatch <board> --to codex|claude-code 會渲染目前任務的提示，以無頭方式呼叫所選 LLM CLI，捕獲回傳的收據（工作證明的 YAML 檔案），並透過 git 驗證任何檔案變更是否都保持在任務宣告的 allowed_files 範圍內。
恢復 / 交接 – npx goalbuddy resume 列出所有活躍的看板，並顯示每個梯度的繼續命令，讓你可以在 Codex 和 Claude（或反之）之間切換，而無需重新建立計畫。
驗證循環 – 工作完成後，一個裁判代理會根據 Oracle（測試套件、示範、基準測試或人工確認）驗證收據。看板的 state.yaml 會被更新以記錄結果，完成「意圖 → Oracle → 表面 → 循環 → 證明」這一在 README 中描述的閉環流程。

核心概念

看板 – 倉儲本地的、持久化的目標表示。
收據（v1） – 一種純 YAML、與梯度無關的工作記錄，可自動驗證。
偵察員 / 裁判 / 工作者 – 內建的代理角色，分別負責映射倉儲、選擇安全的工作片段、執行任務。
Oracle – 任何能明確告訴你目標已真正達成的訊號（測試、示範、基準測試等）。
子目標 – 用於有界工作分支的深度為 1 的子看板，由父看板連結。

為何重要

跨工具連續性 – 由於看板只是檔案，用 Codex 啟動的目標明天可以在 Claude Code 中繼續，或在同一看板上進行多廠商執行。
安全性與可審計性 – 收據被儲存、透過 git 驗證，並由裁判後期審計，為 LLM 生成的大規模程式碼變更提供了清晰的溯源路徑。
極小的執行時開銷 – 唯一的執行時產物是 goalbuddy npm 套件；其餘所有內容都在你的倉儲中，使工具輕量且易於版本控制。

典型用例

需要逐步驗證的大規模重構。
多個 LLM 驅動任務（錯誤修復、文件更新、版本升級）必須協調的發布準備。
需要將證據（測試失敗、日誌等）作為收據捕獲的漏洞調查。
任何原本在獨立 LLM 呼叫之間會遺失上下文的多提示專案。

安裝與基本命令

# 安裝並啟動新看板
npx goalbuddy

# 準備目標（建立看板，列印下一步命令）
$goal-prep   # 或在 Claude 內使用 /goal-prep

# 使用特定梯度執行目前任務
npx goalbuddy dispatch docs/goals/my-feature --to codex

# 列出並恢復現有看板
npx goalbuddy resume

# 驗證你的 Codex 安裝
npx goalbuddy doctor --target codex --goal-ready

# 更新到最新版本
npx goalbuddy update

了解更多

完整文件位於倉儲的 docs/ 目錄下（包含收據規格和發布流程）。
實時視覺化看板可透過 http://goalbuddy.localhost:<port>/<slug>/ 開啟，即時查看任務、收據和子目標的更新。
專案官網：https://goalbuddy.dev

授權 – MIT（開源，可自由使用與修改）

tolimarchuk/goalbuddy

GoalBuddy – 長期 AI 輔助編碼任務的輕量級編排層

相關