auto_generate_tests
Analyze a URL to detect modules and automatically generate pytest test skeletons for each module. Returns generated file paths and test counts, with optional plan verification integration.
Instructions
一鍵交付：在內部依序做 analyze_url → 為每個偵測到的 module 用 candidate_tcs 內容各跑一次 generate_test，把整套 pytest 測試骨架寫進 PROJECT_ROOT/tests/。等同於『analyze_url 後對每個 module 手動跑 N 次 generate_test』的自動化版本，適合「給我一個 URL、其他你看著辦」這種快速覆蓋場景。每條 candidate_tc 變成對應 test 函式的 docstring，run_tests 跑完 HTML 報告會用 docstring 當 case 名稱顯示。回傳產生的檔案路徑列表 + 每個 module 對應幾個 test。預設每個 module 1 條，想要更密的覆蓋拉 tests_per_module。
Plan bookend (v0.10.0): pass plan_id from a prior qa_plan call and the response auto-attaches plan_verification. Each generated test record (or generation failure) becomes an evidence row with kind=generated_test, path, covers_module (form/cta/nav/etc.), module_name, error (None on success), and source url. CPs can assert coverage ("form module produced ≥1 test") or failure-mode invariants ("no module had generation errors").
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 要分析並批次產測的 URL，需含 protocol（http:// 或 https://）。 | |
| timeout_ms | No | 選填，analyze_url 內部 page.goto 等 DOMContentLoaded 的逾時毫秒。預設 15000，慢站可拉到 30000+。 | |
| auth_cookie | No | 選填，登入後分析所需 cookie，格式：`name1=value1; name2=value2`。從 DevTools / Application / Cookies 抓現成值貼進來。 | |
| tests_per_module | No | 選填，每個 module 從 candidate_tcs 取前 N 條各產一條 test。1-10，預設 1（最少噪音）。想要更密的覆蓋拉 3-5；拉到 10 通常會產 garbage tests，因為 candidate_tcs 後段是泛例。 | |
| plan_id | No | 選填，v0.10.0+. Plan id returned by qa_plan. When supplied, the response gains a `plan_verification` envelope. Each generated test record (success or failure) becomes one evidence row with kind=generated_test, path, covers_module, module_name, error (None on success), and source url. |