尝试某个skills

docs/agents/domain.md

@@ -0,0 +1,40 @@
+# 领域文档
+
+工程类 Skill（`improve-codebase-architecture`、`diagnose`、`tdd` 等）在探索代码库前应如何消费本仓库的领域文档。
+
+## 探索前请先阅读
+
+- 根目录的 **`CONTEXT.md`**（单 Context 布局）
+- 根目录的 **`docs/adr/`** —— 阅读与当前改动相关的 ADR
+
+如果这些文件还不存在，**直接跳过，不要提示缺失，也不要主动建议现在就创建它们**。这两个文件由 `/grill-with-docs` 在术语或决定真正确定下来时按需创建。
+
+## 与 openspec/ 的关系
+
+本仓库已经使用 `openspec/`（`openspec/specs/` 存放规范、`openspec/changes/` 存放变更提案）作为正式的提案与规范工作流，详见根目录 `CLAUDE.md` 的「OpenSpec 工作流」一节。`CONTEXT.md` / `docs/adr/` 是补充性质的轻量级领域词汇表和架构决定记录，不会替代 openspec 流程：
+
+- 涉及接口/数据库等实际变更 → 走 openspec 提案
+- 记录领域词汇、命名约定、历史架构权衡 → 写入 `CONTEXT.md` / `docs/adr/`
+
+## 文件结构（单 Context）
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-xxx.md
+│   └── 0002-xxx.md
+└── openspec/
+```
+
+## 使用词汇表中的术语
+
+当输出内容涉及某个领域概念时（issue 标题、重构提案、假设、测试名称），使用 `CONTEXT.md` 中定义的术语，不要漂移到词汇表明确避免使用的同义词。
+
+如果你需要的概念还不在词汇表中，这是一个信号——可能是你在发明项目并未使用的语言（应重新考虑），也可能是真实存在的空白（记录下来留给 `/grill-with-docs`）。
+
+## 标记与 ADR 的冲突
+
+如果你的输出与某条已有 ADR 冲突，必须显式指出，而不是悄悄覆盖：
+
+> 与 ADR-0007（事件溯源订单）冲突——但值得重新讨论，原因是……

docs/agents/issue-tracker.md

@@ -0,0 +1,19 @@
+# Issue 追踪方式：本地 Markdown
+
+本仓库的 Issue 和 PRD 以 Markdown 文件形式存放在 `.scratch/` 目录下。
+
+## 约定
+
+- 每个功能一个目录：`.scratch/<feature-slug>/`
+- PRD 文件：`.scratch/<feature-slug>/PRD.md`
+- 实现类 Issue：`.scratch/<feature-slug>/issues/<NN>-<slug>.md`，从 `01` 开始编号
+- Triage 状态记录在每个 Issue 文件顶部的 `Status:` 行（状态字符串见 `triage-labels.md`）
+- 评论和讨论记录追加在文件底部的 `## Comments` 标题下
+
+## 当某个 Skill 说"发布到 issue tracker"时
+
+在 `.scratch/<feature-slug>/` 下创建一个新文件（目录不存在则先创建）。
+
+## 当某个 Skill 说"获取对应的 ticket"时
+
+读取所引用路径对应的文件。用户通常会直接给出文件路径或 Issue 编号。

docs/agents/triage-labels.md

@@ -0,0 +1,15 @@
+# Triage 标签
+
+这些 Skill 用五个统一的 Triage 角色来表达状态。本文件将这些角色映射到本仓库实际使用的标签字符串。
+
+| Skill 中的角色    | 本仓库使用的标签   | 含义                             |
+| ----------------- | ------------------ | -------------------------------- |
+| `needs-triage`     | `needs-triage`       | 需要维护者评估该 issue            |
+| `needs-info`       | `needs-info`         | 等待提交者补充信息                |
+| `ready-for-agent`  | `ready-for-agent`    | 已完整描述，AFK Agent 可直接处理   |
+| `ready-for-human`  | `ready-for-human`     | 需要人工实现                      |
+| `wontfix`          | `wontfix`             | 不予处理                          |
+
+由于本仓库使用本地 Markdown 作为 issue tracker，这些标签以每个 issue 文件顶部的 `Status: <label>` 行体现（见 `issue-tracker.md`）。
+
+当某个 Skill 提到某个角色时（例如"打上 AFK-ready 的 triage 标签"），使用本表中对应的标签字符串。