Skip to content

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 写文档时

  1. 看到 sidebar 里有 stub → 知道这篇"该写了"
  2. 选择对应 Type(绝大多数是 B)
  3. 用模板填内容
  4. status: mature
  5. 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: stubtype: concept(或 case/overview)
  • 改 frontmatter: status: stubstatus: mature
  • 用对应 Type 模板重写正文
  • last_updated + related

常见误区

  1. stub 写"它是什么" 1-2 段——一旦写了实质内容,就应该升级到 mature
  2. stub 长期不填——6 个月后评估:是要写还是要删
  3. stub 没用 frontmatter——stub 也要有 frontmatter,机器才知道这是 stub

关键洞察

stub 是"骨架优先于内容"哲学的物理实现

写"标题"比写"段落"容易 100 倍。先把所有"应该写"的标题列出来(stub 化),再逐个填内容——这是世界 map 项目的核心节奏。

相关链接

从名家方法论与工程化思路中蒸馏出自己的工程体系。