mcpField
T
track-tasks

track-tasks

github.com/venhdevAgent 工作流110 次安装今天更新
代码仓库

关于 track-tasks

track-tasks 用于将任务记录到配置的本地或远程跟踪器，并同步任务生命周期。它避免重复创建、维护依赖关系对应的状态，并在写入后核实记录，不修改生产代码。

主要功能

  1. 01解析已配置的跟踪器
  2. 02维护依赖感知的任务状态
  3. 03创建前检查重复记录
  4. 04写入后核实任务记录
  5. 05在任务中嵌入验收与验证步骤

适用场景

  1. 01将任务拆分结果写入跟踪器
  2. 02按依赖同步任务状态
  3. 03确认新建任务记录已保存

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/venhdev/skills --skill track-tasks

安装后在 Claude Code 中输入/track-tasks确认已加载。

附带文件references/issue-tracker-local.mdreferences/task-template.md

详细介绍

track-tasks — 任务持久化与生命周期同步

运行不变量

  • 存储独占性：仅在 .agents/task-tracker.md 中配置的跟踪器内变更任务记录（本地 Markdown .agents/tasks/、GitHub Issues、GitLab 或 Linear）；绝不修改生产代码。
  • 状态完整性：维护规范状态：ready、in-progress、done。将 blocked 视为基于前置任务推导出的状态；只有所有前置依赖都为 done 时，任务才是 ready。
  • 幂等同步：创建前检查现有 issue/文件；写入后重新读取，以验证 ID 和持久化结果。
  • 自包含负载：将验收标准、验证命令和内联证明嵌入任务正文，使子 Agent 无需依赖本地临时文件即可独立执行。
  • 完成后清理：所有任务达到 done 并通过验证后，删除 .agents/tasks/<feature-slug>/（或关闭远程工单）。
  • 自适应调用输出：为人类呈现持久化摘要表；为自主运行器输出紧凑的微型令牌。

领域规则

1. 跟踪器解析

读取 .agents/task-tracker.md。如果文件不存在，则在 .agents/tasks/<feature-slug>/ 下暂存本地 Markdown 存储，并使用 <NN>-<slug>.md 命名约定（参见 references/issue-tracker-local.md）。确认已通过身份验证的 CLI 访问后，遵循远程跟踪方式（gh、glab、Linear）。格式化任务正文时，遵循 references/task-template.md。

2. 状态与任务生命周期转换
  • STAGED：任务已拆分，等待授权持久化。
  • DONE：任务已确认持久化到跟踪器存储中；实现仍待处理。
  • UNRESOLVED：跟踪器通信失败或缺少授权。

规范输出约定

# Task Persistence: <Feature / Scope> · <STAGED | DONE | UNRESOLVED>

Tracker Backend: <Local Markdown | GitHub | GitLab | Linear>
Target Collection: <Path or Project Name>

| Slice ID | System Ref | Persisted Status | Blocked By | Verification Checksum |
| :--- | :--- | :--- | :--- | :--- |
| S-01 | .agents/tasks/auth/01-token.md (#102) | ready | None | <hash or pass> |
| S-02 | .agents/tasks/auth/02-refresh.md (#103) | ready (blocked) | S-01 | PENDING |

Sync Delta: <C> created, <U> updated, <D> unchanged.
*(omit if clean)* Gap: <Tracker communication failure or missing credentials.>

自主微型令牌约定：

SYNCED | tracker: <backend> | created: <C> | updated: <U> | ready: <ID>
路由
  • 已验证持久化，且已授权立即实现符合条件的任务 →（通过 /forge）。
  • 需求冲突导致无法可靠记录 →（通过 /clarify）。
  • 缺少跟踪器凭据或服务不可访问 → 报告 UNRESOLVED。

执行协议

  1. 读取 .agents/task-tracker.md，确定当前持久化目标。
  2. 从 /split-tasks 或调用方获取任务 DAG 清单。
  3. 检查现有任务，避免创建重复工单。
  4. 写入任务文件或调用跟踪器 API，并嵌入验证命令和父级来源信息。
  5. 重新读取已存储任务以确认持久化，然后输出 Markdown 表格或自主微型令牌。

评论

支持 Markdown