| name | tabtracker |
| description | 管理自动化任务——创建、列出、暂停、恢复、立即触发（产品模块名「自动化」， 具体条目称「自动化任务」；CLI 命令仍为 tabtin tracker）。当用户表达"派活"意图时使用： 关键词包括"帮我..."、"以后..."、"每天..."、"工作日..."、 "提醒我..."、"定时..."、"每周..."。区分一次性指令（直接执行）和长期任务（创建 自动化任务，由调度器在指定时间唤起 Agent）。
|
| metadata | {"version":"0.2.2","tabtin":{"category":"collaboration","autoActivateFor":["tabtracker"],"entry":"cli","tags":["tracker","scheduling","automation","自动化","自动化任务"]}} |
自动化（tabtin tracker）
概述
「自动化」是 TabTin 的产品模块名；模块里的每一条长期工单叫自动化任务。
对用户说话时：指模块用「自动化」，指具体任务/执行用「自动化任务」。
CLI 命令名仍是 tabtin tracker（工程内部也可称 Tracker）。
每个自动化任务绑定一个 Agent，可选预绑定一个 Skill。默认纯 Agent 模式下，
用户描述意图，Agent 在调度时刻自助搜索并调用可用 Skill 完成任务。
入口规范：本 Skill 的所有操作通过 tabtin tracker CLI 触发，由 Agent 通过
run_terminal_command 工具调用。没有对应的 FC 工具——charter §3.1 / AGENTS.md
明确「CLI-first，不是 FC-first」。
| 场景 | 推荐命令 |
|---|
| 对话中创建未来一次性自动化任务 | tabtin tracker new ... --once-at "明天上午十点" --agent ... --workspace-id ... --instructions "..."（执行 Workspace 会写入创建请求体，见 ） |
| 列出当前 Space 所有自动化任务 | tabtin tracker list |
| 查看自动化任务详情 | tabtin tracker show <tracker-id> |
| 查看历次执行 | tabtin tracker runs <tracker-id> |
| 立即触发一次执行 | tabtin tracker trigger <tracker-id> |
| 取消进行中的本次执行 | tabtin tracker cancel-run <tracker-id> <run-id> |
| 暂停 / 恢复 | tabtin tracker pause <tracker-id> / tabtin tracker resume <tracker-id> |
| 删除 | tabtin tracker delete <tracker-id> |
| 触发条件试运行 | tabtin tracker dry-run <tracker-id> [--replay-last N] |
何时调用本 Skill
调用时机：用户表达"以后 / 未来 / 定时"做某事的意图。
| 用户表达 | 是否创建自动化任务 |
|---|
| "帮我每天早上 9 点同步 X" | ✅ 创建 daily 自动化任务 |
| "工作日下班前提醒我 Y" | ✅ 创建 weekdays 自动化任务 |
| "以后每次有新订单就通知我" | ✅ 创建事件触发自动化任务 |
| "现在帮我查一下数据" | ❌ 一次性指令，直接执行 |
| "我想要一个查 X 的功能" | ❌ 创建 Skill 不是自动化任务 |
关键判别：「现在 vs 以后」+「一次 vs 重复」。两者都倾向「以后」或「重复」时，
创建自动化任务。
CLI 命令
每个子命令的完整参数与示例（new / list / show / runs / trigger / pause / resume / cancel-run / delete / dry-run）见 references/cli-commands.md。
不要使用已移除的 tabtin tracker cancel（曾等价 pause）；暂停用 pause，取消单次执行用 cancel-run。
资源导航（按需读取 / 运行）
references/cli-commands.md：当你需要核对 tabtin tracker 子命令的完整 flag、参数约束或示例时读取。scripts/new-and-activate.sh：旧版兼容入口；当前 tabtin tracker new 已直接创建为活动状态，新调用无需使用该脚本。
输出契约（创建 / 启用后必须给可点链接）
创建或启用成功后，在最终回复里用 markdown 链接指给用户，方便一键打开详情：
[查看自动化任务「任务名」](tabtin://resource/tracker/<完整uuid>?hint=tabtracker)
<type> 必须是 tracker（不是 tabtracker / goal / cron）<id> 用 CLI 返回的完整 tracker UUID?hint=tabtracker 建议带上
注意事项
- 对用户说话：模块称「自动化」，具体任务/执行称「自动化任务」；不要蹦「Tracker」；命令仍写
tabtin tracker ...。
--agent 必填，--skill 可选：创建必须指定执行 Agent——先用 tabtin agent list 取 agent id。默认不要猜 Skill；只有用户明确指定或已确认已安装时才传 --skill。- 未来只跑一次用
--once-at：用户说“明天上午十点”这类相对时间时直接传给 --once-at；不要误用 --schedule manual。
- 创建时必须把用户要 Agent 做什么写进
--instructions：这是运行时任务主体。不要只把任务写进名称或 --description。
- 创建后直接活动：
tabtin tracker new 成功返回时已经进入调度，不要再补第二条启用命令。用户明确要求暂不运行时，创建成功后使用 tabtin tracker pause <id>，产品侧只表达“活动 / 暂停”。
- 意图留痕：UI / command palette 会写
intent_snapshot；CLI 无 --intent flag，Agent 应在最终回复里保留用户原始意图与最终配置。
- CLI = HTTP 等价路径：走
/api/tracker/events，与 UI CreateTrackerDialog 同一 service。
Risk Level
| 命令 | risk_level | 含义 |
|---|
list / show / runs / dry-run | safe | 只读 / 试运行 |
new | review | 创建后定时执行，需用户知晓 |
pause / resume | review | 影响业务节奏（生命周期切换） |
trigger / run-now | review | 立即消耗 token + 外部资源 |
cancel-run | review | 终止进行中的本次执行 |
delete | high | 软删归档，destructive |
历史背景（仅供参考）
早期 charter 曾设想 FC 工具；Tracker 模块收敛后整体下线，以 tabtin tracker CLI 为唯一对外契约。产品面：模块称「自动化」，具体条目称「自动化任务」。
