book-pipeline

name	book-pipeline
description	從 Obsidian 研究筆記到 KDP 電子書上架的完整製作 SOP。觸發時機：建立書籍 EPUB、整合 Obsidian 草稿、KDP 上架準備、格式規範確認、epubcheck 驗證、新書專案初始化、記錄寫作 session 進度。

book-pipeline

從 Obsidian 研究筆記、概念 tag 到 KDP 上架電子書的完整書籍製作 SOP。 涵蓋：草稿方法論 → 草稿整合 → 格式規範 → 排版 QA → EPUB 建置 → 出版提交。 完全通用，適用任意書籍專案。

Trigger Phrases

• 「脈絡交接」、「恢復進度」、「今天繼續」
• 「建立 tag」、「概念節點」、「草稿方法」
• 「整合 Obsidian 草稿」、「合併 Components 筆記」、「統一書稿格式」
• 「建立 EPUB」、「重建電子書」、「build pipeline」
• 「KDP 上架」、「填寫出版資訊」、「BISAC」
• 「書稿 QA」、「排版檢查」、「epubcheck」
• 「新書專案初始化」
• 「記錄這次 session」、「建立工作日誌」、「記錄進度」（→ 載入 coding-worklog/SKILL.md）

Workflow

Stage 0  環境安裝與驗證
            ↓ [INSTALL-WINDOWS.md]
Stage 1  脈絡交接 / 恢復進度
            ↓ [00-SESSION-SETUP]
Stage 2  新書專案初始化 + 草稿方法論
            ↓ [02-DRAFTING]
Stage 3  Obsidian 草稿整合
            ↓ [03-OBSIDIAN-TO-DRAFT]
Stage 4  格式規範確認
            ↓ [04-SOURCE-MANAGEMENT]
Stage 5  排版 QA 修正
            ↓ [05-EDITORIAL-QA]
Stage 6  EPUB 建置 + epubcheck 驗證
            ↓ [06-EPUB-BUILD]
Stage 7  KDP metadata 準備
            ↓ [07-PUBLISHING-PREP]
Stage 8  KDP 後台提交 → 上架
            ↓ [08-SUBMISSION]

Module Index

需求	載入模組
脈絡交接、進度恢復	00-SESSION-SETUP
草稿方法論、tag 模板、概念節點	02-DRAFTING
Obsidian 草稿 → 統一書稿	03-OBSIDIAN-TO-DRAFT
Source 文件格式規範	04-SOURCE-MANAGEMENT
排版 QA 審查	05-EDITORIAL-QA
建置 / 重建 EPUB	06-EPUB-BUILD
KDP metadata、封面、BISAC	07-PUBLISHING-PREP
KDP 後台填寫、常見錯誤	08-SUBMISSION
全新書籍專案	所有模組
Session 記錄、跨日進度追蹤	coding-worklog/SKILL.md

Parameters（book.yaml 關鍵欄位）

title:            書名
author:           作者全名
language:         語言代碼（en / zh-TW）
epubcheck_jar:    epubcheck.jar 完整路徑
source_file:      Source_Clean_EN.md
output_filename:  輸出檔名（不含 .epub）

Modules

• modules/00-SESSION-SETUP.md — Session 設定、脈絡恢復、Obsidian 日誌模板
• modules/02-DRAFTING.md — 草稿方法論、Tag 概念節點模板、Components/ 規範
• modules/03-OBSIDIAN-TO-DRAFT.md — Obsidian 筆記整合流程
• modules/04-SOURCE-MANAGEMENT.md — Source 文件格式規範
• modules/05-EDITORIAL-QA.md — 排版 QA 框架
• modules/06-EPUB-BUILD.md — EPUB 建置 SOP
• modules/07-PUBLISHING-PREP.md — KDP 出版準備
• modules/08-SUBMISSION.md — 後台提交指引

Checklist Files

• checklists/obsidian-cleanup.md — 整合前草稿清理
• checklists/source-format.md — Source 格式規範核查
• checklists/editorial-qa.md — 編輯品質審查
• checklists/epub-qa.md — EPUB 視覺 QA
• checklists/publishing-prep.md — 出版準備確認
• checklists/kdp-submission.md — KDP 提交完整清單

Templates

• templates/epub_builder.py — EPUB 建置腳本
• templates/build.py — Build pipeline 腳本
• templates/watch_epub.py — 自動預覽 watcher（Windows）
• templates/2_build.bat — 雙擊建置（複製到書籍根目錄）
• templates/3_preview.bat — 雙擊預覽（複製到書籍根目錄）
• templates/book.yaml — 書籍設定檔模板
• templates/kdp-description.md — KDP 書籍描述模板

Sub-Skills

• coding-worklog/SKILL.md — 跨日 Session 追蹤，每次工作告一段落時載入