讀時間： 約 9 分鐘 · 系列： 分析師實踐 · 上一步： Quick vs Project · 下一步： SQL-first 或跟做 USER_GUIDE §2
全流程一覽
接題 → 探索 schema → 草擬 Plan → （必要時短問答對齊口徑）→ 你批註修訂 → 你按 Execute
→ Agent 逐步 SQL → Report（含數字 + limitations）→ 可 HTML / follow-up Plan
對照 USER_GUIDE 五階段表：你在 2–3 階段控口徑，在 4 階段授權取數，在 5 階段驗收交付。聊天若切成 Ask，Agent 仍可解釋與跑查詢，但不會改 Plan／Report／HTML——要改檔請切回 Agent（USER_GUIDE §12.1.1）。
雙螢幕或寬螢幕時，可在 Execute 與 Report 驗收階段用 Compare view 並列唯讀對照（見下文與 USER_GUIDE §11.10）。
階段 1–2：接題與探索
你做什麼：
- 在 AI 面板用自然語言說清楚：分析目標、時間範圍、分母直覺（若已有）
- 若 Agent 用互動問題追問，補齊再往下走
- 確認 Agent 先查表結構，而不是憑空假設欄位名
Agent 做什麼：
- 看可用表、grain、join key、明顯體質問題
- 開始寫 Plan 草稿（尚未 Execute）
- 若分母、篩選邊界等仍未寫死：用對話一次一題對齊（附建議答案），確認後寫回 Plan，再請你審閱——不是一次丟一長串澄清題。可查表結構的事實應自己查完再問決策。見 USER_GUIDE §2.5。
狀態列： Project Focused 或 Planning。
分析師要點： 這階段可以快，但 Plan 裡應開始出現 stage 定義、分母、checkpoint——不是只有「我們來分析一下漏斗」。
階段 3：審 Plan、留批註（Execute 前）
Plan 裡你至少該看到：
- 分析目標
- 各 stage / 指標定義
- 分母（denominator） 與 粒度（grain）
- 驗證 checkpoint（例如最大流失段、NULL 檢查）
口徑不對時：
- Visual 模式選取段落 → 批註
- 或對話說明，但重要共識仍建議落在 Plan 批註
- 多條批註可用 Resolve (N) 一次處理（
N為 sidecar 中 open 批註數）
Agent 只改被批註段落，避免整份重寫把沒問題的段落也改壞。Resolve 後可用 View changes 對照；已處理批註可 Archive 清面板。若正文大改導致 錨點失效，需 Re-anchor 重新反白原文。
分析方向若大轉折（換指標、換群體），Agent 也可能先短問答對齊新口徑，再改 Plan——與草案後對齊同一節奏。
鐵律：Planning 階段不要按 Execute。 Agent 也不會在對話裡假裝你已批准而偷跑正式取數。口徑未定就 Execute，等於把爭議留到 Report 才爆。專案尚無 Plan 檔時，Agent 在 Planning 可用 add_plan 建立新 Plan。
本輪 Agent 動了哪些檔？（檔案變更條）
Agent 依批註 patch_plan、Execute 時連續建 SQL tab、或產出 Report 時，你可能要展開好幾個 Tool Call 才知道動了什麼。每則 AI 回覆結束後，若該回合有寫入持久 SQL、Plan、Report 或 HTML Report，訊息底部會出現檔案變更條：每列一個檔案、綠 +N 紅 -N 行數統計，點檔名可開啟對應分頁。
發現 patch 錯了、或 Execute 中某步 SQL 寫壞？在該則回覆的列上點 Undo，可把該檔一次還原到這則回覆開始前（同一則內對同一檔多次修改會合併統計）。若你已在 Agent 寫入後手動改過正文，撤回會被阻擋——改用手動還原或再請 Agent 修。完整限制（新建檔清空不刪、add_report 與 Plan Executed 等）見 USER_GUIDE §12.14。
階段 4：Execute——只有你按
審完 Plan 後，在 Plan 工具列點 Approve & Execute：
- Plan → Executing（正文唯讀）
- 系統自動通知 Agent 開始（你不必手打「開始執行」）
- Agent 問 前台 / 混合（僅二選一；後台代理分析僅 Quick Analysis 提供；只問一次）
- Pipeline Stages 所列階段一律建立 SQL 分頁；混合模式下其餘步驟多在對話
run_query - Progress 面板可看 Todo 與查詢步驟；有更新時紅點提示
執行中你可以：
- 盯 SQL 分頁（前台模式）
- 看中斷後用 Continue 續跑（不必回 Planning 重來）
- 在 AI 回覆底部的檔案變更條核對本輪新建／修改了哪些 tab 與 Report，必要時 Undo 撤回單則寫入（見上文）
如果資料不可用、口徑或決策前提已改變，請選 Stop & Replan…，不要把未完成的 Plan 標成完成。你需要填寫停止原因與目前部分成果；舊 Plan 會以 Stopped 保留 Progress 與正式 evidence。可立即讓 Agent 草擬替代 Plan，或稍後從 Stopped Plan 的 New Plan 重新開始。替代 Plan 是新的 Planning artifact，仍須重新審閱並由你按 Execute。
Agent 不能代替你按 Execute；並且進入 Executing 的 Plan 不可以再次編輯，這是為了保證「契約簽核」的永遠可靠。
若 SQL 過長或過複雜，Agent 可能被要求拆成較小步驟——方便你逐步審查，不是為了形式而形式。
用 Compare view 對照 Plan（建議場景）
Execute 時主視窗常在 SQL 分頁與 Progress 之間切換，口徑卻寫在 Plan 裡。典型做法：
- 對 Plan 右鍵 → Open in compare view → New compare view（或選已開的 Compare view 1）。
- 將 Compare view 拖到副屏（或螢幕另一半）；主視窗保留 SQL / Agent。
- Compare view 內 Plan 為唯讀；主視窗若仍開著同一 Plan 分頁，編輯會即時鏡像到 Compare view（未存檔時 compare tab 旁會出現 Info 提示）。
亦可把持久 SQL 分頁開入同一 Compare view，與 Plan 並列（最多 5 個 tab），方便對照「契約寫什麼」與「SQL 實際怎麼寫」。臨時 SQL 分頁不支援開啟。持久 SQL 在 Compare view 內跟隨深／淺色主題；有查詢結果或錯誤時，SQL 與結果區可拖曳分割高度。
注意： Compare view 不能 Run SQL、不能改 Plan；一切編輯留在主視窗。Reference 分頁在 Compare view 以琥珀色 md 標記，與 Plan（藍）、Report（綠）一致。
階段 5：Report 驗收
Execute 完成後，專案內會有一份 Report（通常與 Plan 一對一配對）。正式收尾是新增 Report：Executing 期間不會用改寫舊 Report 來結案。
合格的漏斗類 Report 應有：
- 各 stage 定義與分母說明
- 具體數字（counts / rates），不是只有「某階段流失嚴重」
- limitations——資料答不了什麼、口徑假設、相關≠因果
Report 可批註修訂、可 HTML Report 匯出分享（週會對外、對方不必裝 Lantide）。若要讓同事在 Lantide 內批註 Plan、延續同一專案，用 Export project… 打包 .lantide（共享分析脈絡與結果；不含 SQL 分頁與本機資料）——見 USER_GUIDE §11.1.0。若要交接整個工作區（含 SQL 分頁、連線設定），用 Workspace 匯出。若要深挖下一題，在同一專案新建 Plan 迭代即可。
Analysis Lineage： 從 Plan 或 Report 工具列開啟，可看到 Plan → Markdown Report → HTML Report 的可視化脈絡。它顯示哪些 Plan 是正式 evidence、哪些只提供歷史背景，以及鏈結是否完整；點選節點可直接開檔。這是驗收時回看交付物關係的工具，不會把未儲存修改或模糊的手動關聯偽裝成已驗證證據。
用 Compare view 驗收 Report vs Plan
驗收時常要對：Report 數字是否覆蓋 Plan 裡的 checkpoint、stage 定義是否一致。
- 主視窗開啟 Report 繼續批註或微調。若 Report 已與 Plan 配對，可在 View options 點 Linked plan: … 直接開啟來源 Plan；未配對時可用 Link source plan 選擇同專案尚未配對的 Plan。
- 需要並列對照時，對同專案 Plan（側邊欄或已開分頁）右鍵 → Open in compare view，與 Report 並列。
- 在 Compare view 內切換 compare tab，對照口徑段落與數字表格。
- 若磁碟上 Plan 已被外部更新而 Compare view 顯示較舊，tab 旁 Info 會提示；點 Refresh 從磁碟重載。
已 Executed 的 Plan 也會在 View options 顯示 Linked report: …，或在尚未配對時提供 Link generated report。手動配對只補上 Plan / Report 關聯，不會把 Plan 標成 Executed、凍結 steps 或完成 Todo；正式執行仍須走 Approve & Execute。
若這輪由外部 Agent 協作
驗收標準不因對話介面改變：仍要核對 Plan、正式 SQL evidence、Report 與 limitations。額外打開 External MCP Activity，確認實際修改的 artifact、+N/-N 與開啟動作符合預期；可安全回退的單次內容變更會提供 Undo，若檔案已被後續修改則會阻擋，不會強制覆寫。
外部 connection 的 mode 是能力上限，不等於 Plan 已被核准。
- Execute 雙開：正式分析仍須在 Lantide 按 Approve & Execute（或經 GUI review 流程）。
- Admin 單開（進階）：當下審閱可在外部對話完成；你明確確認執行後，外部 Agent 可呼叫
claim_plan_approved將 Plan 推進為 Executing——效果等同 Approve，但之後正式 SQL 仍須帶execution_plan_ref才寫入 Steps。
連線選擇、Activity 與回復方式見 外部 Agent Integration；完整操作見 USER_GUIDE §13.8。
分析師常見問題
Q：能不能跳過 Plan 直接叫 Agent 跑 SQL？ 在 Quick 可以探索性跑；在 Project 正式交付應走 Plan → Execute，否則週會追問時缺契約。
Q：Execute 後發現 Plan 錯了？ 若尚在執行中且前提已變，使用 Stop & Replan 保留部分成果並開替代 Plan；Executed 後 Plan 正文鎖定，大改通常 新 Plan。小修 Report 可用批註（依狀態，見 USER_GUIDE §11.6）。
Q：Planning 時 Agent 會跑統計檢定嗎？ Planning 階段以探索與修 Plan 為主；正式統計在 Execute 後、且 Agent 會先跟你確認參數（見 統計分析工具）。
Q：Compare view 裡能改批註嗎？ 不能。批註卡片僅供閱讀與 hover 對照；View changes 可檢視已 Resolve 批註的修改對照。新增／編輯批註、Re-anchor 請回主視窗。
Q：Compare view 裡錨點失效的批註怎麼看？ Compare view 會顯示 錨點失效（與主視窗 Anchor outdated 同義）的卡片與 metadata，但不能 Re-anchor——請回主視窗處理。
Q：關掉主視窗某個 SQL 分頁，Compare view 還看得到嗎？ 可以。Compare view 會保留關閉當下的內容快照，仍可唯讀對照；需要最新結果時在 Compare view 點 Refresh。