mcpField
R
requirements-analysis-plus

requirements-analysis-plus

github.com/naodeng開発285106 回インストール今日更新
リポジトリ

requirements-analysis-plus について

requirements-analysis-plusは、複数文書にまたがる要件分析のスキルです。リスクに基づく優先順位付けや矛盾の確認を行い、前提と不足情報を明示した実行可能な案をエージェントが作成できるよう導きます。

主な機能

  1. 01複数文書の要件分析
  2. 02リスクと事業影響による優先順位付け
  3. 03矛盾や不整合の確認
  4. 04前提と情報不足の明示
  5. 05任意のロール別レポート入力

活用シーン

  1. 01複数の資料にある要件の分析
  2. 02影響の大きい要件とリスクの優先順位付け
  3. 03情報不足時の要件案の作成

インストール

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

$npx skills add https://github.com/naodeng/awesome-qa-skills --skill requirements-analysis-plus

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

同梱ファイル

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

README.md
agents/
openai.yaml
evals/
eval.yaml
evals/cases/
basic-success.yaml
edge-incomplete-input.yaml
edge-risk-priority.yaml
edge-role-artifact-input.yaml
review-repair-regression.yaml
evals/graders/
review-repair-regression.py
examples/
requirements-sample.analysis.md
requirements-sample.json
requirements-sample.md
output-templates/
template-markdown.md
prompts/
requirements-analysis-plus.md
references/
script-contract.md
references/local/
requirements-analysis_EN.md
scripts/
common_parser.py
evidence_scaffold.py
parse_excel.py
parse_html.py
parse_json.py
parse_markdown.py
parse_word.py
run_analysis.py
xlsx_reader.py

詳細

requirements-analysis-plus(EN)

中国語版: 対応する中国語スキルを参照してください。

使用する場面

  • 複数のソース文書を横断して、より深く要件を分析する必要がある場合。
  • ベース版よりも強力な優先順位付け、矛盾の確認、追加質問が必要な場合。

スクリプトの機能範囲

任意の scripts/run_*.py は、解析済みのエビデンスやソース候補を NOT_ASSESSED として準備します。モデルの呼び出し、メインプロンプトの実行、意味的な結論やリスクの優先順位、完全なケース、承認の生成は行いません。メインプロンプトを実行するのはエージェントです。ヘルパーを実行する前に references/script-contract.md を読んでください。

ワークフロー

  1. Progressive disclosure に記載されたメインプロンプト(対象範囲、構成、品質基準)を読み、その指示に従います。
  2. 要件に関する資料があれば、それだけで単独利用できるものとします。ユーザーが source_role を宣言した役割レポートを提供した場合は、任意の構成入力として扱い、役割別の Skill のインストールを必須にしないでください。
  3. 結果を変えるプロジェクトのコンテキスト(範囲、環境、制約、リスク、依存関係、期待される成果物)のみを追加します。
  4. 入力が不完全な場合は、使用可能な初稿を返し、前提と不足情報を明示します。
  5. 既定では Markdown を使用し、ユーザーから求められた場合にのみ形式を変更します。

主な制約

  • リスク/ビジネスへの影響に基づいて優先順位を付け、すべてを同等に扱わないでください。
  • 確認済みの事実と現時点の前提を分けてください。
  • ユーザーが提示していないエンドポイント、フィールド、環境、根本原因を作り出さないでください。
  • 役割レポートの事実、見解、リスク、質問を使用する場合は、項目ごとに出典となる役割を明記してください。役割の見解を主要な要件の事実や、出典のない合意事項として提示しないでください。
  • ユーザーが提供したレポートの内容のみを使用してください。他の役割別 Skill の内部ファイルを読んだり、リンクしたり、それらに依存したりしないでください。
  • 出力は実行に移せるものにしてください。具体的なシナリオ、明確な優先順位、明確な次のステップを示します。

段階的な開示

  • 出力を作成する前に、prompts/requirements-analysis-plus.md を読み、その指示(最低限の対象範囲、出力構成、品質基準)に従ってください。
  • 既製のテンプレートが適している場合は、output-templates/ 内の対応するファイルを使用します。
  • ユーザーが例や既存のアセットとの整合性を求める場合は、関連する examples/ を読んでください。
  • フレームワークの詳細、トラブルシューティング、スキーマに関する注記を確認する場合は、references/ 内の該当ファイルのみを読み、ディレクトリ全体を読み込まないでください。
  • 形式変換やヘルパーによるチェックには、一から作り直すのではなく、既存の scripts/ を優先して使用してください。
  • このスキルの評価/回帰テストには、skill-up と evals/ を使用してください。

納品前チェックリスト

  • メインプロンプトの出力構成に従った
  • 最低限の対象範囲に注力した:ソース間の整合性、範囲の要約、矛盾や不一致、不足しているルール、テスト可能性に関するリスク、依存関係への影響、ビジネスへの影響、リスクに基づく優先順位など(詳細はメインプロンプトを参照)
  • 最低限のチェック項目を網羅したか、省略した理由を説明した
  • リスクの高い項目に明確な優先順位を付けた
  • ユーザーが提示していない詳細を作り出していない
  • 前提と不足情報を明記した
  • 役割レポートを使用した調査結果、リスク、未解決の質問に、そのレポートの役割を明記した
  • 任意の役割レポートを必須条件として扱わず、役割別 Skill の内部ファイルにもリンクしていない

よくある落とし穴

  • 範囲やコンテキストが不足しているのに、完全であるかのように装わないでください。
  • すべての項目を同等に重要なものとして扱わないでください。
  • 前提や情報の不足を見落とさないでください。
  • 現在のツールチェーンに関係のない一般論を並べないでください。

コメント