リンク短縮タスク実装エージェント

カスタムエイリアス、クリックカウンター、有効期限など、docs/TASKS.md に記載されたリンク短縮機能の実装や変更を指示に従って進めます。テスト駆動、最小限の変更、pytest の実行、サマリーの生成を自動化します。

リンク短縮タスク実装エージェント とは?

このスキルは、リンク短縮アプリケーションの機能実装や動作変更を、決められた手順に従って自動化するエージェント用スキルです。開発者は `docs/TASKS.md` からタスクを選択し、エージェントが `AGENTS.md` やテストファイルの指示を読み込み、テストを先に書き(レッド)、最小限のコード変更でテストをパス(グリーン)させ、最後に pytest を全件実行してリファクタリングする、いわゆる「テスト駆動開発(TDD)」のサイクルを忠実に実行します。対応プラットフォームは主に Claude Code や Codex などのターミナルベースの AI エージェントを想定しています。このスキルを使うことで、開発者はエイリアスの重複や空入力などのエッジケースを考慮した堅牢な実装を、一貫した品質で迅速に進めることができます。

対応~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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

リンク短縮タスクを実装する

以下の手順を順に実行してください。タスクが不明瞭な場合や、AGENTS.md の「事前に人に確認すること」に該当する項目がある場合は、作業を中断して質問してください。

  1. 読み取り。 AGENTS.md、選択したタスク (docs/TASKS.md 内)、および tests/AGENTS.md を開きます。指定された1つのタスクのみに取り組んでください。

  2. 調査。 main.py(テーブル、encode()、リクエストモデル、両方のルート)と tests/test_main.py を読みます。タスクが操作する箇所(例:コードの生成方法、データベースが実行間でどのように共有されるか)に注意してください。

  3. 計画を述べる。 編集を開始する前に、以下の内容を書き出してください。

    • 期待される動作(成功時および各失敗時のステータスコードとレスポンスボディを含む)。
    • 変更するファイル。
    • エッジケース(空入力や異常な入力、既存コードとの衝突、値の繰り返しなど)。
  4. 失敗するテストを書く。 tests/AGENTS.md に従い、tests/test_main.py に振る舞いテストを追加します。少なくとも1つの成功ケースと1つの失敗ケースを含めてください。テストを実行し、正しい理由(機能が未実装であること、タイポではないこと)で失敗することを確認します。

    pytest tests/test_main.py -k <新しいテスト名>
    
  5. 最小限の変更 を main.py に加え、テストが通るようにします。既存の動作とレスポンス構造は維持してください。テーブルに新しいカラムが必要な場合は、既存の links.db が引き続き動作するように追加するか(あるいは再作成が必要な理由を説明してください)。

  6. すべてを実行する。

    pytest
    

    元のテストと新しいテストのすべてがパスしなければなりません。パスするまで修正と再実行を繰り返します。

  7. 以下の形式でサマリーを出力します。

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

関連スキル