Files
risk-management-process/docs/agents/issue-tracker.md
T
2026-08-13 08:51:04 +08:00

1.4 KiB

Issue tracker:本地 Markdown

本仓库的需求、规格和实施任务使用 .scratch/ 下的 Markdown 文件管理。

约定

  • 每个功能使用独立目录:.scratch/<feature-slug>/
  • 功能规格为:.scratch/<feature-slug>/spec.md
  • 实施任务存放于:.scratch/<feature-slug>/issues/<NN>-<slug>.md
  • 任务从 01 开始编号,每个任务使用独立文件,不创建合并的 tickets 文件
  • Triage 状态记录在任务文件顶部附近的 Status:
  • 评论和讨论记录追加到文件底部的 ## Comments 小节

发布到 Issue Tracker

当技能要求“发布到 Issue Tracker”时,在 .scratch/<feature-slug>/ 下创建对应文件;目录不存在时可以创建。

获取任务

当技能要求获取相关任务时,读取用户提供的任务路径或任务编号对应的文件。

Wayfinding 约定

  • 地图:.scratch/<effort>/map.md
  • 子任务:.scratch/<effort>/issues/NN-<slug>.md
  • 子任务通过 Type: 记录类型:researchprototypegrillingtask
  • 子任务通过 Status: 记录 claimedresolved
  • 依赖关系使用 Blocked by: NN, NN
  • 所有依赖任务为 resolved 后,当前任务才解除阻塞
  • 可执行任务按编号顺序领取
  • 领取时先将状态设为 claimed 并保存
  • 完成时在 ## Answer 下记录结果,将状态改为 resolved,并向 map.md 的 Decisions-so-far 添加摘要和链接