實作連結縮短器任務
請依序執行以下步驟。如果任務不明確,或需要 AGENTS.md 中「詢問人員前」所列的項目,請先暫停並提問。
-
閱讀。 開啟
AGENTS.md、docs/TASKS.md中選擇的任務,以及tests/AGENTS.md。僅專注於該任務。 -
檢查。 閱讀
main.py(資料表、encode()、請求模型與兩個路由)以及tests/test_main.py。記下任務會互動的任何部分,例如代碼如何產生或資料庫如何在多次執行之間共用。 -
說明計畫。 在編輯之前,寫下:
- 預期的行為,包括成功與每種失敗情況的狀態碼及回應內容;
- 你將修改的檔案;
- 邊界情況(空輸入或異常輸入、與現有代碼衝突、重複的值)。
-
撰寫一個會失敗的測試。 在
tests/test_main.py中,依照tests/AGENTS.md新增行為測試:至少一個成功案例和一個失敗案例。執行測試並確認它們因正確的原因(功能尚未實作,而非打字錯誤)而失敗:pytest tests/test_main.py -k <新增的測試名稱> -
實作最小的變更,在
main.py中進行,使測試通過。保持現有行為與回應結構不變。如果資料表需要新增欄位,請確保現有的links.db仍可運作(或說明為何必須重建)。 -
執行所有測試。
pytest所有原始與新增的測試都必須通過。修正並重新執行,直到全部通過。
-
摘要,格式如下:
Task: Behavior: Files changed: Tests added: pytest result: Remaining risks: