chore: 新增 agent 技能配置(issue tracker / triage 标签 / 领域文档)

This commit is contained in:
2026-09-10 09:03:52 +08:00
parent a1bc2322f3
commit 9411ac14d1
3 changed files with 103 additions and 0 deletions
+46
View File
@@ -0,0 +1,46 @@
# Domain Docs
各工程技能在探索代码库时,应按本文件读取本工作区的领域文档。
## 布局:单上下文
本工作区不是 monorepo(没有 pnpm-workspace / package.json workspaces),按**单上下文**处理。
```
d:\cherry\ ← 工作区根 = 上下文根
├── CONTEXT.md ← 领域术语表(尚未创建,按需惰性生成)
├── CLAUDE.md ← 工作区约定
├── docs/ ← ring-health-docs 仓库
│ ├── adr/ ← 架构决策记录(尚未创建,按需惰性生成)
│ └── agents/ ← 本目录:技能配置
└── repos/
├── ring-health-app/ ← Android App(Kotlin + Compose)
└── ring-health-api/ ← 后端 API
```
注意:本工作区是**多仓库**(三个独立 git 仓库),但领域上是**单一上下文**——
三个仓库共用同一套术语(戒指、指标、连接态…),不需要 per-context 的 `CONTEXT.md`。
## Before exploring, read these
- **`CONTEXT.md`**(工作区根 `d:\cherry\CONTEXT.md`),或
- **`CONTEXT-MAP.md`**(工作区根,如果存在):它指向每个上下文一份 `CONTEXT.md`,逐个读相关的。
- **`docs/adr/`**(`d:\cherry\docs\adr\`):读与你即将改动的区域相关的 ADR。
这些文件不存在时,**静默继续**。不要指出它们缺失,也不要一上来就建议创建它们。
`/domain-modeling` 技能(经由 `/grill-with-docs` 和 `/improve-codebase-architecture` 到达)
会在术语或决策真正定下来时惰性创建。
## Use the glossary's vocabulary
当你的产出中出现领域概念(issue 标题、重构提案、假设、测试名),使用 `CONTEXT.md` 中定义的术语。
不要漂移到术语表明确避免的同义词。
如果你需要的概念还不在术语表里,这本身是个信号:要么你在发明项目不用的说法(重新考虑),
要么确实存在缺口(记下来交给 `/domain-modeling`)。
## Flag ADR conflicts
如果你的产出与既有 ADR 冲突,明确指出,而不是悄悄覆盖:
> _与 ADR-0007(事件溯源订单)冲突,但值得重新讨论,因为……_