# 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 添加摘要和链接