1.4 KiB
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:记录类型:research、prototype、grilling或task - 子任务通过
Status:记录claimed或resolved - 依赖关系使用
Blocked by: NN, NN - 所有依赖任务为
resolved后,当前任务才解除阻塞 - 可执行任务按编号顺序领取
- 领取时先将状态设为
claimed并保存 - 完成时在
## Answer下记录结果,将状态改为resolved,并向map.md的 Decisions-so-far 添加摘要和链接