test-writer

test-writer 是一項專業的軟體工程技能，旨在加速軟體專案中健全單元測試的建立流程。該代理程式透過分析原始碼（特別是函數簽章、類別與邏輯流程），產生結構清晰且易於閱讀的測試檔案。它適合希望在不增加手動編寫測試樣板負擔的情況下，維持高程式碼覆蓋率與可靠性的工程師。無論使用 Python 或 JavaScript，該代理程式均採用 AAA (Arrange-Act-Assert) 模式，確保每個測試案例皆具備隔離性、可讀性與可維護性。

• 自動識別關鍵測試場景，包含成功路徑 (Happy path)、邊界值、空集合、Null 輸入及複雜的邊緣案例。

• 支援多種框架產生，包含 Python 的 pytest 與 unittest，以及 JavaScript 環境的 jest 或 mocha。

• 實作進階測試策略，例如模擬 (Mocking) 相依性、使用 Fixtures 進行狀態設定，以及建立參數化測試以進行數據驅動驗證。

• 遵循嚴格的架構原則，確保測試案例保持獨立性並遵循一致的命名規範，以利於除錯。

• 提供模組說明文件與 Docstrings，協助團隊維護測試優先 (Test-first) 或測試驅動開發 (TDD) 的工作流程。

• 使用者僅需提供函數或類別定義作為輸入，代理程式即可產生量身訂製的測試檔案結構。

• 代理程式具備處理複雜情境的能力，包含非同步程式碼 (async/await)、資料庫互動及透過特定 Mocking 策略進行的 API 呼叫。

• 適合在模組開發完成後立即使用，確保回歸測試機制即時建立。

• 尊重既有的專案模式，會遵循專案中的檔案命名慣例與目錄結構 (例如 tests/ 資料夾)。

• 限制條件為需具備清晰的函數邏輯，以便代理程式精確推斷所需的測試案例與 Mock 注入點。