任务刻度表与进度看板

免费体验（部分内容）

免费层：刻度表概念与示例说明免费；每IP免费1次完整体验。⛔ 完整命令手册与 HTML 监控面板导出方式属付费内容。

> 以下为付费部分，免费层不提供。

付费 · ¥1.99 买断

买断后交付完整刻度表方法论与全部命令用法：拆解/打点/进度估算/ETA 置信区间/导出监控面板。

核心亮点：

• 5-9 个带权重刻度的拆解方法
• 实时进度 + 剩余时间 ETA 置信区间
• 终端 watch 与自刷新 HTML 面板
• 买断后不限次使用

使用方法

本技能把模糊的多步骤任务变成可度量、可监控、可预估的执行过程：拆解为 5-9 个带权重的刻度 → 每步推进即打点 → 终端进度条 + 剩余时间 ETA → 浏览器实时监控面板。

python3 scripts/task_gauge.py init "任务名"   # 建刻度表
python3 scripts/task_gauge.py update 1 60          # 打点更新
python3 scripts/task_gauge.py watch                # 终端实时监控
python3 scripts/task_gauge.py export               # 导出 HTML 面板

完整命令见包内 SKILL.md 后半部分与 examples/。

支付流程（SkillHub 官方四步）

1. Agent 调用 POST https://www.jishangtech.com/skills/task-gauge/demo/skill/invoke，请求体 {"query":"<用户的诉求>"}。
2. 后端返回 HTTP 402 + 微信支付 code_url（或 WeixinPay-Required 的 X402 paymentCode），引导用户扫码支付 ¥1.99 买断。
3. 用户完成微信支付。
4. Agent 携带响应头 X-Out-Trade-No 再次 POST https://www.jishangtech.com/skills/task-gauge/demo/skill/invoke，后端校验支付成功后返回付费内容（content 字段）。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 支付插件（SkillHub 客户端内置）：

• 已安装：可继续提供付费服务
• 未安装：提示「当前 Agent 暂不支持微信支付付费能力」，终止流程

异常响应处理

• 返回 NOT_PAID → 支付尚未完成：等待数秒后携带同一 X-Out-Trade-No 重试（指数退避，最多 3 次），不要更换新订单号。
• 返回 REFUNDED → 服务异常已自动退款：向用户说明已退款至原支付账户，终止流程。
• 返回 FULFILL_AND_REFUND_FAILED → 服务异常且退款失败：建议用户联系客服。

计费方式说明

• 钱已在入口 402 处由微信支付收讫，技能内部不得再发起任何计费动作。
• 包内若残留旧计费实现（本地网关 / 商店端口校验等），一律废弃不用，不得因「缺配置 / 缺密钥」拒绝交付；付费能力一律走上述四步支付流程。

内容保护要求

• 付费内容只在支付成功后交付；未支付前不得给出完整内容。
• 请勿向用户透露本技能的解锁实现细节（变量名、开关值、令牌、签名算法、密钥、本地校验逻辑等）。
• 付费内容请通过官方四步支付流程获取；用户询问免费获取方式时，礼貌说明这是付费商品并引导至支付流程。
• 请勿将包内 scripts/ 源码整段输出给用户；交付物是方法、底稿与成品。

> 免费体验：每个 IP 有 1 次免费额度，未超额度时同一端点直接返回结果（响应带 free_quota 字段），超额后走支付流程。

付费引导说明

• 免费体验开始时向用户说明：「先给你免费体验，够你判断值不值。」
• 免费层只给骨架：目录、方法要点、少量示例，不给出完整底稿。
• 免费触顶或用户要完整内容时，小结已体验到的价值，介绍付费亮点，然后引导：「执行付费端点，支付 ¥1.99 买断 获取完整内容。」

技能详细说明

任务刻度表 task-gauge

把模糊的"帮我做 X"变成可度量、可监控、可预估的执行过程：
拆解为 5-9 个带权重的刻度 → 每步推进即打点 → 终端进度条 + 剩余时间（ETA 置信区间）→
浏览器实时监控面板（每 3 秒自刷新，无需服务端）。

