33 lines
1.4 KiB
Markdown
33 lines
1.4 KiB
Markdown
# 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 添加摘要和链接
|