requirements-analysis-plus について
requirements-analysis-plusは、複数文書にまたがる要件分析のスキルです。リスクに基づく優先順位付けや矛盾の確認を行い、前提と不足情報を明示した実行可能な案をエージェントが作成できるよう導きます。
主な機能
- 01複数文書の要件分析
- 02リスクと事業影響による優先順位付け
- 03矛盾や不整合の確認
- 04前提と情報不足の明示
- 05任意のロール別レポート入力
活用シーン
- 01複数の資料にある要件の分析
- 02影響の大きい要件とリスクの優先順位付け
- 03情報不足時の要件案の作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ naodeng/ awesome-qa-skills --skill requirements-analysis-plusインストール後、Claude Code で/requirements-analysis-plusを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamledge-incomplete-input.yamledge-risk-priority.yamledge-role-artifact-input.yamlreview-repair-regression.yamlevals/graders/review-repair-regression.pyexamples/requirements-sample.analysis.mdrequirements-sample.jsonrequirements-sample.mdoutput-templates/template-markdown.mdprompts/requirements-analysis-plus.mdreferences/script-contract.mdreferences/local/requirements-analysis_EN.mdscripts/common_parser.pyevidence_scaffold.pyparse_excel.pyparse_html.pyparse_json.pyparse_markdown.pyparse_word.pyrun_analysis.pyxlsx_reader.py詳細
requirements-analysis-plus(EN)
中国語版: 対応する中国語スキルを参照してください。
使用する場面
- 複数のソース文書を横断して、より深く要件を分析する必要がある場合。
- ベース版よりも強力な優先順位付け、矛盾の確認、追加質問が必要な場合。
スクリプトの機能範囲
任意の scripts/run_*.py は、解析済みのエビデンスやソース候補を NOT_ASSESSED として準備します。モデルの呼び出し、メインプロンプトの実行、意味的な結論やリスクの優先順位、完全なケース、承認の生成は行いません。メインプロンプトを実行するのはエージェントです。ヘルパーを実行する前に references/script-contract.md を読んでください。
ワークフロー
- Progressive disclosure に記載されたメインプロンプト(対象範囲、構成、品質基準)を読み、その指示に従います。
- 要件に関する資料があれば、それだけで単独利用できるものとします。ユーザーが
source_roleを宣言した役割レポートを提供した場合は、任意の構成入力として扱い、役割別の Skill のインストールを必須にしないでください。 - 結果を変えるプロジェクトのコンテキスト(範囲、環境、制約、リスク、依存関係、期待される成果物)のみを追加します。
- 入力が不完全な場合は、使用可能な初稿を返し、前提と不足情報を明示します。
- 既定では Markdown を使用し、ユーザーから求められた場合にのみ形式を変更します。
主な制約
- リスク/ビジネスへの影響に基づいて優先順位を付け、すべてを同等に扱わないでください。
- 確認済みの事実と現時点の前提を分けてください。
- ユーザーが提示していないエンドポイント、フィールド、環境、根本原因を作り出さないでください。
- 役割レポートの事実、見解、リスク、質問を使用する場合は、項目ごとに出典となる役割を明記してください。役割の見解を主要な要件の事実や、出典のない合意事項として提示しないでください。
- ユーザーが提供したレポートの内容のみを使用してください。他の役割別 Skill の内部ファイルを読んだり、リンクしたり、それらに依存したりしないでください。
- 出力は実行に移せるものにしてください。具体的なシナリオ、明確な優先順位、明確な次のステップを示します。
段階的な開示
- 出力を作成する前に、
prompts/requirements-analysis-plus.mdを読み、その指示(最低限の対象範囲、出力構成、品質基準)に従ってください。 - 既製のテンプレートが適している場合は、
output-templates/内の対応するファイルを使用します。 - ユーザーが例や既存のアセットとの整合性を求める場合は、関連する
examples/を読んでください。 - フレームワークの詳細、トラブルシューティング、スキーマに関する注記を確認する場合は、
references/内の該当ファイルのみを読み、ディレクトリ全体を読み込まないでください。 - 形式変換やヘルパーによるチェックには、一から作り直すのではなく、既存の
scripts/を優先して使用してください。 - このスキルの評価/回帰テストには、skill-up と
evals/を使用してください。
納品前チェックリスト
- メインプロンプトの出力構成に従った
- 最低限の対象範囲に注力した:ソース間の整合性、範囲の要約、矛盾や不一致、不足しているルール、テスト可能性に関するリスク、依存関係への影響、ビジネスへの影響、リスクに基づく優先順位など(詳細はメインプロンプトを参照)
- 最低限のチェック項目を網羅したか、省略した理由を説明した
- リスクの高い項目に明確な優先順位を付けた
- ユーザーが提示していない詳細を作り出していない
- 前提と不足情報を明記した
- 役割レポートを使用した調査結果、リスク、未解決の質問に、そのレポートの役割を明記した
- 任意の役割レポートを必須条件として扱わず、役割別 Skill の内部ファイルにもリンクしていない
よくある落とし穴
- 範囲やコンテキストが不足しているのに、完全であるかのように装わないでください。
- すべての項目を同等に重要なものとして扱わないでください。
- 前提や情報の不足を見落とさないでください。
- 現在のツールチェーンに関係のない一般論を並べないでください。
コメント
Markdown 対応