Skip to content

Latest commit

 

History

History
50 lines (38 loc) · 1.44 KB

File metadata and controls

50 lines (38 loc) · 1.44 KB
title 写作约定
status active
type meta
created 2026-07-23
updated 2026-08-31

写作约定

文件命名

  • 使用小写英文和连字符,例如 capability-gap.md
  • 日期讨论记录使用 YYYY-MM-DD-topic.md
  • 决策记录使用四位编号,例如 0001-capability-as-primary-unit.md

文档状态

  • seed:刚记录的想法;
  • draft:正在发展;
  • proposed:决策记录已提出,尚未接受;
  • accepted:决策记录已接受并生效;
  • active:当前有效;
  • contested:存在未解决争议;
  • superseded:已被其他文档替代;
  • stable:经过多轮案例检验,暂时稳定。

论述标签

正文中必要时显式使用:

  • 定义:规定术语在本理论中的含义;
  • 假说:可能被事实支持或反驳的主张;
  • 观察:来源明确的经验事实;
  • 推论:从已有定义或命题推出;
  • 类比:帮助理解,但不能独立承担证明;
  • 开放问题:尚未解决。

引用原则

  • 历史事实必须能够回溯到来源;
  • 优先使用原始论文、专著、档案和权威数据;
  • 阅读笔记与我们的推论分开书写;
  • 不把来源作者没有明确表达的内容写成其观点。

链接原则

  • 使用标准 Markdown 相对链接;
  • 概念首次出现时尽量链接到领域模型页面;
  • 避免孤立页面;每个页面至少应被一个索引页引用。