yuxuanhui
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# 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 追加摘要和任务链接。
|