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 辅助编码任务的轻量级编排层

相关