notebooklm-course-builderlisted
Install: claude install-skill hmj1026/notebooklm-course-builder
# NotebookLM Course Builder
把課程大綱轉成一套有來源、可驗收、可持續推進的 NotebookLM 教材。代理負責規劃、產生短版 Prompt、判讀結果與守住品質關卡;可用的瀏覽器工具負責介面操作,使用者透過少量結構化關卡保留來源 Import 與 Module 定稿決定。
## 啟動路由
除非使用者指定手動嚮導,先解析本 `SKILL.md` 所在目錄並執行其中的 `node scripts/detect-browser-tools.mjs --json`。Node 不存在、腳本失敗或輸出無法解析時 fail closed 至 guided mode:
- `mode=auto`:完整讀取 [references/automation.md](references/automation.md),載入所選瀏覽器工具的技能指引,依其中的 Run 授權、動作迴圈與兩個批次關卡執行。
- `mode=guided`:使用本檔的手動嚮導。若宿主提供結構��問題工具,讓使用者選擇安裝 `agent-browser`、安裝 `playwright-cli` 或繼續手動;否則用一個簡短問題詢問。
- 使用者明確指定 adapter 時仍先驗證該工具;不可用時依 `agent-browser → playwright-cli → guided` 降級。
當 `node.ready=false`、Node 指令不存在,或使用者要求建置自動環境時,完整讀取 [docs/browser-automation-setup.md](docs/browser-automation-setup.md),一次只引導其中一個安裝或驗證步驟。每步取得可觀測完成結果後再繼續;安裝工具前仍需使用者明確確認。
瀏覽器登入、Notebook 寫入與狀態更新需要每次 Run 的一次性確認。Run 授權只涵蓋已命名的課程與 Notebook,不跨 `/resume` 或新對話沿用。
## 互動契約
- Guided mode 每次只推進一個可完成的步驟;auto mode 可連續推進已通過可觀測完成判準的步驟,只在批次關卡、例外關卡或完成時回報。
- Guided mode 的回覆只包含:目前目標、NotebookLM 精確操作位置(依左側來源/中間對話/右側工作室面板)、這一步要貼的單一短 Prompt 或單一審核表、完成判準、使用者回傳格式。完整介面與按鈕對照請參閱 [references/notebooklm-ui-guide.md](references/notebooklm-ui-guide.md)。
- 已有足夠資訊時直接產生當前步驟;只有會改變課程結構、來源取捨或教材邊界的缺失才詢問。
- Auto mode 由代理讀取頁面結果與擷取必要截圖;使用者只處理 Run 啟動、來源匯入、Module 定稿與例外關卡。Guided mode 才要求使用者貼回結果。
- 介面名稱或位置以使用者實際畫面為準。看不清狀態時請使用者提供目前畫面;依使用者實際可見的按鈕操作。
- 使用者若只回覆「完成」「下一步」或一張截圖,先依目前狀態判斷結果,不重新開始流程。
- 預設以繁體中文協作;依使用者要求切換教材語言。技術術語第一次出現時可保留英文。
## 不可混淆的 NotebookLM 物件
始終區分三種物件:
1. **Course Outline Source**:大綱本身,透過新增來源或貼上文字加入 Notebook,會成為 Source。
2.