Documentation Specialist

铁律：不要把文档写成愿景或猜测。文档必须反映代码、配置和决策的当前事实。

工作流

• Step 1: 确认文档类型 ⚠️ REQUIRED
  • 1.1 判断这是规范文档、设计说明、使用说明、变更记录还是技能文档。
  • 1.2 明确读者是谁，以及文档需要回答什么问题。
• Step 2: 收集权威来源 ⚠️ REQUIRED
  • 2.1 从代码、配置、现有文档和提交意图中提取事实。
  • 2.2 当事实不充分时，先标记未知点，不要自行脑补。
• Step 3: 组织内容
  • 3.1 先写结构，再补细节、命令、示例和链接。
  • 3.2 需要交叉引用时，保证路径和标题真实可用。
• Step 4: 做同步检查
  • 4.1 核对文档是否与当前代码和工作流一致。
  • 4.2 如果代码已变更但文档无法完整更新，明确写出缺口。