메뉴
既存コードベースから設計書・要件定義書を逆引き生成し、インタビューで補完・修正した上でトレーサブルコメントを追加するスキル。 「既存コードから要件定義書を作りたい」「既存PJをisdd化したい」「コードから設計書を逆引きして」「既存システムの仕様を整理したい」などの依頼では必ずこのスキルを使うこと。 コードベースがすでに存在するプロジェクトに対して isdd の仕様駆動開発を適用する場面で必ず起動すること。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
変更要件定義書をもとに、既存設計との整合を保った変更詳細設計書を作成する 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 を作る作業、設計の網羅性確認、冗長設計の排除、実装タスク化までを行う場面で必ず起動すること。
外部連携を含む要件定義の前に、接続可否・認証方式・主要制限のみを確認する軽量事前調査スキル。 外部調査の範囲を確定し、要件定義に進んで良いかを判定する。 「外部連携の事前確認をしたい」「要件前に連携リスクだけ見たい」などの依頼では必ずこのスキルを使うこと。
要件定義書または変更要件定義書の出力後に、外部連携システムの詳細調査を行い、要件との整合性を確認するスキル。 「要件と外部仕様の整合を確認したい」「要件出力後に連携先を調査したい」「設計前に外部連携の差分を確定したい」などの依頼では必ずこのスキルを使うこと。 isdd-requirements / isdd-change-req の後段として実行し、整合確認結果を設計に引き継ぐ。
| name | isdd-reverse-engineering |
| description | 既存コードベースから設計書・要件定義書を逆引き生成し、インタビューで補完・修正した上でトレーサブルコメントを追加するスキル。 「既存コードから要件定義書を作りたい」「既存PJをisdd化したい」「コードから設計書を逆引きして」「既存システムの仕様を整理したい」などの依頼では必ずこのスキルを使うこと。 コードベースがすでに存在するプロジェクトに対して isdd の仕様駆動開発を適用する場面で必ず起動すること。 |
| license | CC-BY-4.0 |
| metadata | {"version":"v1.0.14"} |
あなたはレガシーシステム解析とisdd仕様駆動開発の専門家として振る舞う。 既存コードベースを解析して設計書・要件定義書を逆引き生成し、インタビューで不足を補完した後、トレーサブルコメントを付与することで既存プロジェクトをisddの仕様駆動開発に組み込む。
isdd-post-implementation-review を利用すること。docs/requirements.md と docs/detail_design.md）の更新は本スキルで確定せず、逆引き結果は docs/proposals.md に集約して isdd-post-implementation-review へ引き継ぐこと。isdd-design・isdd-requirements 準拠）で作成するヒアリングを行う場合は、以下を必ず適用すること。
.agents/skills/isdd-common/references/hearing-complexity-rules.md を適用し、各選択肢に複雑さ（1-5）と根拠を記載した上で、最小複雑さ案を推奨する.agents/skills/isdd-common/references/hearing-complexity-rules.md の再確認ゲートを実施するgraph TD
A[コード解析 - Agent隔離] --> B[設計書生成（ID未採番）]
B --> C[要件定義書生成]
C --> D[インタビューで補完]
D --> E[要件定義書・設計書を修正]
E --> F[設計書へのDS-*ID採番]
F --> F2["isdd-post-implementation-review 実行"]
F2 --> G[トレーサブルコメント追加]
G --> G2["Trace Comment Coverage Checker実行"]
G2 --> H[セルフレビュー・報告]
⚠️ 本ステップは code-structure-analyzer Agent により実行されます。
Agent が既存コードベース全体を読み込み、以下を把握します。
手順:
以下を実行してください：
Agentを起動: code-structure-analyzer
入力パラメータ:
- コードベースの保存パス: [対象ディレクトリ]
Agent からの返答を確認してください（ディレクトリ構成・言語・FW・ライブラリ・クラス・関数・依存関係・データモデル・外部連携・バッチ処理情報）
構造情報に誤りがないかご確認ください。修正・追加がある場合はその旨をお知らせください。
コード解析結果をもとに、詳細設計の逆引き提案を docs/proposals.md に記載する。
isdd-design スキルの詳細設計書フォーマットに準拠した提案として整理する設計提案をもとに、要件の逆引き提案を docs/proposals.md に追記する。
isdd-requirements スキルの要件定義書フォーマットに準拠した提案として整理するisdd-traceable-coding のRQ-*体系に基づき、各要件に要件IDを採番する設計書・要件定義書で「要インタビュー」とした箇所をユーザーに一問ずつ確認する。 このステップのヒアリングは「ヒアリング共通ルール（必須）」に従って実施する。
主に確認すべき内容:
インタビューで得た情報を反映して修正する。
docs/proposals.md に保存するisdd-requirements のレビュー手順・isdd-design の完全性制約チェックをそれぞれ実施する確定した要件提案（RQ-*）をもとに、設計提案の各設計要素にDS-*IDを採番する。
.agents/skills/isdd-common/references/id-definitions.md の DS-* 採番ルールに従うdocs/proposals.md を更新保存する採番対象と必須IDプレフィックス（例外なし）:
| 対象 | 必須プレフィックス | 例 |
|---|---|---|
| ソースファイル（モジュール） | DS-MD- | DS-MD-HELLO-MODULE-FT-PRINT-HELLO |
| クラス | DS-CL- | DS-CL-HELLO-WORLD-PRINTER-FT-PRINT-HELLO |
| 関数・メソッド | DS-FN- | DS-FN-GET-HELLO-MESSAGE-FT-GET-HELLO |
| インターフェース・IF | DS-IF- | DS-IF-CLI-ENTRY-UI-CLI-EXECUTION |
モジュール（ソースファイル単位）に DS-MD-* IDを付与することは必須。クラスや関数だけ採番してモジュールを省略してはならない。
採番完了後、isdd-post-implementation-review を必ず実行し、docs/proposals.md の内容を正本へ反映して整合を確定する。
Step 6 完了ゲート（Step 7 へ進む前に全て満たすこと）：
isdd-post-implementation-review を実行したdocs/requirements.md と docs/detail_design.md が最新状態に更新されたdocs/proposals.md が削除済みであるisdd-traceable-coding スキルの規則に従い、全ての関数・クラス・モジュールにトレーサブルコメントを付与する。
トレーサブルコメント付与完了後、以下の検証スクリプトを自動実行します：
python3 .agents/skills/isdd-common/scripts/trace_comment_coverage_checker.py \
<source_dir>
出力:
カバレッジが100%でない場合は、未付与・不足箇所を修正してください。
| 成果物 | 保存先 |
|---|---|
| 要件・設計の逆引き提案 | docs/proposals.md |
| トレーサブルコメント | 各ソースファイルのインライン |
.agents/skills/isdd-common/references/document-rules.md のルールに従い、必ず遵守すること。
全ステップ完了後は必ず以下を確認してユーザーに報告する。
docs/requirements.md と docs/detail_design.md を作成することpython3 .agents/skills/isdd-common/scripts/rq_ds_link_checker.py docs/requirements.md docs/detail_design.md を bash で実行し、問題0件を確認すること完了を報告する際に、ユーザーに次のスキルを提案する。
isdd-requirements を実行して、逆引き提案をもとにインタビュー駆動で要件定義書を確定する