Communitygithub.com

sugarforever/boring-video-studio

在已批准的内容主题、研究资料和证据准备就绪后,将其转化为一篇独立于平台的完整文章,为后续的视频分段和发布改编奠定基础。

boring-video-studio 是什么?

此技能专为AI代理(如Claude Code、Cursor)设计,用于将已批准的主题(`content/TOPIC.md`)转换为独立于任何平台的文章(`content/ARTICLE.md`)。它通过验证输入状态、管理写作风格、确保内容与已批准的主题和证据完全一致,并强制执行严格的审批流程来保证内容质量和可信度。该技能支持用户、项目或品牌特定的写作风格源,并在缺乏可靠指引时提供询问机制。它要求所有重大事实、观点和结论都必须能追溯到已批准的主题及其研究资料,并包含一个基于SHA-256摘要变更的审批门控机制。最终产出的文章可独立阅读,并可直接用于视频规划师进行后续的视频分段和出版改编。

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

在你喜欢的 AI 中提问

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

文档

转换为文章

将已批准的 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审查完成标准已满足。

Individual skills in this repo

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

相关技能