开发主题
将候选主题转变为已批准的内容合约。只有当论点、证据和边界不再需要在下游中被发明时,这项工作才准备好进行撰写。
范围
从一个候选主题或一个自然限定的小集合开始。当有几个相近的方向可供选择时,根据受众价值、新颖性、可验证性、可演示性、作者适配度和过度声明风险进行简要比较;在深度研究之前请用户选择。开放式的趋势扫描和维护创意待办事项列表不在本技能范围内。
证据工作区
在视频项目中创建 content/ 目录:
content/
|-- RESEARCH.md
|-- TOPIC.md
`-- experiments/
使用 RESEARCH.md 来记录引用的事实、解释、分歧、未知情况、被拒绝的方向以及指向原始资料的链接。保持收集工作与编辑选择分离。
当一个主张影响主题是否可行、对受众是否重要、是否与替代方案不同、能否被演示、或者在所述范围内是否仍然有效时,将其视为实质性主张。用足以支持该特定主张的来源或实验来支撑它;对于较弱的证据,标记为 provisional,而不是默默将其拉伸。
当一个主张需要可运行的证据时,执行能够解决该问题的最小实验,并编写 content/experiments/<name>.md,包含问题、方法、样本、环境、命令、结果、局限性以及结果支持的结论。将代码和原始数据保留在所属的项目中;记录它们的路径和 Git 修订版本,而不是将它们复制到视频项目中。
内容合约
编写 content/TOPIC.md:
---
status: draft
audience: ...
core_question: ...
thesis: ...
scope: ...
voice:
language: ...
skills: []
documents: []
unavailable: []
status: resolved | assumed
---
# 工作标题
## 读者承诺
## 论点
### A01 - 主张
- role: 该主张在论点中存在的原因
- claim: 确切的命题
- evidence: 指向 RESEARCH.md 标题或实验报告的链接
- confidence: established | provisional
- boundary: 证据未建立的内容
## 不在范围内
## 开放问题
## 备选标题
按以下顺序解析声音来源:明确的用户指示、项目或品牌指导、可用的匹配语言和内容类型的写作风格技能、可见的用户偏好、写作样本,然后是清晰说明性的默认设置。记录实际使用的来源,并将请求但不可用的来源持久化在 voice.unavailable 下;不要假设不可用的记忆或隐藏的个人资料。
批准门
展示工作标题、论文、范围、论点、关键证据、边界和实质性的开放问题进行审查。标题可以持续更改,但受众、论文、范围、论点、证据和结论边界是锁定的决策。
仅当用户明确批准时,才会将前置元数据更改为:
status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>
摘要是移除仅 approved_digest: 行后完整文件的 SHA-256 哈希。在信任批准之前重新计算它。不匹配会使批准失效,并将文件状态恢复为 draft。在经过验证的非实质性标题或副本编辑后,摘要在无需重新批准的情况下可以刷新;将新的摘要传播到每个依赖的工件。
在此之前,将所有写作保留在 RESEARCH.md、实验报告和草稿 TOPIC.md 中。不要创建 ARTICLE.md 或 BEATS.md;要求快速行动或选择论文的权限并不能替代对结果合约的批准。
后来对锁定决策的实质性更改会将 TOPIC.md 恢复为 draft,并使下游的文章批准失效。保留含义的副本编辑、示例和标题更改不会撤销批准。
在展示 content/TOPIC.md 或任何后续修订之前,请遵循 ../boring-video/references/markdown-review.md。将规范 Markdown 路径保留为当前版本,并在该处应用评审反馈。
当 TOPIC.md 已批准,每个实质性主张都有足够的证据支持,剩余的开放问题是非阻塞性的且可见,文章作者可以在不发明事实、实验、作者立场、论点或范围的情况下进行草稿撰写,并且 Markdown 评审完成标准已满足时,主题即为完成。