# story-bible：角色 × 場景 × 世界觀設定聖經：技能書與協作來源 把角色外貌、個性與聲線寫成同一張設定卡，讓編劇、生圖和配音共用正本。 ## 工坊收錄說明 內容與行銷 製作連載影像、短片或配音的創作者、要和夥伴交接角色、場景與世界觀設定的小隊。 一張三層自創角色卡，附 check 問題清單、下游取用欄位與有日期的正本更新紀錄。 讓編劇、影像與配音夥伴各讀需要的一層，實際交接一個角色，再把欄位不清楚的地方回饋原作。 先把 templates 的空白角色卡複製進自己的 library/你的 IP 名稱/，分別寫外貌、行為模式與說話方式。 ## 封面與來源署名 作者：Nico 封面插畫：/art/skills/story-bible.webp 原作者 GitHub：https://github.com/Rumi-3653/story-bible 登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。 原作數據：/api/v1/github/books/story-bible/metrics Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。 ## 讀者與格式 Markdown 創作設定卡與檢查工具 - 製作連載影像、短片或配音的創作者 - 要和夥伴交接角色、場景與世界觀設定的小隊 ## 功能與使用範圍 MIT。Markdown 卡可手填；check／export 需 Python 3.8 以上，只用標準庫。這是設定管理，不會自行生圖、配音或保證角色一致。export 針對 emotion-shot-pipeline 的角色 JSON，其他下游可能是作者自用或第三方工具，不在 repo。examples/還傘 的視覺鎖句與聲線參數未經平台實測。library 預設不進 Git，仍需自己備份與保護未發表 IP；參考圖與聲音需有使用權。工坊未執行檢查或匯出。 - 角色卡分視覺、敘事、聲演三層；另有場景卡與世界觀卡。 - templates 提供空白卡，references/欄位指南.md 解釋填法，examples/還傘 示範整組設定。 - scripts/bible.py check 找缺檔與欄位問題；export 在欄位齊備時產出下游角色 JSON，缺欄就報錯、不寫檔。 ## 開始前準備 - Markdown 編輯器、一位自創角色；先看 templates 與 examples/還傘。 - 自己的 library/你的 IP 名稱/ 保存與備份位置；參考素材須有權使用。 - 需要 check／export 時準備 Python 3.8 以上；先確認下游是否採用相容欄位。 ## 第一個練習 1. 先把 templates 的空白角色卡複製進自己的 library/你的 IP 名稱/，分別寫外貌、行為模式與說話方式。 2. 對照 references/欄位指南.md：恆定外貌留 appearance，逐鏡道具另放 props；未揭露劇透只留封存路徑。 3. 依 README 用 python scripts/bible.py check 核對卡片；確定需接 emotion-shot-pipeline 才 export，修改下游後把設定回存正本。 ## 練習成果 一張三層自創角色卡，附 check 問題清單、下游取用欄位與有日期的正本更新紀錄。 ## 專案與授權 原作 Repo：https://github.com/Rumi-3653/story-bible 從原作建立自己的版本：https://github.com/Rumi-3653/story-bible/fork 工坊整合參考：https://github.com/Rumi-3653/story-bible 記錄的授權：MIT ## 一起改這本技能書 可在原作 Issues 提供自創卡片、缺欄重現或匯出問題，保留 Nico 與 MIT 來源；不要公開未發表 IP、封存劇透、私人聲音或未授權參考圖。 原作 Repo：https://github.com/Rumi-3653/story-bible 預設 PR 目標：Rumi-3653/story-bible:main 從原作建立自己的版本：https://github.com/Rumi-3653/story-bible/fork 原作 PR：https://github.com/Rumi-3653/story-bible/pulls 工坊整合參考：https://github.com/Rumi-3653/story-bible 工坊整合任務專用 Fork：https://github.com/Rumi-3653/story-bible/fork 工坊任務：https://github.com/Rumi-3653/story-bible/issues 工坊 PR：https://github.com/Rumi-3653/story-bible/pulls GitHub Milestones：https://github.com/Rumi-3653/story-bible/milestones 先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。 以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。 - 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。 ### 改善Markdown 創作設定卡與檢查工具的第一個案例 · 建議任務 可在原作 Issues 提供自創卡片、缺欄重現或匯出問題，保留 Nico 與 MIT 來源；不要公開未發表 IP、封存劇透、私人聲音或未授權參考圖。 - 驗收：一張三層自創角色卡，附 check 問題清單、下游取用欄位與有日期的正本更新紀錄。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。 Agent Skill：/development/skills/story-bible/SKILL.md 協作 JSON：/api/v1/skills/story-bible/collaboration ## 參與開發 可在原作 Issues 提供自創卡片、缺欄重現或匯出問題，保留 Nico 與 MIT 來源；不要公開未發表 IP、封存劇透、私人聲音或未授權參考圖。 工坊 Issue／PR 協調入口：https://github.com/Rumi-3653/story-bible/issues 先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。 要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues ## 閱讀與來源 閱讀原始專案：https://github.com/Rumi-3653/story-bible/blob/d0fa28c9a2bf7f26eaf8f01a8b03c2f4508a9ef5/README.md 核對日期：2026-10-20 核對版本：d0fa28c9a2bf7f26eaf8f01a8b03c2f4508a9ef5 - README.md：https://github.com/Rumi-3653/story-bible/blob/d0fa28c9a2bf7f26eaf8f01a8b03c2f4508a9ef5/README.md - LICENSE：https://github.com/Rumi-3653/story-bible/blob/d0fa28c9a2bf7f26eaf8f01a8b03c2f4508a9ef5/LICENSE ## 共創原則 GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。 完整結構化目錄：/api/v1/development-map