使用此工作流程從 Meticulous 取得結構化的工作階段資料 — 涵蓋你程式碼變更的錄製使用者流程與網路模擬資料。

開始前，請先執行 meticulous-cli-update 技能以確保 Meticulous CLI 為最新版本 — 除非此對話中已執行過，則可跳過。

步驟 1 — 找出相關工作階段並下載其資料

在 git 儲存庫根目錄執行以下指令：

meticulous local relevant-sessions --format=multi-file --minimum-times-to-cover-each-line=1

這將會：

識別哪些錄製的工作階段涵蓋了你目前分支上變更的程式碼路徑。
將每個工作階段的資料以結構化目錄樹下載到 .meticulous/sessions/。

選項：

選項	類型	預設值	說明
`--format`	`multi-file`	—	設為 `multi-file` 可將每個相關工作階段的資料下載為結構化目錄樹
`--minimum-times-to-cover-each-line`	number	—	選取至少這麼多工作階段來涵蓋每一行編輯過的程式碼，當有更多候選時選擇最多樣化的子集
`--include-superfluous-sessions`	boolean	`false`	同時包含那些確實測試了某些變更，但相對於 `--minimum-times-to-cover-each-line` 而言是多餘的工作階段
`--outputDir`	string	`.meticulous/sessions`	multi-file 格式的輸出目錄
`--showMaybeRelevant`	boolean	`false`	同時顯示可能受影響的工作階段
`--startingPointSha`	string	—	僅考慮自此 commit SHA 以來的變更

步驟 2 — 了解輸出結構

下載的資料組織如下：

.meticulous/sessions/
  manifest.json                       # 所有工作階段的清單與摘要中繼資料
  sessions/
    <sanitized-session-id>/           # 工作階段 ID 中的特殊字元已替換以符合檔案系統安全
      summary.json                    # 工作階段概覽：URL、視窗大小、持續時間、事件數量
      user-events.json                # 使用者互動序列（點擊、輸入、導航）
      network-requests/
        summary.json                  # 所有網路請求：方法、URL、狀態（不含主體）
        <order>.json                  # 個別請求/回應配對（含主體）
      storage/
        cookies.json                  # 初始 cookie 狀態
        local-storage.json            # 初始 localStorage 狀態
        session-storage.json          # 初始 sessionStorage（若有）
        indexed-db.json               # 初始 IndexedDB（若有）
      url-history.json                # 頁面導航歷史與時間戳
      context.json                    # 功能開關、使用者 ID、自訂上下文（若有）
      websockets/                     # WebSocket 資料（若有）
        summary.json                  # WebSocket 連線概覽
        <connection-id>.json          # 每個連線的事件

步驟 3 — 瀏覽資料

從 manifest.json 開始 查看所有可用的工作階段。每個條目包含工作階段 ID、起始 URL、事件數量、持續時間和網路請求數量。選取與你任務相關的工作階段。
讀取工作階段目錄內的 summary.json 以快速了解該工作階段 — 起始 URL、視窗大小、總持續時間和事件數量。
讀取 user-events.json 以了解使用者流程。每個事件包含：
- type：互動類型（例如 click、input、scroll）
- selector：目標元素的 CSS 選擇器
- timestampMs：事件發生的時間
- coordinates：點擊位置（若適用）
瀏覽 network-requests/summary.json 以查看工作階段期間發出的所有 API 呼叫。每個條目顯示 HTTP 方法、URL、狀態碼、內容類型和回應時間 — 不含回應主體，因此可快速掃描。
讀取個別 network-requests/<order>.json 檔案 以取得特定 API 呼叫的完整請求/回應資料。將這些作為撰寫測試時的模擬資料。摘要中的 order 欄位對應於檔案名稱。
檢查 storage/ 檔案 若你需要了解初始應用程式狀態（cookie、localStorage 等）。

步驟 4 — 使用資料進行測試

常見使用案例：

了解使用者流程

讀取 user-events.json 以查看使用者互動的確切順序。這告訴你使用者點擊了什麼、輸入了什麼以及導航到哪裡，幫助你了解程式碼變更需要支援什麼。

建立網路模擬資料

使用網路請求檔案為你的測試建立模擬回應：

讀取 network-requests/summary.json 以找到相關的 API 端點。
讀取個別 network-requests/<order>.json 檔案以取得完整的請求/回應配對。
使用 response.content.text 欄位作為測試中的模擬回應資料。

驗證涵蓋範圍

交叉比對使用者事件和網路請求與你的程式碼變更，以驗證工作階段涵蓋了你修改的程式碼路徑。

替代方案：下載特定工作階段

如果你已經知道需要哪些工作階段 ID，可以直接下載：

meticulous download session --sessionId=<id> --format=multi-file

預設寫入 .meticulous/sessions/。使用 --outputDir 變更輸出位置。

MCP 工具：get_session_data 會將相同的結構化工作階段資料內嵌回傳（而非寫入磁碟），適用於連線到 Meticulous MCP 伺服器的客戶端。

最後步驟 — 向 Meticulous 回報意見回饋

使用完工作階段資料後，向 Meticulous 團隊提交一則簡短的意見回饋：工作階段資料是否涵蓋了你需要的流程，缺少哪些資訊或哪些資訊能讓任務更輕鬆？

meticulous agent submit-feedback --message="<一兩句話>" --outcome=<helped|neutral|hindered> --skill=meticulous-use-session-data

MCP 工具：submit_feedback。

meticulous-use-session-data

相關技能