Community寫作與編輯github.com

故事敘述迴路

以一句核心梗概為北極星,貫穿從提案到完稿的敘事寫作流程,整合戲劇結構、角色塑造、場景設計、審查判斷與跨技能協作。

故事敘述迴路 是什麼?

「故事敘述迴路」是一個專為戲劇、劇本、影像敘事與真實故事改編設計的高階AI技能。它不同於資訊型寫作,不以事實清單為基準,而是將一句「核心梗概(Logline)」作為所有階段的評判標準。此技能整合了screenwriting(包含jtydhr88的22個寫作模組、sw-workflow階段表與story-bible)、screenplay-review-checklist(37項對抗式審查)、writing-loop(企劃意圖與宣傳文案)、marketingskills(短影音與宣傳)以及humanize-korean(僅用於敘述與企劃書)。它支援多種敘事形式(長片、電視劇、網路劇、短片、舞台劇、實事改編等),並提供共同寫作、教練模式與純審查模式。核心流程為:提案→梗概辯證→骨架→角色→場景/集數設計→初稿→審查(梗概比對、對抗式審查、事實/公共門檻)→判斷(作者反駁/退回)→完成與移交。此技能在Claude Code、Cursor、Codex等AI代理平台上運作,透過明確的階段劃分與回退規則,確保敘事作品從概念到完稿始終保持核心一致性與高品質。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/goodmorninghope-khs/storytelling-loop/tree/HEAD

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

故事敘述迴路 是做什麼的?

故事類文字(戲劇、劇本、影像敘事、真實故事改編)與資訊類文字運作方式不同。它並非事實清單,而是以一句核心梗概(Logline)作為所有階段的基準點;判斷標準不是分數,而是地雷(🔴 🟠 🟡)及作者的反駁;且不刻意潤飾對白。寫作知識集中在 screenwriting 套件中,階段進度與狀態儲存在其中的 sw-workflow 裡。本技能在該階段表之上,額外加入了梗概比對、對抗式審查、真實故事/公共門檻、退回規則、以及移交至其他技能的功能。

技能位置:Aside 帳戶技能資料夾 skills/user/<技能>/(screenwriting、screenplay-review-checklist、writing-loop、marketingskills、humanize-korean、doc-coauthoring、policy-media-desk)。原始儲存庫請參見 README 中的表格。

與 writing-loop 的差異

writing-loop(資訊、說服類文章)storytelling-loop(故事、戲劇)
基準點證據清單(原文事實)核心梗概(與觀眾的一句約定)
單位段落、章節節拍、場景、集數
判斷文體五軸分數 40/50🔴 🟠 🟡 地雷 + 作者反駁,階段通過標準
潤飾必須使用 humanize-korean不在對白中使用(語氣、方言、語病、中斷是角色的特徵)。僅對敘述、大綱、企劃書進行輕度潤飾
退回最多 3 輪退回至問題發生的階段。核心梗概動搖則停止並回到①。輪數由作者決定
狀態各集檢查表story-bible.md(跨工作階段持續寫作)
誰來寫Aside 初稿模式選擇:聯合寫作 / 教練(不修改作者原稿) / 僅審查

迴路

⓪ 提案 → ① 梗概辯證 → ② 骨架 → ③ 角色 → ④ 場景/集數設計 → ⑤ 初稿 → ⑥ 審查 → ⑦ 判斷 ─ 通過 → ⑧ 移交/記錄
              ▲  (北極星)      ▲        ▲            ▲                ▲                │
              └──────────────────┴────────┴────────────┴────────────────┴──── 退回 ────┘
              所有階段結束時進行「梗概比對」:本階段的結果是否堅守那一句梗概?

⓪ 提案

  1. 選擇形式:references/forms.md(長片、電視劇系列/迷你影集、短片/網路劇/短影音、舞台劇、紀錄片/政策影片規劃、短影音、真實故事/傳記敘事、小說)。
  2. 詢問模式(ask_user_question 一次):聯合寫作(Aside 提供初稿)、教練(Aside 僅提供提問、診斷、練習,原稿由作者撰寫)、僅審查(僅執行⑥)。
  3. 需決定事項:篇幅(分鐘、頁數、集數)、平台/提交對象及其規格(比賽/電視台規格優先於技能架構)、截止日期、是否為原著/真實故事、story-bible 位置。
  4. 若已有原稿,則透過 sw-workflow 入口路徑的「反向填表」功能,從原稿中提取核心梗概、結構、角色並存入 story-bible,將空白欄位作為修改清單,從⑥開始運作。
  5. 起始行:故事敘述迴路 · 形式 {形式} · 模式 {模式} · 路徑 {長片 0~7 | 影集 S0~S7 | 短路徑}。

① 梗概辯證(建立北極星)

填寫 references/logline-card.md 的卡片。先產生 5 個候選,透過測試篩選並固定一個,寫入 story-bible 最上方的「北極星」欄位。影集需同時通過引擎(每週產生故事的原因)與集數擴展測試。依賴技能:sw-premise-theme、sw-industry-business(PROBLEM 檢查)、影集需用 sw-series-engine-bible。

②~⑤ 骨架 · 角色 · 場景 · 初稿

