Type D stub 占位
解决什么问题:所有"还没写"的文档——保持结构稳定,但内容待填充。
它是什么
Type D 文档是 wiki 的"占位符"——保证 sidebar 链接可达、内容待写。
特征:
- 篇幅极短(4-6 行)
- 不含实际内容
- 有完整 frontmatter
- 6 个月内没人填 → 评估删除
结构模板
markdown
---
title: [文章名]
type: stub
layer: [L1 | ... | meta]
group: [group-name]
status: stub
last_updated: YYYY-MM-DD
---
# [文章名]
> 内容待填充——下次写本类文档时使用 [Type B 概念页模板](/meta/writing-style/type-b-concept/)。与 AI 工作流的关系
stub 不是"低质量文章"——它是"留给 AI 的工作清单"。
AI 写文档时:
- 看到 sidebar 里有 stub → 知道这篇"该写了"
- 选择对应 Type(绝大多数是 B)
- 用模板填内容
- 改
status: mature - 补
last_updated+related
stub 的存在让 AI 不需要问"这篇该写什么"——sidebar 已经把"该写什么"列出来了。
必填 section
| section | 作用 |
|---|---|
| frontmatter | 必填 4 个字段(title, type, layer, group) |
# 标题 | 与 sidebar 链接文字一致 |
> 内容待填充 | 一句话 + 模板链接 |
没有其他 section——stub 不写"它是什么"、不写"怎么用"。
怎么用
新建 stub(占位骨架时):
- 复制本模板
- 改 title、layer、group
- 不写正文
升级 stub → mature:
- 改 frontmatter:
type: stub→type: concept(或 case/overview) - 改 frontmatter:
status: stub→status: mature - 用对应 Type 模板重写正文
- 补
last_updated+related
常见误区
- stub 写"它是什么" 1-2 段——一旦写了实质内容,就应该升级到 mature
- stub 长期不填——6 个月后评估:是要写还是要删
- stub 没用 frontmatter——stub 也要有 frontmatter,机器才知道这是 stub
关键洞察
stub 是"骨架优先于内容"哲学的物理实现
写"标题"比写"段落"容易 100 倍。先把所有"应该写"的标题列出来(stub 化),再逐个填内容——这是世界 map 项目的核心节奏。