/ ディレクトリ / プレイグラウンド / agent-skill-tdd
● コミュニティ Shelpuk-AI-Technology-Consulting ⚡ 即起動

agent-skill-tdd

作者 Shelpuk-AI-Technology-Consulting · Shelpuk-AI-Technology-Consulting/agent-skill-tdd

AIコーディングエージェントに要件定義ファースト・テストファーストの規律を強制する6ステップワークフロー — Serena + 要件ドキュメント + Lad MCPデザインレビュー + TDD + ピアレビュー。

コーディングエージェント向けの規律スキルです。Serenaによるセマンティックなコードナビゲーションを有効化し、変更前の調査を強制し、明示的な要件確認を求め、タイムスタンプ付きの.requirements/ドキュメント(As-Is/To-Be/受入条件)を作成し、Lad MCPサーバーでアーキテクチャを検証した上で、変更ごとのピアレビューを伴う厳格なTDDを実行します。品質が15〜20%向上するとされています。Claude Code、Codex、Cursor、Windsurf、Antigravityに対応しています。

なぜ使うのか

主な機能

ライブデモ

実際の動作

agent-skill-tdd-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-skill-tdd-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-skill-tdd-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
        "~/.claude/skills/agent-skill-tdd"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-skill-tdd-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd",
          "~/.claude/skills/agent-skill-tdd"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add agent-skill-tdd-skill -- git clone https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd ~/.claude/skills/agent-skill-tdd

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: agent-skill-tdd

完全なTDD規律で新機能を実装する

👤 AIコーダーが要件を飛ばして実装に走りがちなチーム ⏱ ~120 min intermediate

使うタイミング: 「とりあえず書く」で痛い目にあったことがある非自明な機能の実装時。

前提条件
  • スキルのクローン — git clone https://github.com/Shelpuk-AI-Technology-Consulting/agent-skill-tdd ~/.claude/skills/agent-skill-tdd
  • Serenaが利用可能であること — Serena MCPサーバーをインストール
  • デザインレビュー用のLad MCP — Lad MCPサーバーをインストール
フロー
  1. スキルを起動する
    Use agent-skill-tdd. I want to add a 'saved searches' feature. Start from step 1 — activate Serena and investigate.✓ コピーしました
    → Claudeがコードを読み、現状を要約する
  2. 要件を明確化する
    Confirm what I just said maps to these acceptance criteria — don't code yet.✓ コピーしました
    → 確認が取れるまでやり取りを繰り返し、.requirements/ファイルが保存される
  3. Ladによるデザインレビュー
    Run design review — architecture fit, hotspots.✓ コピーしました
    → 単なる承認ではなく、設計に対する批評が得られる
  4. TDDループ
    Now begin TDD — write a failing test, minimum code to pass, refactor. Peer review each step.✓ コピーしました
    → Red-Green-Refactorサイクルが回り、各ステップがレビューされる

結果: テスト、要件履歴、設計根拠が残った状態で機能がリリースされます。

注意点
  • 「時間節約」のために明確化ステップを飛ばす — AIコーディングの価値の多くはここで生まれます — 妥協せず徹底してください
組み合わせ: filesystem · github

正しい振る舞いを文書化してからバグを修正する

👤 AIの「修正」が他のパスを壊すことにうんざりしている開発者 ⏱ ~60 min intermediate

使うタイミング: 再現手順の特定が勝負の半分を占めるような微妙なバグの場合。

フロー
  1. 調査 + 文書化
    Use agent-skill-tdd bug mode. Symptom: <description>. Write the reproduction + expected behavior to .requirements/ first.✓ コピーしました
    → As-IsとTo-Beを含むタイムスタンプ付きドキュメント
  2. 失敗するテストを書く
    Test that expresses the expected behavior — currently failing.✓ コピーしました
    → Redテスト
  3. 修正 + ピアレビュー
    Minimum fix to go green. Peer review.✓ コピーしました
    → Green + レビューコメント

結果: リグレッションを防止するテスト付きのバグ修正が完了します。

実装前に立ち止まり、仕様の理解を検証する

👤 仕様の読み違いによる手戻りが発生しているチーム ⏱ ~30 min beginner

使うタイミング: チケットが曖昧で、間違ったものを作ろうとしている予感がする時。

フロー
  1. ステップ1〜4のみ実行する
    Use agent-skill-tdd — investigate + clarify + document + design review. Stop before coding.✓ コピーしました
    → コードに触れることなく、要件ドキュメントとデザインレビューが完成する

結果: チケットの読み違いを発見するか、自信を持ってゴーサインを出せます。

組み合わせ

他のMCPと組み合わせて10倍の力を

agent-skill-tdd-skill + filesystem

.requirements/をリポジトリに保持し、将来のエージェントが参照できるようにする

Commit .requirements/ to git so the next session has context.✓ コピーしました
agent-skill-tdd-skill + github

PRの説明に要件ドキュメントへのリンクを記載する

When opening the PR, paste the .requirements/ file path in the description.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
activate_serena repo path ステップ1 0 — local
investigate task description ステップ2 0
clarify task, user answers ステップ3 0
document_requirements confirmed requirements ステップ4 0
design_review requirements + repo ステップ5 0
tdd_cycle requirements ステップ6 0

コストと制限

運用コスト

APIクォータ
スキル自体のクォータ消費はなし。SerenaとLadはそれぞれ独自のフットプリントがあります
呼び出しあたりのトークン
中程度 — 各ステップがラウンドトリップになります
金額
無料
ヒント
6ステップすべての実行は些細なタスクには過剰です — 小規模な作業ではステップ1〜4のみ実行してください

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: なし
データ送信先: Serena/Ladが設定されている場合のみデータが外部に送信されます

トラブルシューティング

よくあるエラーと対処法

Serena not available

Serena MCPサーバーをインストールし、使用しているエージェントに登録してください

Requirements doc not created

.requirements/へのファイルシステム書き込み権限があることを確認してください

確認: ls .requirements/
Design review step feels rubber-stamp(デザインレビューが形骸化している)

対立的なフレーミングを強制してください:「この設計に対する最も強い反論は何ですか?」

代替案

agent-skill-tdd 他との比較

代替案代わりに使う場面トレードオフ
claude-gpt-workflow自己TDD規律ではなく、クロスモデルレビューを行いたい場合APIコストが高い
planning-with-files-skillセッション間の永続性は欲しいが、TDDの厳格さは不要な場合テストファーストの強制がない

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る