Community生產力與協作github.com

berkekcay/link-shortener-agent-ready

用於實作 docs/TASKS.md 中的功能(自訂別名、點擊計數器、過期時間)或任何其他連結縮短器行為的變更。會先引導你撰寫測試、進行最小變更、執行 pytest,最後提供摘要。

link-shortener-agent-ready 是什麼?

這是一個專為 AI 代理(如 Claude Code、Cursor 或 Codex)設計的技能,用於在連結縮短器專案中實作或修改功能。它的核心目標是確保每一項變更都經過測試驅動開發(TDD)流程:從閱讀 AGENTS.md 和 TASKS.md 開始,然後檢查現有程式碼(main.py 和測試),接著在進行任何編輯前明確寫出計畫。之後,代理會先寫一個會失敗的測試(使用 pytest),再對 main.py 進行最小且精準的修改來讓測試通過,最後執行所有測試確保沒有回歸錯誤。此技能支援自訂別名、點擊計數器和過期時間等功能,並強制要求最終提供結構化的摘要,包含任務描述、行為、變更的檔案、新增的測試、pytest 結果以及剩餘風險,這讓開發者或代理可以清楚追蹤每次迭代的成果。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/berkekcay/link-shortener-agent-ready/tree/HEAD/.claude/skills/implement-task

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

實作連結縮短器任務

請依序執行以下步驟。如果任務不明確,或需要 AGENTS.md 中「詢問人員前」所列的項目,請先暫停並提問。

  1. 閱讀。 開啟 AGENTS.md、docs/TASKS.md 中選擇的任務,以及 tests/AGENTS.md。僅專注於該任務。

  2. 檢查。 閱讀 main.py(資料表、encode()、請求模型與兩個路由)以及 tests/test_main.py。記下任務會互動的任何部分,例如代碼如何產生或資料庫如何在多次執行之間共用。

  3. 說明計畫。 在編輯之前,寫下:

    • 預期的行為,包括成功與每種失敗情況的狀態碼及回應內容;
    • 你將修改的檔案;
    • 邊界情況(空輸入或異常輸入、與現有代碼衝突、重複的值)。
  4. 撰寫一個會失敗的測試。 在 tests/test_main.py 中,依照 tests/AGENTS.md 新增行為測試:至少一個成功案例和一個失敗案例。執行測試並確認它們因正確的原因(功能尚未實作,而非打字錯誤)而失敗:

    pytest tests/test_main.py -k <新增的測試名稱>
    
  5. 實作最小的變更,在 main.py 中進行,使測試通過。保持現有行為與回應結構不變。如果資料表需要新增欄位,請確保現有的 links.db 仍可運作(或說明為何必須重建)。

  6. 執行所有測試。

    pytest
    

    所有原始與新增的測試都必須通過。修正並重新執行,直到全部通過。

  7. 摘要,格式如下:

    Task:
    Behavior:
    Files changed:
    Tests added:
    pytest result:
    Remaining risks:
    

相關技能