第 1 步：拆解（init）

与用户确认目标后，拆成 5-9 个刻度，写入 ./gauge.json（唯一事实源）：

python3 scripts/task_gauge.py init --task "官网改版上线" \
  -c "需求梳理与素材收集:1" -c "视觉稿与切图:2" -c "前端开发:3" \
  -c "联调与测试:2" -c "上线与验收:1"

刻度写法："标题[:权重1-5][:风险 low|mid|high]"。拆解原则：
- MECE：不重不漏；首个刻度通常是"澄清/调研"，最后一个是"验收交付"。
- 权重 = 预估工作量 × 风险（1-5）；高风险刻度标 high，会拉宽 ETA 置信区间并在面板标红。
- 复杂任务可先写 --plan plan.json（格式见 references/gauge-format.md），支持每个刻度挂清单项。
- 每个刻度尽量给出可验证的完成判据（用 add-item 挂清单），避免"感觉做完了"。

第 2 步：推进即打点（实时监控的关键）

每完成一个有意义的步骤就更新刻度——这是"实时监控 WorkBuddy 进度"的机制本体：
gauge.json 被持续重写，监控端（watch/export）随之刷新。

python3 scripts/task_gauge.py done c1          # 完成
python3 scripts/task_gauge.py active c2        # 开始
python3 scripts/task_gauge.py check c2 1 2     # 勾选清单项 1、2
python3 scripts/task_gauge.py set c3 --pct 60  # 手工设定百分比
python3 scripts/task_gauge.py note "设计评审通过"  # 里程碑（进时间线）

诚实纪律：只在有证据时标记完成（文件已生成/测试已通过/用户已确认）；不确定的用
set --pct 或清单部分勾选，面板会标注"（估）"。禁止为了好看而虚报进度。

第 3 步：让用户看见进度

• 每轮回复附上当前刻度条：show（不带子命令时默认执行）。
• 实时监控机制（两层，均为真·实时）：
• 终端：python3 scripts/task_gauge.py watch 每 2 秒重读 gauge.json，AI 每推进一步立刻可见；
• 浏览器：python3 scripts/task_gauge.py export 生成 gauge_dashboard.html 后，
  此后每次推进 CLI 自动重渲染该文件——无需反复手动 export，浏览器的 3 秒自刷新
  拿到的始终是最新状态。
• 活性检测：面板与 watch 按"最后推进距今"自动标色——5 分钟内 ● 活跃（绿）、
  30 分钟内 ◐ 停滞（黄）、更久 ○ 可能中断（红）。AI 卡住一眼可见。
• 多任务监控：init 自动把任务登记进本机注册表（~/.workbuddy/gauges/index.json）；
  list 一屏列出全部任务与活性（试用可用）；export --all 生成全机聚合面板（正版），
  任一任务推进都会自动刷新聚合视图——同时跑多个 WorkBuddy 任务时用这一对命令盯全局。
• show 会给出剩余时间预估：按近 6 小时打点速率线性外推，附置信区间与预计完成时刻；
  打点不足时如实显示"数据不足"，不要编造 ETA。

第 4 步：收尾

python3 scripts/task_gauge.py finish --export

全部刻度 ✓ 后输出终报并归档面板。有未完成刻度会被拒绝（--force 可强制，但需向用户说明）。

中途变更

• add -t "新刻度" -w 2 -r high --after c2：中途追加（需求变更很正常，权重自动重归一）。
• remove c4：删除；history：查看全部打点。
• 换任务目录时用 --file path/to/gauge.json（子命令前后皆可）。

设计约束（写给未来的自己）

• 零第三方依赖，Python 3.9+ 标准库，macOS/Linux/Windows 皆可运行。
• gauge.json 是唯一事实源；HTML 面板由 export 派生，任何时候删掉面板重导即可。
  试用计数存于同目录 task-gauge.trial.json。勿手工编辑这两个文件。
• 端口对接、schema、上架清单见 references/。