Spec-Workflow-Toolkit

設定ファイルとソースコードからプロジェクトの技術スタックを自動検出。 Use when: 新規コードベースでの作業開始、言語/フレームワーク/ツールの特定。 Trigger phrases: detect stack, what framework, identify technology, project setup

REST、GraphQL、gRPC の API 設計パターン。 Use when: API の新規設計、OpenAPI 仕様作成、バージョニング/ページネーション設計。 Trigger phrases: API design, REST endpoint, GraphQL schema, OpenAPI, gRPC, pagination

エバリュエーター・オプティマイザーのフィードバックループによる反復改善。 Use when: 出力品質の反復改善、明確な評価基準がある複雑な出力の最適化。 Trigger phrases: iterate, refine, improve quality, feedback loop, evaluate and optimize

ルール遵守と創造的な問題解決のバランスを取るためのフレームワーク。 Anthropic のエージェント設計に関する研究に基づく。 使用場面: - 複数の有効なアプローチがある複雑な判断に直面した場合 - 状況に対して指示が過度に規範的に感じられる場合 - ガイドラインを特定のコンテキストに適応させる必要がある場合 - 精度要件と革新的なソリューションのバランスを取る場合 Trigger phrases: think creatively, use judgment, adapt approach, better solution, flexibility

曖昧なリクエストを明確にするための構造化された要件インタビューフレームワーク。使用場面: - ユーザー要件が不明確または不完全な場合 - 新機能を開始し要件を収集する必要がある場合 - ユーザーのニーズ、制約、優先順位を理解する必要がある場合 - ビジネスリクエストを技術仕様に変換する場合 - ユーザーが詳細なしに「～したい」「～を追加して」と言う場合 Trigger phrases: gather requirements, clarify request, what do you need, interview user, requirements gathering, unclear request

すべてのユーザー向けコンテンツに日本語出力を強制する。 使用場面: - エージェント出力を日本語にする必要がある場合 - レスポンス全体の言語の一貫性を検証する場合 - 仕様書やドキュメントを日本語で生成する場合 Trigger phrases: Japanese, 日本語, language mode, output language

あらゆる技術スタックに適用可能なコアセキュリティ原則と実践。使用場面: - 認証、認可、アクセス制御の実装 - 機密データの取り扱い（パスワード、PII、シークレット、トークン） - ユーザー入力や API ペイロードのバリデーション - セキュリティ脆弱性のコードレビュー - 暗号化、ハッシュ化、暗号技術の使用 - OWASP Top 10 脆弱性への対応 Trigger phrases: security review, auth implementation, password handling, input validation, XSS, SQL injection, CSRF, secrets management, OWASP

仕様駆動開発の方法論とワークフロー。使用場面: - 新機能やプロジェクトの開始（「新機能」「実装」「構築」） - ユーザーリクエストが曖昧または不明確（「何か追加して」「改善して」） - 仕様ファーストの開発を強制（「仕様を書いて」「仕様書を作成」） - 「とにかく作って」と言われたり計画をスキップしたい場合 - 要件、受け入れ基準、スコープの議論 Trigger phrases: specification, PRD, requirements document, scope definition, feature planning

オーケストレーターとサブエージェントのための標準化された通信プロトコル。 委任システムのルール、責任、結果フォーマットを定義。 使用場面: - コマンドファイルの作成・メンテナンス（オーケストレータールール） - 新しいサブエージェント動作の定義（サブエージェントルール） - 複数エージェントからの結果の集約 - 委任の制約の理解 - エージェント障害の処理（エラーハンドリングセクション） Trigger phrases: subagent format, agent output, result format, orchestrator rules, delegation protocol このスキルはオーケストレーターとサブエージェント間の契約を定義する - 双方のルール。

プロジェクトに設定されたリンティング、フォーマット、型チェックの検出と実行。以下の場合に使用: - コード記述・編集後の品質基準の確認 - リントエラーやフォーマット問題の修正 - プロジェクトに設定された品質ツールの実行 - CI 品質チェックに失敗している場合 Trigger phrases: lint, format code, run linter, fix formatting, type check, code style

Agent Team によるマルチエージェントディスカッションの協調プロトコル。 構造化された多角的探索（Position -> Challenge -> Synthesis）で 設計判断・技術選定・方針決定の合意形成を支援する。 Use when: - /discuss コマンドでディスカッション実行時 - 設計判断の対立点について多角的議論が必要な時 - spec-plan Phase 4 で設計選択肢の評価が必要な時 Trigger phrases: discuss, deliberate, multi-perspective, team discussion

レジリエントなエージェントワークフローのためのエラーハンドリング、チェックポイント管理、リカバリパターン。 Anthropic のロングランニングエージェントガイダンスとグレースフルデグラデーションに基づく。 以下の場合に使用: - 失敗する可能性のある複雑なワークフローの実装 - チェックポイント/再開機能が必要な場合 - ツール障害のグレースフルハンドリング - エージェントエラーとリトライの管理 - 堅牢な自動化の構築 Trigger phrases: error handling, recovery, checkpoint, resume, graceful degradation, retry, fallback

Conventional Commits に基づくセマンティックコミットメッセージ、変更ログ管理、git ワークフロー。以下の場合に使用: - 変更のコミット時に適切なコミットメッセージ形式が必要 - 変更ログやリリースノートの管理 - git ブランチ、マージ、リベースの操作 - プルリクエストの作成や git 履歴のレビュー - セマンティックバージョニングのガイダンスが必要 Trigger phrases: commit message, conventional commits, changelog, git workflow, semantic version, feat:, fix:, pull request

