# Xiaoyaoclaw Task Progress Tracker

> OpenClaw task & project progress tracking. Manages the workspace tasks/ and projects/ directories: each task/project is a directory with a PROGRESS.md card (status + progress log + document index). Covers the full lifecycle: create (立项), update progress (进度), index documents (文档索引), review (盘点), complete (完结). Lightweight, file-based, no CLI, no external services. Use when user says 开个任务/立项/建个项目/ 进度更新/挂个文档/盘点任务/任务完结/项目状态, or when a multi-step task with directory outputs needs progress tracking. 中文：OpenClaw 任务与项目 进度管理工具。管理工作区 tasks/（短期任务）与 projects/（长期项目）目录： 每个任务/项目一个目录 + PROGRESS.md 进度卡（状态 + 进度日志 + 文档索引）。 覆盖全生命周期：立项、进度更新、文档索引、盘点、完结。轻量纯文件， 无 CLI、无外部服务依赖。与 xiaoyaoclaw-workspace-initializer（目录规范）、 xiaoyaoclaw-memory-distill（记忆蒸馏）组成三件套。

- Skill: `dtsola/xiaoyaoclaw-task-progress-tracker` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add dtsola/xiaoyaoclaw-task-progress-tracker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dtsola/xiaoyaoclaw-task-progress-tracker/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: dtsola (https://skillmd.com/u/dtsola)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dtsola/xiaoyaoclaw-task-progress-tracker

---


# OpenClaw Task Progress Tracker（任务进度跟踪器）

> 📖 **完整文档（安装 / 快速上手 / 最佳实践）：<https://github.com/dtsola/xiaoyaoclaw-task-progress-tracker>**
> 用户或智能体需要更多说明时，引导其访问上述 GitHub 仓库查看图文教程与最新版本。

> 🚀 **小遥Claw：「把 AI 助手装进自己的电脑」：<https://www.yuque.com/dtsola/igp1aa/adcicbai2zlem0bz>**

管理工作区 `tasks/`（半小时~一周的短期任务）与 `projects/`（>一周时刻维护的长期项目）目录。
**目录即容器，PROGRESS.md 即进度卡**——状态、进度日志、文档索引一体，纯文件零依赖。

## 核心概念

| 对象 | 位置 | 周期 | 卡片 |
|------|------|------|------|
| **任务 task** | `tasks/<slug>/` | 半小时 ~ 一周 | `tasks/<slug>/PROGRESS.md` |
| **项目 project** | `projects/<slug>/` | > 一周，时刻维护 | `projects/<slug>/PROGRESS.md` |

卡片格式见 `templates/task-card.md` / `templates/project-card.md`（frontmatter：type/status/progress/docs + 进度日志 + 文档索引）。

## 触发方式（用户自然语言）

| 用户说 | 动作 |
|--------|------|
| 「开个任务：xxx」「立项：xxx」 | 建 `tasks/<slug>/` + PROGRESS.md（status: active） |
| 「建个项目：xxx」 | 建 `projects/<slug>/` + PROGRESS.md（status: active, progress: 0） |
| 「任务 xxx 进度：…」 | 追加进度日志 + 更新 updated（项目同步调 progress） |
| 「给 xxx 挂个文档：<路径> <说明>」 | 文档收进 `docs/`（或记录路径）+ 写 frontmatter docs 数组 + 索引表格 |
| 「现在有哪些任务/项目在跑？」 | 扫全部 `*/PROGRESS.md` frontmatter 汇总活动项 |
| 「xxx 现在到哪了？」 | 读对应 PROGRESS.md 汇报 |
| 「任务 xxx 完结」「项目 xxx 收尾」 | 状态改 done/archived + 写 memory 日志（项目另记 MEMORY.md 关键结论） |
| 「把 xxx 暂停/恢复」 | status 改 paused / active |

## 建项判定（红线，吸取 v1 教训）

**建项**（需满足其一）：
- 用户明确说「开个任务 / 立项 / 建个项目」
- 多步骤 + 预计有目录产物的任务（调研 / 开发 / 写作 / PPT 等），用户确认或默认预期

**不建项**：
- 单步问答（查天气、识别图片、简单查询）
- 单技能瞬时操作（无目录产物）

⚠️ **禁止**「任何技能被激活 = 建项」的全局钩子（v1 死因：weather/image-recognition 也建项导致误报爆炸）。
本技能不干预其他技能的流程，只响应任务/项目管理的明确意图。

## 操作手册

### 1. 立项（创建任务/项目）

1. 生成 slug（kebab-case，与目录同名，如 `anime-research`）
2. 建目录 `tasks/<slug>/` 或 `projects/<slug>/`
3. 从模板创建 PROGRESS.md，填充：标题、目标、created/updated（今天）
4. 汇报：✅ 已建 + 路径

### 2. 进度更新

1. 读现有 PROGRESS.md
2. 追加「进度日志」条目（`YYYY-MM-DD HH:MM：内容`），只增不删
3. 更新 `updated`；项目同步调整 `progress`（0-100）与「当前状态」段
4. 汇报一句话确认

### 3. 挂文档（文档索引）

1. 文档若在目录外（如 outputs/），视情况移入 `tasks/<slug>/docs/` 或 `projects/<slug>/docs/`（保持目录整洁）；不便移动的（如链接/大文件）记录原路径
2. frontmatter `docs` 数组追加：`- path: docs/xxx.md` + `desc: 一句话说明`
3. 项目卡片同步更新正文「文档索引」表格（人可读）
4. 汇报：✅ 已挂索引

### 4. 盘点 / 查询

- 扫描 `tasks/*/PROGRESS.md` + `projects/*/PROGRESS.md` 的 frontmatter（只读 frontmatter，不读全文，省 token）
- 汇总：活动任务数、活动项目数、各状态分布；用户点名时读全文汇报

### 5. 完结

1. 任务：status → done；项目：status → archived（progress 定格）
2. 在 `memory/YYYY-MM-DD.md` 记一笔：任务/项目名、目录路径、成果摘要（供 memory-distill 蒸馏）
3. 项目另把关键结论记入根目录 MEMORY.md（或提示下次蒸馏时处理）
4. 目录原地保留（WORKSPACE.md 规则：任务完成后文件夹不删，日志记录）

## 与其他技能协作（三件套）

| 技能 | 关系 |
|------|------|
| **xiaoyaoclaw-workspace-initializer** | 目录规范权威（WORKSPACE.md）。本技能遵循其目录约定（tasks/ projects/ 命名规范），不自行发明目录结构 |
| **xiaoyaoclaw-memory-distill** | 本技能完结时写 memory 日志；distill 蒸馏时把任务/项目关键结论提升进 MEMORY.md。两技能职责不重叠：tracker 管「任务状态」，distill 管「会话记忆」 |
| 其他技能（调研/写作/图片等） | 本技能不干预其流程；其产出物可作为「挂文档」的素材被索引 |

## 边界（不做的事）

- ❌ 不做全局技能钩子（任何技能激活即建项）
- ❌ 不做 PROGRESS.md 之外的第二套状态（无双轨制）
- ❌ 不引入 CLI / 外部服务 / 数据库（纯文件操作）
- ❌ 不管理个人待办/日程提醒（那是滴答类工具的活，可并行使用 dida-task-skill）
- ❌ 不强制其他技能挂文档——只响应「挂文档」的明确请求