Type B 概念页

解决什么问题：解释"这个概念/方法是什么 + 怎么用 + 哪里会错"——world-map 90% 的文档是这个 Type。

它是什么

Type B 文档是 wiki 的"知识单元"——每篇聚焦一个概念、一组方法、一个原则。

典型例子：

• meta/source/cybernetics/trilemma/ （三难困境）
• l1-modeling/02-strategic/bounded-context/ （限界上下文，未来）
• meta/writing-style/frontmatter-schema/ （frontmatter 规范）

特征：

• 聚焦一个主题（不展开多个）
• 必须给"它是什么 + 怎么用 + 哪里会错"
• 篇幅 60-100 行

结构模板

---
title: [概念名]
type: concept
layer: [L1 | ... | meta]
group: [group-name]
status: mature
confidence: ★★★★☆
source: [出处]
last_updated: YYYY-MM-DD
related: /path/to/related-1/
  - /path/to/related-2/
---

# [概念名]

> 解决什么问题：[一句话说明本概念解决什么问题——不是"什么是 X"而是"用它能解决什么"]

## 它是什么

[直接给定义——一段话, 不绕弯。可以用 1-2 个引文支持]

## 关键属性

[表格——5-8 行, 列出概念的关键属性]

| 属性 | 值/含义 |
|---|---|
| ... | ... |

## 怎么用

[核心 — 怎么做]

### [场景 1]
[具体步骤或代码示例]

### [场景 2]
...

## 常见误区

1. [误区 1]——[后果]
2. [误区 2]——[后果]

## 关键洞察

> [一句话提炼本文最核心的方法论——可作为读者离开时的"带走"]

## 相关链接

- [相邻文档 1](/path/)
- [相邻文档 2](/path/)
- [源典精读](/path/)

必填 section（6 个）

section	作用	篇幅
# 标题	概念名	1 行
> 解决什么问题	定位句——这个概念解决什么（不是"是什么"）	1 行
## 它是什么	直接定义	1-3 段
## 关键属性	表格——概念的可量化属性	5-8 行表格
## 怎么用	核心——具体怎么用	3-5 个子段
## 常见误区	至少 2 条真实出现过的错误	2-4 条
## 关键洞察	提炼核心方法论	1 段
## 相关链接	反向链接	3-5 条

怎么用

新建 Type B 文档（最常见场景）：

1. 复制本模板
2. 改 title、layer、group
3. 先写"解决什么问题"再写"它是什么"——前者驱动后者
4. 关键属性表填 5-8 行（少于 5 行说明没想清楚）
5. "怎么用"必须给具体场景，不能只说"按情况使用"

常见误区

1. "解决什么问题"写成"什么是 X"——本末倒置，应该是"用它能解决什么"
2. "它是什么"绕弯子——直接给定义，引用 1-2 段即可
3. 没有"怎么用"——只说"是什么"不说"怎么做" = 失败
4. "常见误区"用"待办"代替——必须是真实出现过的错误，不是"未来可能错的"
5. "关键洞察"写得太长——一句话就够，长了说明没提炼

关键洞察

Type B 文档的核心是"怎么用"而不是"是什么"

"它是什么"占 30%，"怎么用"占 50%，"误区 + 洞察"占 20%。这是知识库，不是教科书。

相关链接

• 写作范式总览
• Type A 概览页
• Type C 案例页
• Type D stub 占位
• meta/source/cybernetics/trilemma/（示范文档）