mcpField
A
agent-patterns

agent-patterns

github.com/jeremylongshoreエージェントワークフロー2.9k39 回インストール2 日前に更新
リポジトリ

agent-patterns について

agent-patternsは、Sprintでプロジェクトアーキテクトが実装・テストエージェントを調整する手順を定めます。範囲を指定した起動依頼と構造化レポートで、並行作業と進捗確認を行います。

主な機能

  1. 01範囲を指定したエージェント起動依頼
  2. 02構造化された完了レポート
  3. 03領域ごとの並行作業
  4. 04UIテストレポート形式
  5. 05Sprintのステータス管理

活用シーン

  1. 01バックエンドとフロントエンドの実装調整
  2. 02実装エージェント後のテスト割り当て
  3. 03仕様適合性とテスト結果の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill agent-patterns

インストール後、Claude Code で/agent-patternsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
errors.md
examples.md
ui-test-report.md

詳細

エージェントパターン

概要

Agent Patterns は、Sprint プラグイン内で複数のエージェントがスプリントを実行する際の調整プロトコルを定義します。プロジェクトアーキテクトが実装エージェントとテストエージェントをどのように起動するか、エージェントが構造化レポートを通じて結果をどのように伝えるか、並行して動作するエージェントが競合をどのように回避するかを規定します。

前提条件

  • Sprint プラグインがインストールおよび設定されている（/plugin install sprint）
  • Sprint ディレクトリが .claude/sprint/[N]/ に初期化されている
  • 明確なスコープとテスト設定を記載した specs.md が作成されている
  • スプリントのフェーズライフサイクルを理解している（sprint-workflow スキルを参照）

手順

  1. すべてのエージェントの起動を SPAWN REQUEST 形式で構成します。エージェント名、読み込む仕様ファイル、スコープ上の制約を含めます。

    SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md
Scope: Authentication endpoints only

  2. 起動する各エージェントには、そのスコープに関連するファイルのみを渡します。共有インターフェースとして api-contract.md を渡し、バックエンドエージェントとフロントエンドエージェントが同期を保てるようにします。

  3. 完了時に、各エージェントから構造化レポートを収集します。各レポートには、完了した作業、変更したファイル、追加したテスト、仕様への適合状況を含める必要があります。

  4. エージェントを並行して実行する場合は、ドメイン境界（例：バックエンド、フロントエンド、CI/CD）ごとに作業を分割します。並行して動作するエージェントに、重複するファイルパスを割り当てないでください。

  5. エージェントのレポートをプロジェクトアーキテクトに返してレビューしてもらいます。アーキテクトは、再実行（スコープを絞った仕様で再起動）するか、次のフェーズに進むかを判断します。

  6. テストエージェントには、${CLAUDE_SKILL_DIR}/references/ui-test-report.md に示されている UI テストレポート形式を渡し、テスト数、カバレッジ、失敗、コンソールエラーを含む一貫したスキーマに従って結果を報告させます。

出力

  • スプリントオーケストレーターがエージェントを起動するために使用する SPAWN REQUEST ブロック
  • 概要、変更したファイル、テスト結果、適合状況を含む構造化エージェントレポート
  • 成功数／失敗数、カバレッジの詳細、失敗の説明、コンソールエラーログを含む UI テストレポート
  • 各イテレーション後に、完了した作業と残りの作業を反映した更新済みの status.md

エラー処理

エラー原因解決策
エージェントが誤った仕様ファイルを受け取るSPAWN REQUEST のパスが誤っている起動前に Sprint ディレクトリ番号とファイル名を確認します
並行エージェントによるファイル変更が重複するスコープの境界が明確に定義されていないドメインごとに作業を分割し、エージェントごとに異なるディレクトリを割り当てます
エージェントレポートに必須項目がないエージェントへの指示にレポート形式が含まれていないエージェントのプロンプトに構造化レポートのテンプレートを含めます
イテレーションが無限に続く仕様が完全に満たされないstatus.md でブロッキングの問題を確認します。オーケストレーターは 5 回のイテレーション後に一時停止します
エージェントが見つからないSPAWN REQUEST のエージェント名に誤字があるagents/ ディレクトリにエージェントの Markdown ファイルが存在することを確認します

例

実装エージェントを並行して起動する：

SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md

SPAWN REQUEST
Agent: nextjs-dev
Specs: .claude/sprint/1/frontend-specs.md
Contract: .claude/sprint/1/api-contract.md

両方のエージェントは、API の互換性を確保するため、同じ api-contract.md を共有します。

構造化エージェントレポートの形式：

AGENT REPORT
Agent: python-dev
Status: COMPLETE
Files Modified: src/auth/routes.py, src/auth/models.py, tests/test_auth.py
Tests: 12 passed, 0 failed
Conformity: All backend-specs requirements implemented
Notes: JWT token expiry set to 24h per spec

テストエージェントの調整：

SPAWN REQUEST
Agent: qa-test-agent
Specs: .claude/sprint/1/specs.md
Run After: python-dev, nextjs-dev

SPAWN REQUEST
Agent: ui-test-agent
Specs: .claude/sprint/1/specs.md
Run After: qa-test-agent

リソース

  • ${CLAUDE_SKILL_DIR}/references/ui-test-report.md -- カバレッジと失敗の追跡を含む、構造化 UI テストレポート形式
  • フェーズライフサイクルの背景については Sprint workflow スキルを参照
  • 共有インターフェースの設計については API contract スキルを参照
  • エージェントアーキテクチャの概要については Sprint プラグインの README を参照

コメント

Markdown 対応