SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场wkc-tracker

wkc-tracker

办公与效率

查看项目

更新于 10-16 06:10

技能介绍

用途

wkc-tracker 用于读写当前项目 issue tracker 中的工单状态。后端由 docs/dev-agents/config.md 中的 issue_tracker 字段指定，可为 GitHub Issues、Linear 或本地 markdown 文件。它面向需要查看或修改工单状态的技能与人员，其他技能通过它的动词访问工单，而不是直接操作后端。

主要能力

  • list [status] [milestone]：带 id、标题、状态、负责人和阻塞项的工单列表。两个过滤器可选；参数若匹配某个 milestone 则按 milestone 过滤，否则按 status；无 status 时只返回开放工单。
  • show <id>：完整展示单个工单，包括正文、评论、标签、阻塞项、负责人。
  • next：返回 frontier，即所有 ready、无 assignee 且无未阻塞项的工单，按 id 升序。若 frontier 为空会说明原因。
  • create <ticket>：在 backlog 创建一个工单，并按第 5 节的形状写入，同时按 ## Blocked by 条目建立依赖边。
  • assign <id> [who] [from <holder>]：设置工单负责人，有四种形式；只有裸形式会改变状态。
  • comment <id> <body>：追加评论，不编辑或删除已有评论。
  • move <id> <status> [original]：改变状态，包括终态关闭。
  • link <id> blocked-by <id>：记录第一个工单被第二个工单阻塞。

使用方式

  1. 解析后端：读取 docs/dev-agents/config.md 中的 issue_tracker，然后完整读取对应的后端文件（github.md、linear.md 或 local.md）。other 无后端文件，按配置正文中用户写的工作流执行。若配置无法指明后端，则停止，不写入、不创建文件或目录、不读取后端文件，并提示用户先运行 wkc-setup（Claude Code /wkc-setup，Codex $wkc-setup，Kiro CLI /wkc-setup）。
  2. 状态：backlog 表示已记录但未承诺；ready 表示已承诺并整理，可安全拾取；in-progress 表示某个会话正在实现；in-review 表示工作已提交等待评审；done 表示已合并并验证；cancel 表示有意不做；duplicate 表示已有其他工单覆盖。四个开放状态之间可任意方向移动，跳过状态不会拒绝。三个终态是最终状态，没有动词能将其移出或重新打开。无记录状态的工单视为 backlog。同时出现在两个状态的工单视为不一致，无状态，list 和 next 会单独列出，move <id> <status> 可修复。没有 blocked 状态；阻塞内容应成为独立工单并用 link 连接。决策工单置于 backlog、未分配、问题写在正文。
  3. 读取、写入、验证：create、assign、comment、move、link 会改变状态，每个都执行读取、写入、验证三步。读取时获取当前状态并检查前置条件，失败则不写入并说明原因。写入尽可能用单条命令，避免半应用。验证是独立读取，与后端当前状态核对，不信任写入的退出码、打印 URL 或响应。验证失败时报告动词、工单、期望、后端实际状态及处理方式。
  4. 动词：见上文主要能力，create 写入的工单形状见第 5 节。
  5. 工单形状：正文包含 ## What to build、## Acceptance criteria（可勾选，每行一条）、## Blocked by（如 - #12）、## Related（仅读者用，不被解析或查询）、## Notes（规格引用，重要摘录直接复制）。create 将每个 ## Blocked by 条目转为真实依赖边。工单包含标题、正文章节、## Blocked by 边和 milestone，后端记录创建者；状态和负责人不属于工单，由 move 和 assign 设置。形状宽松，其他技能可添加章节，无动词因格式拒绝工单，单行工单也有效。
  6. 规则：tracker 拥有工单状态，不得保留并行状态文件（如 PLAN.md 复选框或 PROGRESS.md）。产品文档（prd_file、spec_file、roadmap_file）拥有意图。
  7. 报告：说明读取或更改的内容，github 和 linear 附工单 URL，local 附文件路径。写入只完成一半时说明哪一半及工单当前状态。读取被截断或不一致时如实说明而非报告结果。

适用场景

适用于任何需要查看或改变工单状态的时候，调用者可以是人员、模型或任何需要工单状态的 wkc- 技能。模型可自行读取，但只有在人员或调用技能要求时才运行改变状态的动词。

依赖与限制

需要 docs/dev-agents/config.md 并设置 issue_tracker，由 wkc-setup 写入。GitHub 需要针对支持原生 issue 依赖的主机使用已认证的 gh；Linear 需要 Linear MCP server；本地模式无额外依赖。当配置无法指明后端时，必须停止并请用户先运行 wkc-setup，不得使用其他工具的配置或工单格式，即使仓库中存在。link 拒绝自链接，并会沿阻塞链检测环。没有 blocked 状态。三个终态不可通过任何动词移出或重新打开。关于收费、价格、平台等事实暂未提供。