namenguiin/talk-grill

燒烤問答法

透過提問將演講者腦中的構想引出，並在演講資料夾中製成 brief.md（決策）與 outline.md（場景表格）。建置工作由新的子代理程式僅讀取這兩個檔案與 sources/ 目錄後獨立執行。僅存在於對話中而未寫入檔案的決策，將無法傳遞給建置階段。

演講者最初提供的內容：$ARGUMENTS

工作階段在工具包根目錄下開啟。./talk 指令皆於工具包根目錄下執行。以下提到的 brief.md、talk.json 等名稱均指演講資料夾（talks/<資料夾>/）內的檔案。

0. 確定演講資料夾

1. 執行 ./talk profile 查看演講者資訊。若無，則第一個問題詢問英文姓名與所屬單位。若演講者簡報將以韓文製作，則同時詢問韓文姓名與所屬單位。答案透過 ./talk profile --name "..." --affiliation "..."（必要時加上 --name-ko、--affiliation-ko）儲存。
2. 執行 ./talk brand 查看。若顯示「未設定」，則在建立新演講前用一個問題決定顏色與標誌。方法請見工具包根目錄 AGENTS.md 中的「學校／實驗室顏色與標誌」。若演講者要求直接製作而不提問，則不詢問，直接使用預設主題。
3. 若演講者提到要接續之前的演講，請用 ./talk list 找到對應資料夾。
4. 若是全新演講，需要類型、日期與活動名稱。僅針對演講者未提及的項目，以一個問題提問。接著用 ./talk new <類型> <YYYY-MM-DD> [活動名稱] [--title "..."] [--lang ko] 建立資料夾。類型為 lab、conf、seminar、class、jc。實驗室會議（lab meeting）時活動名稱留空（封面顯示為「Lab meeting, 日期」，當日主題寫入 --topic 或 talk.json 的 topic 欄位）。輸出中顯示的資料夾即為本次演講的資料夾。
5. 若出現缺少 node 工具的錯誤，請執行 ./talk setup 後重試。

1. 提問前先閱讀

1. 讀取演講資料夾中的 talk.json、README.md、brief.md、outline.md。若 brief.md 中已有「燒烤問答記錄」，則從其後繼續。
2. 讀取演講者提供的所有內容與 sources/ 中的檔案。PDF 需分頁閱讀。若演講者提及外部檔案或網頁文件，將其複製到 sources/（網頁則儲存內文為純文字），並在 brief.md 的輸入資料表格中記錄路徑與確認狀態（「僅摘要」、「已確認內文」、「僅圖表」）。使用 cp 複製外部檔案時會出現一次權限詢問，請允許。檔案使用 Write 與 Edit 工具寫入，驗證用腳本放置於演講資料夾的 audit/tmp/ 中（若寫入工具包外的路徑如 /tmp 將會被拒絕）。
3. 若資料已能回答某問題，則不再提問。從資料中找到的答案須在 brief.md 中標註「（來自資料）」並僅請演講者確認。
4. 使用 talk.json 的內容填入 brief.md 的任務章節。各演講類型的基本範本位於工具包根目錄下的 .claude/skills/talk-grill/references/talk-types.md。
5. 僅在演講者明確說出路徑時，才讀取工具包外部的目錄（如家目錄）。讀取外部目錄會觸發權限詢問，使第一個問題延遲。完成上述四個步驟後，立即提出第一個問題。

2. 提問方式

• 每次只問一個問題。選項 2–4 個。將推薦選項放在第一位，並附上一行理由。演講者亦可直接輸入答案。在 Claude Code 中使用 AskUserQuestion 工具提問。若代理程式無此工具，則以相同格式（一行問題、編號選項、第一個為推薦）在對話中提問。
• 問題應簡潔，不要冗長重複先前的答案。
• 收到答案後，立即更新 brief.md。在「燒烤問答記錄」中寫入一行 Qn 問題 → 答案，並據此修改受影響的行（任務、一句話摘要、骨架）。不要同時保留舊決定與新決定。
• 若演講者表示「不知道」或「之後再說」，則將其記錄為開放項目，不再重複提問。
• 若演講者詢問意見，先確認原文，然後選定一個選項，附上一行理由。在 brief.md 中標註為「推薦」。最終決定權在演講者。
• 若演講者的前提與原文不符，先說明哪些部分正確，再指出需修正之處。
• 若演講者改變決定，遵循新的說法。不要追問原因。
• 若演講者要求不經提問直接製作，則根據資料與該演講類型的基本範本填入 brief 與 outline，僅進行批准（第 5 節）。未確定的部分記錄為開放項目。

