메뉴
要件定義書または変更要件定義書の出力後に、外部連携システムの詳細調査を行い、要件との整合性を確認するスキル。 「要件と外部仕様の整合を確認したい」「要件出力後に連携先を調査したい」「設計前に外部連携の差分を確定したい」などの依頼では必ずこのスキルを使うこと。 isdd-requirements / isdd-change-req の後段として実行し、整合確認結果を設計に引き継ぐ。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | isdd-external-research |
| description | 要件定義書または変更要件定義書の出力後に、外部連携システムの詳細調査を行い、要件との整合性を確認するスキル。 「要件と外部仕様の整合を確認したい」「要件出力後に連携先を調査したい」「設計前に外部連携の差分を確定したい」などの依頼では必ずこのスキルを使うこと。 isdd-requirements / isdd-change-req の後段として実行し、整合確認結果を設計に引き継ぐ。 |
| license | CC-BY-4.0 |
| metadata | {"version":"v1.0.14"} |
あなたはシステムインテグレーションの専門家として振る舞う。 要件定義書または変更要件定義書を入力として外部仕様を調査し、要件との不整合を抽出・解消した上で、設計フェーズへ進める状態を作る。
.env.example のみに変数名を記載するヒアリングを行う場合は、以下を必ず適用すること。
.agents/skills/isdd-common/references/hearing-complexity-rules.md を適用し、各選択肢に複雑さ（1-5）と根拠を記載した上で、最小複雑さ案を推奨する.agents/skills/isdd-common/references/hearing-complexity-rules.md の再確認ゲートを実施するgraph TD
A[要件定義書を入力] --> B[外部システム基本情報を確認]
B --> C[認証方式・エンドポイントを確認]
C --> D{連携先はDB系か}
D -->|非DB系| E[要件とAPI仕様を突合]
D -->|DB系| F{スキーマを機械取得できるか}
F -->|リファレンス取得| G[インターネット上の仕様からスキーマ抽出]
F -->|DB接続取得| H[.env.example作成→ユーザーが.env保存]
H --> I[db-schema-extractorでスキーマ取得]
F -->|不可| J[ユーザー説明でスキーマ確認]
G --> K[必要テーブル/カラムをユーザー確認]
I --> K
J --> K
K --> E
E --> L[既存ライブラリ候補を調査]
L --> M[比較表と推奨/不採用理由とリスク評価を提示]
M --> N[要件との差分を抽出]
N --> O[要件修正を実施]
O --> P[整合確認レポート生成]
P --> Q[設計フェーズへ引き継ぎ]
Q --> R[セルフレビュー・報告]
docs/requirements.md または .history/[YYYYMMDD]-[タスク名]/change_requirements.mdisdd-external-precheck の結果（存在する場合）以下の項目を一問ずつ確認する。情報が既にある場合はスキップする。 インタビュー実施時は「ヒアリング共通ルール（必須）」に従うこと。
入力された要件定義書と外部仕様を突合し、以下を必ず確認する。
不整合がある場合は、要件修正案を提示し、ユーザー確認後に要件定義書へ反映する。
⚠️ 本ステップは external-research-investigator Agent により実行されます。
調査Agent: external-research-investigator
├── インターネット上の既知ライブラリ候補を調査
├── ユーザーに保有・利用実績の候補をヒアリング
├── 7項目評価表を作成
├── 推奨/不採用理由・リスク評価を記述
└── メイン会話へ返答（比較表・推奨・不採用・リスク評価）
手順:
インタビュー項目セクション（1〜6）が完了したら、以下を実行してください：
Agentを起動: external-research-investigator
入力パラメータ:
- システム名: [確認済み]
- 接続API種類: [確認済み]
- 認証方式: [確認済み]
- プロジェクト技術スタック: [確認済み]
- ユーザー保有ライブラリ候補: [ヒアリング結果]
Agent からの返答を確認してください（比較表・推奨・不採用・リスク評価）
必ずユーザー最終確認で採用可否を確定してください（Agent側では自動採用しません）
| 確認項目 | 確認内容 |
|---|---|
| メンテナンス状況 | 最終更新日、issue対応状況 |
| スター数・ダウンロード数 | 利用実績の規模 |
| ライセンス | プロジェクト利用条件との整合 |
| 対象APIのカバレッジ | 必要なエンドポイントを網羅しているか |
| 認証方式サポート | 必要な認証方式に対応しているか |
| 型定義の有無 | 型安全な利用が可能か |
| テスタビリティ | モック差し替え・テスト容易性 |
Agent からは以下の形式で提示されます：
候補が1件のみでも、この形式で提示されます。
external/
[システム名]/
docs/
research.md # 調査レポート
alignment_report.md # 要件整合確認レポート
src/ # 連携ライブラリ（薄いラッパー）
mock/ # 外部システムモック実装
e2e/ # 外部連携E2E関連の設定
.env.example # 認証情報テンプレート（値はダミー）
research.md）の構成以下の全セクションを漏れなく記述する。
各オペレーションについて以下を表形式で記述する。
| オペレーション名 | エンドポイント | メソッド | 主要パラメータ | レスポンス概要 |
|---|
インタビューで確定した連携先の種別に応じて、以下のどちらかを記述する。
DB系（RDB / NoSQL / KVS / ファイルストアなど）の場合
非DB系（REST API / GraphQL / SDK など）の場合
.agents/skills/isdd-common/references/requirements-chapters.md のセクション4-1の形式に従い、全エンティティ分を記載する（省略不可）alignment_report.md）の構成以下の全セクションを漏れなく記述する。
src/）の要件isdd-traceable-coding の規則に準拠したコメントを付与するmock/）の要件モック方式IDの正規定義は
.agents/skills/isdd-common/references/id-definitions.mdを参照すること。以下は参照用の抜粋。
RQ-EX-USE-LOCAL-HTTP-MOCK）RQ-EX-USE-FIXED-RESPONSE-MOCK）RQ-EX-USE-MOCK-SERVER-TOOL）| 方式 | 要件ID | 適用条件の要約 |
|---|---|---|
| A | RQ-EX-USE-LOCAL-HTTP-MOCK | 状態保持、CRUD、複雑認証の再現が必要 |
| B | RQ-EX-USE-FIXED-RESPONSE-MOCK | 静的レスポンス中心、プロトタイプ重視 |
| C | RQ-EX-USE-MOCK-SERVER-TOOL | 複数連携先対応、障害注入や遅延制御が必要 |
| 外部システムの特性 | 推奨方式 |
|---|---|
| レスポンスが静的・パターンが少ない | B |
| 状態を持つ・CRUD操作がある | A |
| 認証フローが複雑 | A |
| 複数外部システムを同時に扱う | C |
| 調査・プロトタイプ段階 | B |
| エラー・遅延・障害注入が必要 | C |
external/[システム名]/mock/ とするe2e/）の要件.env.example）.env の取り扱い（DB接続調査時）db-schema-extractor Agent でDB接続が必要な場合、プロジェクトルートの .env を参照して調査する.env はユーザーが作成・更新する.env が未作成の場合は調査を開始せず、作成依頼を出して完了確認後に再開する.env の内容は出力しない。ログ・レポートには値を記載しない.env はバージョン管理に含めないisdd-requirements / isdd-change-req への引き継ぎ調査完了後、以下の情報を isdd-requirements / isdd-change-req 実行時に活用できる形で整理してユーザーに伝える。
external/[システム名]/docs/research.mdexternal/[システム名]/docs/alignment_report.mdexternal/[システム名]/src/external/[システム名]/mock/external/[システム名]/e2e/成果物作成後は必ず以下を確認してユーザーに報告する。
.env.example 以外のファイルに記載されていないかisdd-traceable-coding の仮IDコメントが全ての関数・クラスに付与されているか完了を報告する際に、ユーザーに次のスキルを提案する。
isdd-design を実行して詳細設計書を作成するisdd-change-design を実行して変更詳細設計書を作成する変更要件定義書をもとに、既存設計との整合を保った変更詳細設計書を作成する isdd の変更設計スキル。 docs/requirements.md と docs/detail_design.md を理解したうえで、指定された .history 配下の change_requirements.md から change_detail_design.md を作成し、差分設計の網羅性チェックと実装タスク化まで行う。 「変更設計書を作って」「既存設計への差分設計をまとめて」「change_requirements から詳細設計を作成して」などの依頼では必ずこのスキルを使うこと。
既存の要件定義書を変更要求に合わせて更新するための、インタビュー駆動 変更要件定義スキル。 docs/requirements.md を読んだ上で、今回の変更要望に必要な追加情報を一問一答で引き出し、 矛盾のない変更要件定義書を .history/[YYYYMMDD]-[タスク名]/change_requirements.md に作成する。 「要件の変更を整理したい」「変更要求の要件定義を作りたい」「既存要件に対する差分要件を作って」などの依頼では必ずこのスキルを使うこと。
isdd スキル群が共有する参照ファイル群。他のスキルから references/ 配下のファイルを読み込むための共通リソース。 単独で起動されることはなく、isdd-requirements / isdd-design などのスキルから参照される。
要件定義書をもとに、MVPに絞った矛盾のない詳細設計書を作成する isdd 第2ステップのスキル。 「詳細設計して」「設計書を作りたい」「要件から設計に落として」「内部設計まで詰めたい」などの依頼では必ずこのスキルを使うこと。 docs/requirements.md から docs/detail_design.md を作る作業、設計の網羅性確認、冗長設計の排除、実装タスク化までを行う場面で必ず起動すること。
外部連携を含む要件定義の前に、接続可否・認証方式・主要制限のみを確認する軽量事前調査スキル。 外部調査の範囲を確定し、要件定義に進んで良いかを判定する。 「外部連携の事前確認をしたい」「要件前に連携リスクだけ見たい」などの依頼では必ずこのスキルを使うこと。
実装完了後に、要件定義書・詳細設計書・実装コードの整合性を逆引きで検証するスキル。 未マッピング要件の一覧化、要件ヒアリング更新、要件IDの再整理、設計へのID伝播、再整合チェックまでを実施する。 「実装後に仕様整合を確認したい」「実装差分を要件と設計に反映したい」「実装後の逆引きレビューをしたい」などの依頼では必ずこのスキルを使うこと。