pi-goal-x

为 Pi 带来 /goal 与 /sisyphus 目标循环:持久化拆解子任务、跨会话断点续跑,并可选独立完成审计员验收。

安装命令
pi install npm:pi-goal-x
临时试用 / 替代安装命令
pi -e npm:pi-goal-x
挂接事件钩子与注册入口
session_start / session_compactbefore_agent_start / context(注入目标上下文与压缩后恢复增量)turn_end / agent_end(检测进度并决定是否继续推进)
pi.registerTool()(目标与子任务状态更新工具)pi.registerCommand("/goal" / "/goal-direct" / "/sisyphus" / "/sisyphus-direct" / "/goal-tweak" / "/goal-settings")pi.registerShortcut("ctrl+shift+a")(切换独立完成审计员)pi.appendEntry()(写入目标事件与审计记录)

1. 是什么

pi-goal-x 是 tmonk 开发的 Pi 目标驱动执行扩展。

它把“临时聊需求”升级为带账本和验收标准的目标循环,区分灵活调整计划的常规模式(/goal)和严格按步骤依次推进的顺序模式(/sisyphus)。

2. 解决什么问题

长任务执行到一半遇到中断、压缩或模型自己半途收尾时,如果没有持久化目标账本与外部核验机制,模型很容易忘记还剩哪几个验收条件没过,或者口头说“已完成”但测试根本没跑。

3. 作用原理(事件钩子与工具注册层)

将目标账本(ledger)持久化到独立存储,利用事件钩子在压缩后回注进度并触发自动续跑与独立审计代理验收。

  • 运行 /goal <描述> 后,Agent 会先针对关键模糊点发问并提出目标、任务树与完成要求(Completion Requirements),确认后启动自动推进;若不想讨论规划可直接用 /goal-direct 或 /sisyphus-direct 立即开跑。
  • 所有目标、子任务与执行证据写入目标账本(goal-ledger)并支持跨会话暂停、恢复、修改(/goal-tweak)或切换;当发生上下文压缩时,扩展通过 goal-compaction 在压缩后重新注入当前目标增量与未完成要求,防止失忆。
  • 若开启完成审计员(Completion Auditor),在模型申报完工后,扩展会另起一个独立的审计模型会话核查目标、任务证据、验收要求与工作区真实状态。未通过则把缺口反馈打回继续执行,通过后才把目标归档完结。

4. 怎么装与基本配置

  • 运行 pi install npm:pi-goal-x 安装。包内还附带 pi-goal-x-recover 命令行工具用于从受损会话恢复检查点。
  • 在 /goal-settings 中可配置子任务深度、完成要求以及单独指定审计员使用的模型;常用快捷键 Ctrl+Shift+A 可随时开关当前目标的独立审计。

5. 和同类怎么选

相比跨多平台的 @opengsd/gsd-core,pi-goal-x 是纯正的 Pi 原生目标引擎,在会话中断恢复、灵活 vs 顺序双模式以及独立审计验收上体验最连贯。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
@opengsd/gsd-core 偏重大型项目级规格目录(Discuss/Plan/Execute/Verify/Ship)与跨运行时兼容;pi-goal-x 以会话内目标账本和 Sisyphus 连续推进为主。 直接在 Pi 里丢一个具体大目标让它持续跑完并自动审验收,优先选 pi-goal-x。
roach-pi(Git 分发) 同样内置 /goal 循环,但打包了 /clarify、FFF、LSP、MCP 等 8 个模块。 只需目标驱动不想引入额外 FFF/LSP 捆绑包选 pi-goal-x。

同方向对比包与顺序阅读

@dietrichgebert/ponytail

约束编码 Agent 少写冗余代码的资深工作流扩展:压缩代码体积、控制 token 消耗并守住高风险逻辑测试率。

阅读该包机制详评

@opengsd/gsd-core

规格驱动(Spec-driven)与上下文工程框架,用五步阶段循环和干净上下文并行执行器对抗长对话退化。

阅读该包机制详评

08 工作流与目标驱动

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「pi-goal-x」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)