3. 提問順序

從對建置影響最大的項目開始提問。

1. 場合：活動名稱、演講時間、問答時間、聽眾。由此得出投影片數量預算（參見 talk-types.md）。若投影片語言與 talk.json 不同，則更新 lang。
2. 一句話摘要：聽眾能帶走的一句核心訊息。
3. 骨架：2–4 個章節及其順序。以 talk-types.md 中的基本骨架為起點提出建議。
4. 每個章節的主張、證據（圖表、數據、論文頁碼）、呈現方式（論文原圖、重新繪製的概念圖、按一下逐步動畫的流程圖）。一個章節可多次提問。
5. 開頭與結尾：第一張投影片提出的問題、最後一張投影片（結論、討論問題；若為實驗室會議則包含後續計劃與對指導教授的請求）。
6. 整理開放項目。

共提問 6–10 次後結束。若演講者要求停止，則立即結束。

4. 原文確認

• 投影片中要使用的數字與引用，必須從原文（內文、表格、圖說）確認，並在 brief.md 的「原文確認」中記錄數值、檔案與頁碼。不要僅根據摘要或筆記的總結來使用數字。
• 數字應附上條件（說明該數值來自哪個資料集、設定或子集）。
• 若原文未說明原因，則不要為兩個數字的差異賦予因果關係。
• 若計劃直接使用論文中的圖表，需檢查其授權條款。若為禁止修改的授權（如 CC BY-ND），則改為重新繪製。
• 對於無法取得的原文（如付費論文），在 brief.md 的開放項目中記錄為「演講者需取得的資料」，並在 outline 中將依賴該原文的章節標記為「待確認」。

5. 目錄（outline.md）

• 表格欄位：#、sceneId、範本、標題（一行，10 字以內）、一句話主張、畫面與點擊順序、證據（檔案·頁碼）。
• sceneId 使用英文小寫與數字（例如：motivation、setup、result2）。封面為 title，目錄為 outline，章節開場為 sec01 起跳，結尾為 thanks。
• 投影片數量控制在預算內。每張投影片傳遞一個想法。文字宜少，讓圖表來說明。細節放入備註。
• 「畫面與點擊順序」欄位需說明圖表顯示的內容，以及每次點擊會出現什麼。建置代理程式只會根據此欄位描述的內容來製作。
• 確定的封面資訊寫入 talk.json：title（非實驗室會議時的演講標題）、topic（實驗室會議主題，作為封面強調色的副標題）、event、authors（共同作者：{"name": ..., "name_ko": ...}）、length_min、lang。
• outline 頂部應包含演講資訊行（活動、日期、時間、投影片數量）。批准行留空。

6. 批准與一鍵執行

1. 展示 outline.md 的表格並提問。選項：「照此製作」（推薦）、「有需要修改的地方」。
2. 若有需要修改，修改後再次詢問。
3. 批准後，在 outline.md 的批准行填入當天日期，並將 README.md 的目前狀態更新為「燒烤問答」項目（已確定事項、開放項目）。
4. 移交給建置階段。在 Claude Code 中，使用 Skill 工具呼叫 talk-build，第一個引數為演講資料夾路徑（例如：talks/2026-11-16-lab-meeting）。talk-build 將在新的子代理程式中執行。若代理程式無 Skill 工具，則直接讀取 .claude/skills/talk-build/SKILL.md 並按其指示自行操作。
5. 建置所需時間依投影片數量而定，約十到數十分鐘。完成後簡短向演講者報告結果。接著請演講者查看聯絡單截圖（talks/<資料夾>/audit/contact-sheet.png），並一次說明需要修正之處。