转换为文章
将已批准的 content/TOPIC.md 转换为 content/ARTICLE.md:一份既可服务于最终博客文章,又可服务于视频计划的可读内容主文件。
前置条件
阅读 content/TOPIC.md、content/RESEARCH.md、每个被引用的实验报告,以及验证所选证据所需的源材料。仅当 TOPIC.md 的 status 为 approved 时才能继续。
当写作过程中暴露出缺失的支撑材料、矛盾证据、不支持的结论,或者需要对已批准的受众、论文、范围、论点、证据或结论边界进行更改时,应返回 /develop-topic。立即将 TOPIC.md 的 status 重置为 draft,在那里解决缺口,并在重新起草前重新获得主题批准。增加会改变置信度、边界或解释的证据属于实质性更改;增加等效来源且不改变内容契约则不算。
语气
根据已批准的主题解决文章语气。在起草前,检查可用技能以找到与输出语言和内容类型匹配的写作风格技能,然后加载 voice.skills 或 voice.documents 中命名的所有适用的用户、项目或品牌风格源。
如果没有可靠的来源可用于写出达到出版水平的文章,请提出一个简洁的问题以获取期望的语气或样本。当用户将选择权委托给你,或者文章明确是内部草稿时,使用清晰说明性的默认语气,并记录 voice.status: assumed。将无法获取的命名来源记录在 voice.unavailable 下;它们不能作为已应用其规则的证据。当有其他可用来源解决了语气问题时,无法获取的来源不阻碍起草。
起草
撰写一篇完整的、独立于平台的文章。它必须能够独立阅读,保留已批准的论点和边界,区分事实和解释,并为重大主张注明原始来源。在有助于阅读时使用标题、链接、表格或注释;特定于站点的SEO字段、发布组件和平台路径属于后续的发布改编。
使用以下前置元数据写入 content/ARTICLE.md:
---
source: content/TOPIC.md
source_digest: sha256:<TOPIC approved_digest>
status: draft
voice:
language: ...
skills: []
documents: []
unavailable: []
status: resolved | assumed
---
文章可以改进工作标题、行文、示例和章节顺序。它可以压缩或解释已批准的主张,但每个重大事实、观点和结论都必须能追溯到已批准的主题及其证据。新内容首先应在上游添加。
审批门控
展示完整的文章以供审查。只有用户的明确批准才能将其前置元数据更改为:
status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>
计算 approved_digest 为在移除 approved_digest: 行后整个文件的SHA-256哈希。在起草或批准前,重新计算主题摘要,并确保其与 TOPIC.md 的 approved_digest 和本文的 source_digest 都匹配。不匹配会使相关批准或依赖的草稿失效。经过验证的非实质性编辑可以刷新和传播摘要,而无需重新获得批准。
在此之前,不要创建 BEATS.md。继续制作的请求不能替代文章本身的批准。
对 TOPIC.md 的实质性修订会使文章返回 draft 状态。对已批准文章的实质性修订也会使其返回 draft 状态;不影响已批准含义的文案编辑、标题更改和示例则不会。
在展示 content/ARTICLE.md 或其任何后续修订版之前,请遵循 ../boring-video/references/markdown-review.md。将规范化的Markdown路径作为当前版本,并将审查反馈应用到该版本。
文章在满足以下条件时才算完成:已批准、可独立阅读、每个重大陈述都能追溯到已批准的内容契约和充分证据、视频规划者可以重新组织它而无需编造事实、观点、论点或范围,并且Markdown审查完成标准已满足。