# Cs Domain

> 领域模型维护。触发：记决策、加术语、拆 context、维护 CONTEXT/ADR。

- Skill: `dafang/cs-domain` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dafang/cs-domain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dafang/cs-domain/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dafang (https://skillmd.com/u/dafang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dafang/cs-domain

---


# cs-domain

先执行 CodeStable preflight：读 `.codestable/attention.md`；缺失先 `cs-onboard`；不读外部 AI 入口替代（详见 `.codestable/reference/execution-conventions.md`）。

cs-domain 管三件事：**术语**（CONTEXT.md）、**决策**（ADR）、**拓扑**（单 context ↔ 多 context）。所有产物在 `.codestable/requirements/` 下。

## 拓扑判断

每次启动先扫一眼，确定项目当前处于哪种拓扑：

- `.codestable/requirements/CONTEXT-MAP.md` 存在 → **多 context** 模式
- 只有 `.codestable/requirements/CONTEXT.md` → **单 context**
- 都没有 → 项目还没起 domain 文档，按需 lazy 创建

## 单 context 路径

```
.codestable/requirements/
├── CONTEXT.md              # 术语表
├── adrs/                   # 顺序编号 ADR
│   ├── 001-xxx.md
│   └── 002-xxx.md
└── {capability}.md         # 能力 doc（cs-req 产出，不归本技能管）
```

## 多 context 路径

```
.codestable/requirements/
├── CONTEXT-MAP.md          # 子 context 列表 + 关系
├── adrs/                   # 系统级 ADR（跨 context）
├── ordering/
│   ├── CONTEXT.md          # 子 context 术语
│   └── adrs/               # 子 context 特定 ADR
└── billing/
    ├── CONTEXT.md
    └── adrs/
```

## CONTEXT.md 写作规范

CONTEXT.md 是**术语表，不是 spec**。只写"X 是什么"，不写"X 怎么实现"。

格式：

```md
# {Context 名}

{一两句描述这个 context 是什么、为什么存在。}

## Language

**Order**:
{一两句话定义。}
_Avoid_: Purchase, transaction

**Invoice**:
A request for payment sent to a customer after delivery.
_Avoid_: Bill, payment request
```

规则：

- **下定义，不描述行为**——写 "X 是什么"，不写 "X 做什么"
- **同义词列在 `_Avoid_`**——多个词指同一概念时挑最好的，其他列为禁用
- **只收项目特有术语**——通用编程概念（timeout、error type）不进
- **聚类用子标题**——同领域术语自然分组就给小节

## ADR 写作

### 何时该写（守门 3 判据，必须同时满足）

1. **难以回退**——以后改主意成本明显
2. **不带上下文就难理解**——读者会问"为什么这么做"
3. **真实权衡的结果**——有备选方案，因为具体原因挑了一个

三条少一条就**不写**。轻易能回退的决定不写、不奇怪的决定不写、没真备选的决定不写。

### 路径与编号

- 单 context：`.codestable/requirements/adrs/NNN-{slug}.md`
- 多 context 子系统 ADR：`.codestable/requirements/{ctx}/adrs/NNN-{slug}.md`
- 多 context 系统级 ADR（跨 context）：`.codestable/requirements/adrs/NNN-{slug}.md`
- 编号 3 位（001、002...）；扫对应 adrs/ 目录最大编号 + 1
- `{slug}` kebab-case，能让人一眼想起决策内容

### Frontmatter

```yaml
---
id: 001
title: 选择 X 而不是 Y
status: proposed | accepted | superseded | deprecated | partially-superseded
date: YYYY-MM-DD
supersedes: [003]                          # 可选
superseded_by: [015, 017]                  # 可选
relates_to: [requirements/{slug}, 002]     # 可选
---
```

### 正文（Nygard 四节）

```md
# {Title}

## Context
{决策面对的问题、约束、当时的状况。}

## Decision
{我们决定做什么。}

## Consequences
{这个决定带来的正负影响、新出现的约束。}

## Alternatives Considered
{讨论过的备选方案 + 为什么没选。}
```

写 ADR 时用 CONTEXT.md 里已定义的术语；用到新术语就顺手 `_Avoid_` 别名补到 CONTEXT.md。

## 单 → 多 context 升级

**显式触发**——用户必须明确说"这项目要分子系统了"才升级。不要因为 CONTEXT.md 长就自动建议。

升级流程：

1. 跟用户对齐子 context 列表（典型 2-4 个，超过 5 个先质疑是不是切得太细）
2. 创建 `CONTEXT-MAP.md`：列子 context + 它们之间的关系（事件流、共享类型、调用方向）
3. 为每个子 context 建子目录 + `CONTEXT.md` + `adrs/`
4. 把原 `CONTEXT.md` 的术语按归属拆到各子 context；跨多个 context 的术语留在 `CONTEXT-MAP.md` 顶层 Language 节
5. 把原 `adrs/` 下的 ADR 按影响范围分：跨 context 的留原位（系统级），单 context 内部的 mv 到对应 `{ctx}/adrs/`
6. 不动 `{capability}.md`——能力 doc 归 cs-req 管，升级时 cs-req 跟进归类（cs-domain 不替它做）

## 退出条件

- 写 ADR：文件落盘 + 编号正确 + frontmatter 完整 + Nygard 四节齐
- 写 CONTEXT：术语进对位置（单/多 context 拓扑判断正确）+ 同义词列到 `_Avoid_`
- 升级拓扑：CONTEXT-MAP.md + 子目录创建完 + 术语拆分完 + ADR 分级完