PPT轉圖文筆記 是做什麼的？
供Codex及具備相應工具的OpenAI智能體讀取的工作流程技能。以課件主線製作通俗易懂、多圖、精煉而有解釋深度的學習筆記，按使用者選擇的格式或筆記應用交付。本技能不是獨立PPT轉換程式，也不為普通聊天模型提供原本沒有的檔案、作圖或上傳能力。
開始與恢復
讀取當前用戶要求、專案約定和已有進度。明確來源課件、讀者基礎、包含／排除章節、輸出目錄、目標格式、協作方式和審查步驟；已知資訊不重複詢問。沒有指定筆記應用時預設標準Markdown＋圖片目錄，不指定個人電腦磁碟代號或預設上傳任何雲端服務。
先檢查宿主能否讀取和渲染課件、生成或查看圖片、製作交付檔案。所需能力缺失時說明具體限制，完成可驗證的部分，不假裝已運行工具。準備範圍方案後先提供用戶檢查機會。
分工與逐步審查
總主控親自制定總體大綱，小主控親自制定本章／本部分提綱，執行層只按審定提綱執行製作。 總綱確定章節劃分、順序、範圍與學習目標；章綱落實知識節點、講解順序、重點和配圖方案。不得將提綱整體起草任務交給執行層，再以主控審核代替主控制定。
總體大綱由總控制定並自檢、展示；章節提綱由對應小主控制定並交總控複查。兩類規劃成果均按本步使用者檢查規則放行後才進入下一步。製作階段才採用執行層製作 → 小主控審查與返工 → 總控複查。執行層發現提綱缺口或技術錯誤時報告依據和建議，由小主控修訂章綱；涉及整體結構或跨章範圍時交總控決定，審定並獲本步放行後再執行。執行層可在既定框架內選擇措辭、作圖提示詞和排版等細節，不得自行增刪或重排教學結構。
開始時按工作流程與角色選擇目前環境可實現的協作方式：用戶明確授權且宿主支援時，每章新建獨立的小主控和執行層常規對話；用戶要求嚴格獨立對話而工具不支援時，先說明限制，不用內部代理冒充。用戶未要求獨立對話時，可以在目前對話分階段執行和複查，仍須區分規劃與製作職責，誠實說明審查獨立性。不要為使用本技能默默建立或發送其他對話。
預設每個小步驟經總控審查後，展示實際成果和結論，詢問用戶是否要檢查，再等待明確答覆。 使用者說「不用檢查／繼續」僅放行目前一步；使用者要檢查則等待檢查意見與明確繼續。沉默、逾時或下級完成都不放行。使用者明確指定一章或全程自主推進時，記錄其適用範圍並按目前指令執行。
小步驟按可審查成果預先劃分：總控的總體大綱與範圍、小主控的章節提綱與配圖方案、執行層的配圖成品與圖文正文、打包校驗以及使用者選擇的平臺匯入。每個階段明確制定人或製作人。總控不通過時也先給用戶檢查機會，再安排返工。等待期間不提前派發下一步或建立下一章角色；收到回饋後審視實物，不頻繁輪詢或催辦。
內容與教學圖
- 按章節和原頁序讀取PPT。使用宿主提供的課件解析／渲染工具；若有
presentations:Presentations等相關技能，按其流程操作。查看圖表、公式、截圖及必要備註，不能把文字提取當作視覺核對。原始素材提取一次，各章只讀共享。 - 小主控在章節提綱中確定原頁碼到知識節點的覆蓋關係、講解重點與拓展範圍。執行層按審定提綱解釋概念、原理、原因、操作、適用條件和易錯點，先講直白含義，首次出現的術語就近說明；公式與代碼說明含義和用途。例子來自目前課件與目前專案，不照搬其他專案的章節名稱、特定物件或背景。
- 小主控按內容與教學圖標準檢查核心難點，制定配圖方案和清單。執行層按審定方案實際生成、儲存和自檢圖片，不承擔配圖教學結構設計。圖形有助於解釋結構、流向、過程、時序、狀態或差異時，方案預設安排實際呼叫可用的GPT圖像生成功能；使用者明確指定其他作圖方式時遵從其選擇。採用既有圖時，方案指出具體圖及其如何充分解釋目前問題。
- 按目前難點選擇知識總覽、原理示意、連續步驟、方式對比、正誤對照或應用場景圖。原圖過密時，保留原圖並另製簡化教學版。圖片與正文共同講解讀圖順序、機制和邊界，以實際教學效果驗收，不規定固定圖數或生成圖比例。
- 呼叫圖像工具前核對事實，說明讀者、教學目標、佈局、準確標註及不可改變的條件。環境有
imagegen技能時遵循其工具流程；只承諾宿主實際可用的能力，不默默切換需額外授權或費用的API。使用者指定的模型版本僅在實際工具能夠配置並確認時記錄為已使用。 - 逐圖核對文字、關係、方向、狀態、數值、公式與單位。儲存提示詞、工具返回、來源圖及檔案指紋。來源、生成圖和實測結果明確區分，計畫生成不算已生成。關鍵事實查目前一手資料並在相關節點給直接連結，勘誤與拓展區別於課件原內容。
輸出與原課件附件
按輸出格式與校驗選擇格式：
- 預設：標準Markdown與同包的相對路徑圖片，移動或分享時一起交付。
- 需要離線單檔案閱讀時：自包含HTML；檢查實際瀏覽器中的圖片、目錄、窄螢幕和長內容。
- 指定某筆記應用時：先驗證該應用的樣本，再生成平臺適配副本；不把某平臺成功經驗推廣到其他平臺。
- 明確選用幕布時：再讀幕布適配，使用經目前樣本確認的PNG內嵌方式。幕布是可選適配，不是預設目標。
保留每章來源課件及頁碼對應關係。對應原始PPT作為交付包內附件，或上傳到使用者選定且支援附件的平臺；合併課件按原始頁碼提取本章，單章課件直接使用原始檔案，保留內容、頁序和所需資源。不把原始課件、截圖或個人製作成果隨本技能發佈到程式碼儲存庫。
只有在使用者已授權目標位置和操作時才執行外部匯入／上傳；否則交付本地檔案並明確待匯入／待上傳。平臺不支援PPT附件或無法保真切分時說明限制，提供可開啟的原始檔案與頁碼範圍，不能偽稱附件已上傳或已切分。已有遠端內容不默默刪除或替換。
可選PNG工具
scripts/圖片內嵌工具.py 依賴Python 3.10及以上與Pillow，僅將受限Markdown佔位元轉為PNG Data URI並比對，不解析PPT、不生成教學圖或HTML、不執行平臺上傳。只在目標格式確實支援內嵌圖時使用；普通Markdown預設不需要它。
python <技能目錄>/scripts/圖片內嵌工具.py embed --input 正文.md --images 圖片 --output 內嵌筆記.md --manifest 圖片清單.json
python <技能目錄>/scripts/圖片內嵌工具.py verify --input 內嵌筆記.md --manifest 圖片清單.json
正文佔位元為 [[圖片:過程講解.png|目前知識點的關鍵步驟與關係]]。輸出父目錄先建立，已有檔案不會被覆蓋。命令中的佔位路徑應換為本機實際路徑。清單包含本地來源檔案絕對路徑，只作本地複驗使用，公開分享前檢查與清理。
驗收與交接
審查實際檔案、來源頁碼、教學深度與可理解性、圖片及其生成證據、必要的計算／程式碼檢查、所選格式和原課件附件。報告哪些是全面、抽樣或未執行；本地校驗、平臺匯入和實際硬體測試分別記錄，不互相替代。
工作目錄記錄範圍、目前步驟、角色與授權、檔案指紋、問題及返工、使用者本次答覆、匯入狀態與下一動作。恢復先核對目前已授權工作和等待放行的下一步，不補寫許可。學習正文只呈現知識、圖註、必要示例和來源，過程日誌單獨歸檔。最終提供使用者指定位置的學習入口與清楚的待辦事項。