Progress Target Workbuddy

ProgressTarget for WorkBuddy

为 AI Agent 的长期任务提供**持久化计划、可测量的质量门、任务节点提示和可查看的进度**。

每个 WorkBuddy 对话维护自己的一份计划：**先制定，经明确授权后才执行**。每个任务节点带硬指标、必需交付物和北京时间截止时间，达标才能过关；进度可在本地只读看板里实时查看。

从 [02TJS/ProgressTarget](https://github.com/02TJS/ProgressTarget) 的 Codex 版本移植而来，适配 WorkBuddy 的 Skill 体系。核心契约完全保留，零第三方依赖。

---

为什么需要它

长任务最容易出的三种问题，它都能挡住：

• 跑着跑着忘了要交付什么 → 每个节点有必需交付物，缺一个都过不了门
• "差不多完成了" → 指标必须有实测值和证据，空洞的 >0 目标会被直接拒绝
• 不知道下一步该干嘛 → next 命令在关键节点给出明确提示卡

设计上刻意做了几件事：阶段启动后冻结阈值和验收标准，不能靠改标准来达标；逾期交付会保留"未达标"的事实，不会假装成功；阶段结束率和目标达成率分开计算。

---

快速开始

安装

需要 **Node.js 22+**。

git clone https://github.com/hao1100228-ctrl/progress-target-workbuddy.git
cd progress-target-workbuddy

./install.sh                 # Git Bash / macOS / Linux
# 或
.\install.ps1                # Windows PowerShell

默认装到 `~/.workbuddy/skills/progress-target/`。也可以手动复制整个目录到 skills 目录下，效果一样。

装完验证一下：

~/.workbuddy/skills/progress-target/bin/pt.sh context

用起来

不用记命令——在 WorkBuddy 里直接说话就行：

帮我制定一个计划，暂不执行

按当前计划开始执行

看看当前进度

想手动操作也可以：

PT="$HOME/.workbuddy/skills/progress-target/bin/pt.sh"

"$PT" create --file plan.json                            # 制定（paused、全 pending）
"$PT" next                                               # 任务节点提示：现在该做什么
"$PT" manage --operation set-execution --file active.json # 用户授权后才执行
"$PT" phase --id phase-1 --file start.json                # 启动节点
"$PT" phase --id phase-1 --file done.json                 # 提交验收
"$PT" manage --operation finalize --file finalize.json    # 最终验收
"$PT" open                                                # 打开本地看板

---

任务节点提示

这是移植时新增的能力。`next` 会告诉你当前该做什么，而不是让你猜：

━━ 任务节点提示 ━━  ProgressTarget 移植验收   rev 4   推进中
进度 1/2 节点已结束 · 质量门通过 1 个 · 状态 推进中

▶ 当前节点
  ▸ 02 端到端验收  [待开始]  截止 09/07 16:00  进度 0%  交付物 0/1  质量门 未通过
  目的：确认插件在真实会话中可用
  未达标指标：端到端用例通过率 尚未测量 目标 >= 100%
  缺失交付物：验收记录

⚡ 下一步：前序阶段已合法结束且交付物齐备。立即启动下一阶段「端到端验收」，
   不要等待用户审批。
   已获执行授权，可直接启动 phase-2，不必再次征求同意。

前序节点合法完成后，它会明确告诉你"不用再问用户"，