tt-worker

tt-worker

读取滴答清单「任务池」中的任务，根据 tag 自动执行。

IMPORTANT: 执行前必须先读取 references/task-format.md 了解任务格式规范。

gsd:workflow gsd:meta tt-worker 执行任务池、tt-worker、处理待办、跑任务池、自动执行、处理池子 tt CLI (npm install -g @wangjs-jacky/ticktick-cli), Bash tt CLI 可用且已登录，任务池清单存在 任务列表读取完成，确认执行范围 每个任务执行前后记录状态 Phase 0 必须首先执行，检测 tt CLI 和任务池清单 只从「任务池」清单读取任务，不读其他清单 单次最多执行 maxTasksPerRun 个任务（默认 5，可在 config.json 配置） 单个任务超时 taskTimeoutMinutes 分钟（默认 30），超时保留进度不标记完成 内容不完整或仓库不存在的任务跳过，不标记完成 每个任务执行完后在 content 末尾追加执行记录 使用简洁日志风格输出，不用轻松语气 </gsd:meta>

gsd:goal自动读取并执行滴答清单任务池中的待办任务</gsd:goal>

<gsd:phase name="前置检测" order="0"> gsd:step检测 tt CLI（tt --version）</gsd:step> gsd:step检测登录状态（tt whoami）</gsd:step> gsd:step读取 config.json 获取任务池 projectId</gsd:step> </gsd:phase>

<gsd:phase name="任务读取" order="1"> gsd:step读取任务池中所有未完成任务（tt project-tasks poolProjectId --json）</gsd:step> gsd:step按优先级/到期时间排序</gsd:step> gsd:step展示任务列表（标题 + tag + 到期时间）</gsd:step> </gsd:phase>

<gsd:phase name="任务执行" order="2"> gsd:step逐个执行任务（不超过 maxTasksPerRun）</gsd:step> gsd:step读取 tag 确定执行策略</gsd:step> gsd:step解析 content 中的执行计划</gsd:step> gsd:step执行任务</gsd:step> gsd:step追加执行记录到 content</gsd:step> gsd:step标记任务为已完成</gsd:step> </gsd:phase>

<gsd:phase name="执行报告" order="3"> gsd:step输出本次执行汇总</gsd:step> </gsd:phase> </gsd:workflow>

执行策略映射（基于 tag）

Tag	执行动作	完成标志
plan-exec	读取 content 中的 plan，逐步执行	plan 中所有步骤完成
spec-dev	读取 content 中的 spec，按 spec 开发	代码提交 + 测试通过
research	搜索资料、分析、输出报告	报告文档生成
article	抓取文章内容、提炼要点	摘要写入 Obsidian
code-task	根据 content 描述直接编码	代码提交

任务状态追踪

每个任务执行过程中，在 content 末尾维护执行记录：

## 执行记录（tt-worker 自动维护）
- [x] 步骤 1：xxx - 完成
- [ ] 步骤 2：xxx - 进行中...

恢复机制：重新运行时检查 ## 执行记录，跳过已完成步骤（[x]），从第一个未完成步骤继续。

安全机制

机制	说明
任务上限	单次最多 N 个（可配置，默认 5）
超时保护	超时后保留进度、不标记完成
跳过策略	格式不完整/仓库不存在 → 跳过 + 记录原因
执行报告	最终输出：成功 N / 跳过 N / 失败 N

配置管理

配置文件：~/.config/tt-auto/config.json

{
  "poolProjectId": null,
  "poolProjectName": "任务池",
  "remoteServer": null,
  "maxTasksPerRun": 5,
  "taskTimeoutMinutes": 30
}

输出风格

简洁日志风格（非轻松语气）：

• [完成] 按plan重构auth模块 - 产出: 3 commits
• [跳过] 仓库不存在: /path/to/repo
• [失败] 超时: 30分钟未完成
• 本次执行: 3 成功, 1 跳过, 0 失败

CLI 命令

# 读取任务池任务
tt project-tasks <poolProjectId> --json

# 读取单个任务详情
tt task-find <taskId>

# 更新任务（追加执行记录）
tt task-update <taskId> -p <poolProjectId> --content "<updated content>"

# 标记完成
tt task-done <poolProjectId> <taskId>

Check List

• tt CLI 已安装且已登录
• 任务池 projectId 已从 config.json 读取
• 只读取「任务池」清单中的任务
• 执行任务数不超过 maxTasksPerRun
• 每个任务根据 tag 使用正确的执行策略
• 执行记录已追加到 content
• 成功的任务已标记为已完成
• 最终输出了执行报告汇总