# 你的第一个 KDNA 领域

> 简明指南。详细端到端教程见 [First Domain Walkthrough](./first-domain-walkthrough.md)（英文）。

10 分钟内构建一个可工作的 KDNA 领域，并看到它如何改变 Agent 的判断。

## 第一步：安装

```bash
npm i -g @aikdna/kdna-cli
```

## 第二步：创建开发源工作区

```bash
kdna dev scaffold my-domain
```

这会脚手架出一个非权威的开发源工作区，包含占位的公理、概念、立场和自检。需要可信 `.kdna` 资产时，请使用 An authoring environment 完成 Human Lock、编译和导出。

## 第三步：查看

```bash
kdna inspect ./my-domain
```

你会看到：1 条公理、1 个本体概念、1 个框架、2 个立场、2 个禁用词、2 条自检。

## 第四步：理解判断结构

打开 `KDNA_Core.json`，注意：

- **公理** 不是泛泛而谈的建议，而是具体可验证的原则。比如"清晰度是写作者唯一的义务"。
- **本体** 定义了概念的含义和边界。比如"认知负荷是心智努力，不是降智"。
- **立场** 声明了领域的默认姿态。比如"写作是为了传递理解，不是为了炫耀智力"。

打开 `KDNA_Patterns.json`，注意：

- **禁用词** 包括 `"obviously"`——附有为什么误导和该用什么替代的解释。
- **误解识别** 捕捉错误假设。比如"好文章需要复杂词汇"是错误的。
- **自检** 是 Agent 在回答前问自己的 yes/no 问题。

## 第五步：看到变化

**不使用 KDNA**——如果你让 Agent "帮我审这篇博客"，它给出的是通用编辑建议。

**加载 writing KDNA 后**——同一个 Agent：

1. 检查每个段落是否服务于一个明确的想法
2. 标记使用禁用词的句子
3. 自问："每个句子能被目标读者一次性读懂吗？"
4. 建议删除多于重写

核心转变：**KDNA 改变的是 Agent 注意到什么，而不仅仅是措辞。**

## 第六步：创建你自己的

```bash
kdna dev scaffold my-domain
```

编辑 `KDNA_Core.json`——为你的领域写 2-3 条公理。然后：

```bash
kdna publish --check ./my-domain
kdna dev validate ./my-domain
```

**下一步**：[Loader 行为规范](/zh/docs/loader-behavior) — 理解 Agent 该如何使用 KDNA。
