Communitygithub.com

sugarforever/boring-video-studio

當已核准的主題、研究摘要與證據需要轉換為獨立於平台的完整文章,以便後續進行影片腳本或發布改編時使用。

boring-video-studio 是什麼?

此技能「sugarforever/boring-video-studio」主要負責將已核准的內容主題(content/TOPIC.md)轉換為獨立於平台的完整文章(content/ARTICLE.md)。它適用於任何需要先產出可讀性高的內容主體,再進行部落格文章或影片計畫改編的場景。技能支援多種 AI 代理平台(如 Claude Code、Cursor、Codex),並可在開發者工作流程中自動執行。其核心運作機制包括:驗證前置條件(主題狀態為 approved)、從主題中解析寫作風格、撰寫獨立結構的文章並保留核準的論點與證據、以及嚴格的審批門檻。文章必須能獨立閱讀、區分事實與解釋、並引用原始來源。只有在獲得使用者明確核准後,文章狀態才會變更為 approved,並產生對應的數位摘要。此技能確保內容在進入影片腳本或發布階段前,已具備完整且可追溯的基礎。

相容平台~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.

相關技能