yuxuanhui
1.6 KiB
1.6 KiB
Issue tracker: Local Markdown
本仓库的任务与规格存放在 .scratch/。
文件约定
- 每个功能一个目录：
.scratch/<feature-slug>/。 - 规格：
.scratch/<feature-slug>/spec.md。 - 实现任务：
.scratch/<feature-slug>/issues/<NN>-<slug>.md， 从01编号，每个任务独立一个文件。 - 分诊状态记录在任务文件顶部附近的
Status:行， 取值参见triage-labels.md。 - 评论与讨论历史追加在文件底部的
## Comments下。
发布与读取
技能要求“发布到 issue tracker”时，在上述约定路径创建文件， 按需创建目录。
技能要求“获取相关 ticket”时，读取用户指定路径； 若只提供编号，则在对应功能的 issues 目录中定位文件。 编号存在歧义时，先确认所属功能。
Wayfinding
以下约定供 /wayfinder 使用：
- 总览：
.scratch/<effort>/map.md， 包含 Notes、Decisions-so-far 和 Fog。 - 子任务：
.scratch/<effort>/issues/NN-<slug>.md， 从01编号，正文记录待解决问题。 Type:取值为 research、prototype、grilling 或 task。- Wayfinding 使用独立的工作状态：
Status: open、Status: claimed、Status: resolved。 - 依赖记录为
Blocked by: NN, NN； 所有依赖均 resolved 后，任务才解除阻塞。 - 下一个任务：按编号选择 open 且未被阻塞的任务。
- 领取：开始工作前写入
Status: claimed。 - 完成：在
## Answer下追加答案，写入Status: resolved， 并向 map.md 的 Decisions-so-far 追加摘要和任务链接。