feat: 添加代理技能文档,包括问题跟踪器、分诊标签和领域文档

This commit is contained in:
yuxuanhui
2026-09-07 16:27:09 +08:00
parent 7797ff88df
commit 647621e5ea
4 changed files with 99 additions and 0 deletions
+40
View File
@@ -0,0 +1,40 @@
# 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 追加摘要和任务链接。