Communitygithub.com

sugarforever/boring-video-studio

当内容驱动的视频有一个候选主题,但仍需进行研究、实验、可辩护的论点或用户批准的范围,然后再撰写文章或视频要点时使用。

boring-video-studio 是什么?

此技能(sugarforever/boring-video-studio)用于将候选主题转换为已批准的内容合约。它适用于需要深入研究和实验,以形成可辩护论点并明确内容边界的视频项目。该技能提供了系统化的流程:首先在 `content/` 目录中建立证据工作区(`RESEARCH.md`、`TOPIC.md` 和 `experiments/`),用于收集事实、解释和实验报告;然后编写 `content/TOPIC.md` 内容合约,定义受众、核心问题、论点、范围和声音来源;最后需要通过明确的用户批准门,将状态从 `draft` 切换到 `approved`。它特别强调证据的充分性和基于 Markdown 的审批机制,确保只有经过批准的内容才能进入后续撰写阶段。该技能适用于需要严谨规划和内容验证的 AI 视频制作工作流。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sugarforever/boring-video-studio/tree/HEAD/skills/boring-video/develop-topic

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

开发主题

将候选主题转变为已批准的内容合约。只有当论点、证据和边界不再需要在下游中被发明时,这项工作才准备好进行撰写。

范围

从一个候选主题或一个自然限定的小集合开始。当有几个相近的方向可供选择时,根据受众价值、新颖性、可验证性、可演示性、作者适配度和过度声明风险进行简要比较;在深度研究之前请用户选择。开放式的趋势扫描和维护创意待办事项列表不在本技能范围内。

证据工作区

在视频项目中创建 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 评审完成标准已满足时,主题即为完成。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能