依循 screenwriting/modules/sw-workflow/GUIDE.md 中的階段表(長片階段 25,影集階段 S2S6)。每個階段將該表的產出寫入 story-bible,並自我諮詢通過標準。每個階段結束時,留下一行梗概比對紀錄:② 比對:中點(假勝利)是否強化了『...的慾望』→ 是。

  • 韓國電視劇/電影實務可參考 sw-korean-french-screenwriting、sw-series-case-studies(盧熙京)作為案例。
  • 劇本格式採用 sw-format-adaptation(韓國式 S# 場景編號系統、Fountain)。若有提交格式則依其規定。
  • 教練模式下,Aside 不自行產出產出物,而是以問題清單與練習任務形式提供。

⑥ 審查

填寫 references/gates.md 的五個欄位。

  • L 梗概比對:所有場景/集數清單是否堅守北極星。列出未堅守的場景。
  • W 階段通過標準:sw-workflow 表格及各模組的診斷問題(結構13、角色14、對白14、場景13、形式)。
  • R 對抗式審查:screenplay-review-checklist(7層37項標準)。AI 共同撰寫的原稿預設採用 B 方式(子代理初步判斷→證據驗證)。
  • F 真實故事/公共門檻:若涉及真實人物、真實故事、機構影片則開啟(事實、名譽/隱私/肖像、同意;公共機構則需檢查是否違反選舉法、避免評價性語氣)。
  • A 觀眾模擬:僅提供原稿給子代理,進行冷讀測試。「對下一場景/下一集感到好奇嗎?哪些地方令人困惑?主角的慾望能否用一句話說清楚?」

⑦ 判斷與退回

通過條件:無 🔴 + 🟠 已修正或作者決定以反駁方式保留 + L 比對通過 + F 門檻通過(若已開啟)。 作者反駁是 screenplay-review-checklist 的最後一步。若作者表示「這是意圖」,則將地雷記錄為支柱並繼續(寫入決策日誌)。

卡住位置退回階段
A 層(構想、主題)🔴、L 比對失敗橫跨多個階段、「一句話說不清楚」① 梗概
C 層(因果、結構)、幕尾未提出新問題、中間段落鬆散② 骨架
B 層(角色)、對白寫不出來(通常角色缺乏可失去之物)③ 角色
D·F 層(空間、節奏)、無價值轉換的場景、說明性場景④ 場景/集數設計
E 層(對白、情感)、格式違規⑤ 初稿
F 門檻失敗回到④重新設計該場景(確認事實/同意前不應寫作)
  • 修改核心梗概是作者的決定。Aside 僅提供修改理由與候選方案。若修改,則記錄於 story-bible 決策日誌,並從②開始重新比對。
  • 不限制輪數。但若同一地雷連續兩輪存在,則暫停並詢問作者「要修改,還是視為支柱保留?」。

⑧ 移交與記錄

  1. 更新 story-bible.md(當前階段、決策日誌、下一步行動)。原稿以使用者選擇的格式(docx 技能、google-docs 技能、純文字/Fountain 檔案)輸出。
  2. 下一環節(使用者確認後):
    • 企劃意圖、大綱、比賽投稿文件的句子 → writing-loop(從②初稿開始,含文件路徑)。
    • 宣傳文案、預告文案、海報 → writing-loop 宣傳路徑(marketingskills copywriting)。
    • 短影音、SNS 片段腳本 → marketingskills social/video 模組 + 本迴路短路徑。
    • 上傳至 YouTube 的影片(短劇、政策影片、真實故事敘事)→ youtube-agent(原始來源 Jakeschincariol/youtube-agent-skill,MIT):用 yt-script 附加前 15 秒鉤子(21 種公式、評分)與 [ON SCREEN] 畫面指示;用 yt-package 處理標題、縮圖;用 yt-chapters、yt-seo 處理說明欄。若產出長影片,則用 yt-shorts 再次提取短影音。若鉤子薄弱,則退回④場景設計。
    • 影片製作(動態圖像、展示短片)→ 參照 policy-media-desk 對接表⑤擴散環節。
    • 真實故事/傳記敘事 → 事實依據採用 writing-loop A 門檻方式,記錄參照對接表⑥記錄環節。
  3. 將心得以一行形式加入 references/lessons.md。

判斷界線

  • 教練模式下,不修改作者的原稿句子。僅提供診斷、提問、練習。
  • 處理真實人物的故事時,在取得本人(或家屬)同意及事實確認前,不得移交至公開用原稿。若為改編作品,需明確標示改編。
  • 機構宣傳影片、機關首長出演內容,需同時開啟 writing-loop D 門檻(避免評價性語氣、選舉法檢查、禁止誇大效果)。不進行法律判斷。
  • 寫作原文的引用句以及 screenplay-review-checklist 的原文全文,不得移至公開儲存庫。

修改歷史

  • 2026-11-04 v1.1:在移交環節新增 youtube-agent(YouTube 影片的鉤子、標題、縮圖、說明欄、短影音)。
  • 2026-11-02 v1.0:首次建立。安裝 screenwriting(jtydhr88)與 screenplay-review-checklist(zhlmi),並與 writing-loop、marketingskills、humanize-korean、policy-media-desk 整合。

相關技能