任务进度四态上报+成果交付入库——FmodeAgent 平台 App/看板实时可见。三表初始化+progress四态心跳+deliver幂等上报+status双视角；Parse Date __type坑实测沉淀；零硬编码凭据四级解析。

liuyuyang ef3221abd5 skill-task-progress v0.1.0: 任务进度四态上报+成果交付入库——三表初始化(幂等PUT补列)+progress四态心跳+deliver幂等upsert+status双视角; Parse Date __type坑实测沉淀(schema 111双向验证); 凭据四级解析零硬编码		1 week ago
skills	ef3221abd5 skill-task-progress v0.1.0: 任务进度四态上报+成果交付入库——三表初始化(幂等PUT补列)+progress四态心跳+deliver幂等upsert+status双视角; Parse Date __type坑实测沉淀(schema 111双向验证); 凭据四级解析零硬编码	1 week ago
.gitignore	ef3221abd5 skill-task-progress v0.1.0: 任务进度四态上报+成果交付入库——三表初始化(幂等PUT补列)+progress四态心跳+deliver幂等upsert+status双视角; Parse Date __type坑实测沉淀(schema 111双向验证); 凭据四级解析零硬编码	1 week ago
LICENSE	ef3221abd5 skill-task-progress v0.1.0: 任务进度四态上报+成果交付入库——三表初始化(幂等PUT补列)+progress四态心跳+deliver幂等upsert+status双视角; Parse Date __type坑实测沉淀(schema 111双向验证); 凭据四级解析零硬编码	1 week ago
README.md	ef3221abd5 skill-task-progress v0.1.0: 任务进度四态上报+成果交付入库——三表初始化(幂等PUT补列)+progress四态心跳+deliver幂等upsert+status双视角; Parse Date __type坑实测沉淀(schema 111双向验证); 凭据四级解析零硬编码	1 week ago
package.json	ef3221abd5 skill-task-progress v0.1.0: 任务进度四态上报+成果交付入库——三表初始化(幂等PUT补列)+progress四态心跳+deliver幂等upsert+status双视角; Parse Date __type坑实测沉淀(schema 111双向验证); 凭据四级解析零硬编码	1 week ago

skill-task-progress · 任务进度+成果上报 📊

Agent 干活进度与成果交付，即刻进入 FmodeAgent 平台（App 四 Tab / 看板实时可见）——初始化三表 + 进度四态上报 + 交付链接入库。来源：FmodeAgent 集群实战验证的「任务进度上报+成果交付上报」能力（agent-status-reporter 家族封装）。

解决什么

Agent 在容器里埋头干活，主人看不到进度、成果散落各处没人沉淀。本技能把三件事变成三条命令：

Agent 上报 → Parse 表 → App 四 Tab / 看板（scope 三视角 mine/company/all）
  ① init-tables   初始化/校验 FmodeAgent / AgentTaskStatus / AgentDeliverable 三表
  ② progress      任务四态 ack→running→done/failed + 30s 心跳（无心跳=疑似死亡主动查）
  ③ deliver       交付即报：交付物+链接上报入库（幂等覆盖，漏报即补）
  ④ status        查询本 agent 最近任务 / 全集群视角

快速用

node skills/fmode-task-progress/scripts/init-tables.mjs
node skills/fmode-task-progress/scripts/progress.mjs ack --agent my-agent --task t1 --name "课纲修订"
node skills/fmode-task-progress/scripts/progress.mjs running --agent my-agent --task t1
node skills/fmode-task-progress/scripts/deliver.mjs --agent my-agent --task t1 \
  --title "课纲 v1.0.6" --url "https://s3.fmode.cn/xxx/index.html" --type courseware
node skills/fmode-task-progress/scripts/status.mjs mine --agent my-agent

凭据（零硬编码）

四级解析：环境变量 PARSE_APP_ID/PARSE_MASTER_KEY → ~/.fmode/config.json parse 段 → future-server/config/config.nova.json → 报错指引退出。密钥绝不入仓。

已知坑（实测沉淀）

Parse Date 字段必须 {"__type":"Date","iso":"..."} 包装，裸字符串报 schema 111——脚本已统一封装 wrapDate()（详见 SKILL.md 坑章节）。

上报纪律

交付即报：每章/每版/每次部署/每轮大修各一条，漏报即补（--delivered-at 补录）
四态+心跳：running 30s 无心跳=疑似死亡，调度层主动查
done 的前提是验收过：只收 DONE 标记未独立验证不报 done

各工具安装

Hermes Agent

git clone https://git.fmode.cn/fmode/skill-task-progress.git
cp -r skill-task-progress/skills/fmode-task-progress ~/.hermes/skills/

Claude Code / Codex

git clone https://github.com/fmodecn/skill-task-progress.git
cp -r skill-task-progress/skills/fmode-task-progress ~/.claude/skills/   # 或 ~/.codex/skills/

WorkBuddy / 其他

复制 skills/fmode-task-progress 到对应技能目录，读 SKILL.md 按工具规范并入。

License

MIT

README.md