Communitygithub.com

sugarforever/boring-video-studio - 主題開發

當內容驅動的影片有候選主題,但仍需研究、實驗、可辯護的論點或用戶核准的範圍,才能撰寫文章或影片大綱時使用。

boring-video-studio - 主題開發 是什麼?

此技能「主題開發」是 Boring Video Studio 的一部分,專為內容創作者與 AI 代理設計。它將一個原始的影片主題想法,轉化為一份經過核准、結構化的「內容合約」,確保在實際寫作或製作開始前,所有核心論點、證據和研究範圍都已鎖定。此技能要求建立一個包含 RESEARCH.md(原始資料收集)和 experiments/(小型實驗記錄)的證據工作區,最終產出一份定義完整、包含論證結構、範圍與受眾的 TOPIC.md。整個流程以嚴格的核准關卡結束,僅在用戶明確批准後,TOPIC.md 的狀態才會從「草稿」變為「已核准」,後續任何對鎖定決策的重大變更都將使核准失效。該技能支援任何可執行 Markdown 與文件操作的 AI 代理環境,例如 Claude Code 或 Cursor,並內建一套處理聲音/語氣來源的優先順序規則。

相容平台~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 下;不要假設無法獲得的記憶或隱藏設定檔。

核准關卡

展示工作標題、論點、範圍、論證、關鍵證據、邊界以及重要的開放問題以供審查。標題可以持續變動,但受眾、論點、範圍、論證、證據和結論邊界是鎖定的決策。

僅有明確的用戶核准才能將 frontmatter 變更為:

status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>

摘要(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.

相關技能