agent-skill-tdd — インストール & ライブデモ

なぜ使うのか

主な機能

6ステップワークフロー: Serena -> 調査 -> 明確化 -> 文書化 -> デザインレビュー -> TDD
タスクごとにタイムスタンプ付き.requirements/ドキュメントを生成
コーディング前に明示的な要件確認を実施
実装前にLad MCPによるアーキテクチャレビュー
すべての編集に対して変更単位のピアレビュー
エージェント非依存 — Claude Code、Codex、Cursor、Windsurf、Antigravity対応

ライブデモ

実際の動作

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

0/0

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

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

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

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

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

フロー

スキルを起動する

Use agent-skill-tdd. I want to add a 'saved searches' feature. Start from step 1 — activate Serena and investigate.✓ コピーしました

→ Claudeがコードを読み、現状を要約する
要件を明確化する

Confirm what I just said maps to these acceptance criteria — don't code yet.✓ コピーしました

→ 確認が取れるまでやり取りを繰り返し、.requirements/ファイルが保存される
Ladによるデザインレビュー

Run design review — architecture fit, hotspots.✓ コピーしました

→ 単なる承認ではなく、設計に対する批評が得られる
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

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

フロー

調査 + 文書化

Use agent-skill-tdd bug mode. Symptom: <description>. Write the reproduction + expected behavior to .requirements/ first.✓ コピーしました

→ As-IsとTo-Beを含むタイムスタンプ付きドキュメント
失敗するテストを書く

Test that expresses the expected behavior — currently failing.✓ コピーしました

→ Redテスト
修正 + ピアレビュー

Minimum fix to go green. Peer review.✓ コピーしました

→ Green + レビューコメント

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

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

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

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

フロー

ステップ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を見る