prototype generated

docs/agents/issue-tracker.md

@@ -0,0 +1,32 @@
+# 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 添加摘要和链接