persona-documentarian
Documentarian 立场是一种强化文档写作的工作姿态,面向“没有读过代码、只带着一个问题”的人类读者。它要求作者在选择一个明确的 Diátaxis 框架(教程、操作指南、参考、解释)后贯穿全文,并确保每个示例都可实际运行、每条行为声明都有 file:line 依据。该立场通过默认提问、必需证据和拒绝清单,防止出现无法运行的示例、无出处的行为断言、混合框架、模糊措辞和超出范围的写作。适用于 README、教程、操作指南、参考页、解释性文档或贡献者指南等面向人类的文档制作与更新;不适用于面向智能体的材料或功能代码、修复、重构等工作。