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

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

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## 解决什么

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

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

## 快速用

```bash
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
```bash
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
```bash
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