後からキャプチャ・レビュー可能な開発インサイトを記録するための標準プロトコル。 以下の場合に使用: - 再利用可能なパターンやアンチパターンの発見時 - コードベースについて予期しないことを学んだ時 - 明確な根拠に基づく重要な判断を下した時 - 将来の参照のために記録する価値のあるインサイトを見つけた時 このスキルは insight_capture フックが自動的に抽出するインサイトマーカーを定義する。

状態の永続化と進捗トラッキングを伴う自律的なロングランニングタスクのパターン。 以下の場合に使用: - 追跡が必要な複数ステップのタスク - コンテキストウィンドウの制限を超える可能性のある作業 - セッション間で状態を永続化する必要がある場合 - 複雑なマイグレーション、リファクタリング、複数ファイルの変更 - ユーザーが「全部完了して」「自律的に実行」と言った場合 Trigger phrases: long task, autonomous, persist state, track progress, migration, refactoring, multi-step

任意の ORM/データベーススタックに適用可能な安全なデータベーススキーママイグレーションパターン。以下の場合に使用: - データベーススキーマの変更（カラム・テーブルの追加/削除） - 安全なマイグレーションの実行 - データベースのバージョニングとロールバックの管理 - マイグレーションリスクの評価や安全なデプロイの計画 - スキーマドリフトやマイグレーションの競合への対処 Trigger phrases: database migration, schema change, add column, migration rollback, schema drift

ロギング、メトリクス、分散トレーシングのオブザーバビリティパターン。以下の場合に使用: - 構造化ロギングの実装 - メトリクスとモニタリングのセットアップ - 分散トレーシングの追加 - ヘルスチェック（liveness、readiness）の実装 - アラートや SLO ベースのモニタリングの設計 Trigger phrases: logging, metrics, tracing, monitoring, health check, alerting, SLO, structured logs, observability

効率を最大化しコンテキスト使用量を削減するための並列サブエージェント実行パターン。 以下の場合に使用: - 複数の独立した分析やレビューが必要な場合 - 依存関係なしで同時実行可能なタスク - 複数の視点からのコードレビュー - 異なる角度からのコードベース探索 Trigger phrases: parallel review, concurrent agents, multi-agent, independent analysis, run simultaneously

ユーザーに提示する前のプラン品質のための軽量セルフレビューチェックリスト。 エージェント呼び出しなし — オーケストレーターがこのチェックリストを直接実行する。 以下の場合に使用: - /spec-plan の最終出力を提示する前の完了時 - レビューエージェントを起動せずに仕様⇔設計の一貫性を検証する時 - /spec-review への引き渡し前の簡易品質ゲート 非対象: フル並列エージェントレビュー（それには /spec-review --auto を使用）

ロングランニングおよびマルチセッションタスクのための JSON ベース進捗トラッキング。 Anthropic の「ロングランニングエージェントのための効果的なハーネス」パターンに基づく。 以下の場合に使用: - 複数セッションにまたがる可能性のある複雑なタスクの開始時 - 機能実装の進捗を追跡する必要がある時 - コンテキストウィンドウ間で再開可能なワークフローが必要な時 - 大規模なマイグレーションやリファクタリングの管理 - ユーザーが「進捗を追跡」「作業を再開」「前回の続き」と言った時 Trigger phrases: track progress, resume, continue, multi-session, persist state, progress file, feature list

動的リサーチを活用した新プロジェクト向けのインタラクティブな技術スタックコンサルテーション。以下の場合に使用: - 既存コードベースのない新規プロジェクトの開始 - ユーザーが使用すべき技術スタックを把握していない場合 - 現在のベストプラクティスに基づく推奨が必要な場合 - 最新情報で技術オプションをリサーチ・比較する必要がある場合 - ユーザーが「どのスタックを使うべきか」「選択を手伝って」と言った場合 Trigger phrases: stack consultation, recommend stack, what technology, choose tools, new project stack, tech advice, help me decide

Red-Green-Refactor サイクルによるテスト駆動開発ワークフロー。 Anthropic 推奨のエージェントコーディング向け TDD パターンに基づく。 以下の場合に使用: - 明確な受入基準のある新機能の実装 - テストファーストアプローチでリグレッションを防止するバグ修正 - ユーザーが「TDD」「テストを先に書く」「red-green-refactor」と言った場合 - 既存コードのリファクタリング（変更前にテストが必要） - テストで容易に検証可能な機能 Trigger phrases: TDD, test-driven, test first, red-green-refactor, write tests before code

Agent Team を活用した並列レビュー・実装の協調プロトコル。 チーム作成、フォールバック検出、スポーンプロンプト、 インサイトキャプチャ、Progress file 管理を定義する。 Use when: - spec-review --auto のチームモード実行時 - 複数エージェントの並列レビューでチーム協調が必要な時 Trigger phrases: agent team, team mode, parallel review team

技術的負債の特定、分類、優先順位付けフレームワーク。 体系的な負債解消のための legacy-modernizer エージェントとの統合。 以下の場合に使用: - コードベースの技術的負債の特定 - どの負債を先に対処すべきかの優先順位付け - 負債の経時的な追跡 - リファクタリングスプリントの計画 - ステークホルダーへの負債解消の正当化 Trigger phrases: tech debt, technical debt, code smell, refactor priority, RICE score, debt tracking, legacy code

任意の技術スタックに適用可能なテスト戦略、パターン、ベストプラクティス。以下の場合に使用: - ユニットテスト、統合テスト、E2E テストの作成 - テスト戦略の策定やカバレッジの改善 - テストのベストプラクティスの学習 - 失敗テストやフレーキーテストのデバッグ - テストデータ、モック、フィクスチャのセットアップ Trigger phrases: write tests, unit test, integration test, E2E test, test coverage, test strategy, mock, fixture, test data