requirements-documentation
要件ドキュメントの作成・構造化・品質管理・ハンドオフを支援するスキル。カール・ウィーガーズの要求工学理論に基づき、ステークホルダーと開発チームの双方に有用な仕様書を作成する。Anchors:• Software Requirements (Karl Wiegers) / 適用: 要件管理全般 / 目的: 明確で検証可能な仕様• IEEE 830 SRS Standard / 適用: ドキュメント構造 / 目的: 標準準拠の仕様書• Don't Make Me Think (Steve Krug) / 適用: 情報設計 / 目的: 読みやすいドキュメントTrigger:Use when creating requirements documents, writing specifications, preparing stakeholder reviews, or establishing requirements traceability.requirements document, specification, SRS, stakeholder review, traceability matrix, 要件定義書, 仕様書
When & Why to Use This Skill
This Claude skill streamlines the requirements engineering process by helping users create, structure, and validate high-quality Software Requirements Specifications (SRS). Based on industry standards such as IEEE 830 and Karl Wiegers’ theories, it ensures clear communication between stakeholders and development teams through automated quality checks, MoSCoW prioritization, and traceability mapping.
Use Cases
- Generating standard-compliant Software Requirements Specifications (SRS) from raw stakeholder interviews or initial project notes.
- Improving the quality of existing documentation by identifying ambiguous, inconsistent, or non-verifiable requirements.
- Establishing a Requirements Traceability Matrix (RTM) to link business needs directly to technical implementation and testing phases.
- Structuring complex technical information into readable formats using information design principles to facilitate faster stakeholder approval.
- Managing the handoff protocol between the requirements phase and the design/development teams to ensure no specifications are lost in transition.
| name | requirements-documentation |
|---|---|
| description | | |
| • Software Requirements (Karl Wiegers) / 適用 | 要件管理全般 / 目的: 明確で検証可能な仕様 |
| • IEEE 830 SRS Standard / 適用 | ドキュメント構造 / 目的: 標準準拠の仕様書 |
| • Don't Make Me Think (Steve Krug) / 適用 | 情報設計 / 目的: 読みやすいドキュメント |
要件ドキュメンテーション
概要
要件ドキュメントの構造化、品質メトリクス、ハンドオフプロトコルを提供するスキル。 以下の場面で活用される:
- 要件定義書・仕様書の新規作成
- 既存要件ドキュメントの品質改善
- ステークホルダーレビューの準備
- 設計フェーズへのハンドオフ実施
- 要件トレーサビリティの確立
ワークフロー
Phase 1: 要件収集と分析
目的: ステークホルダーからの要件を収集し、ドキュメント化の準備を整える
アクション:
- ステークホルダーの特定と役割整理
- 要件の収集(インタビュー、既存ドキュメント分析)
- 機能要件と非機能要件の分類
- 優先度付け(MoSCoW法)
- 依存関係と制約の整理
Task: agents/analyze-requirements.md を参照
Phase 2: ドキュメント構造設計
目的: 収集した要件を標準化されたドキュメント形式で構造化する
アクション:
- ドキュメントスコープの決定
- テンプレート(
assets/requirements-document-template.md)の適用 - セクション構成の最適化
- 受入基準の定義(Given-When-Then形式)
- ユースケース記述の作成
Task: agents/structure-document.md を参照
Phase 3: 検証とレビュー
目的: ドキュメントの品質を確保し、ステークホルダーの承認を得る
アクション:
scripts/validate-document.mjsで構造検証- 品質メトリクスの確認(完全性、一貫性、検証可能性)
- ステークホルダーレビューの実施
- フィードバックの反映と改訂
- 承認プロセスの完了
Task: agents/validate-document.md を参照
Phase 4: トレーサビリティとハンドオフ
目的: 要件から設計・実装・テストへの追跡可能性を確立する
アクション:
- 要件追跡マトリクスの作成
- 設計フェーズへの引き継ぎ資料準備
- テスト計画との紐付け
scripts/log_usage.mjsで実行記録を保存- ハンドオフ完了の確認
Task: agents/create-traceability.md を参照
Task仕様(ナビゲーション)
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-requirements | Phase 1開始時 | ステークホルダー情報 | 要件分析結果 |
| structure-document | Phase 2開始時 | 要件分析結果 | 構造化ドキュメント |
| validate-document | Phase 3開始時 | ドキュメントドラフト | 検証済みドキュメント |
| create-traceability | Phase 4開始時 | 確定要件 | トレーサビリティ資料 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照
ベストプラクティス
すべきこと
- テンプレート(
assets/requirements-document-template.md)を活用し一貫性を確保 - MoSCoW法で全要件に優先度を付与
- 受入基準をGiven-When-Then形式で具体的に記述
- 要件IDを付与しトレーサビリティを維持
- ステークホルダーレビューを早期かつ頻繁に実施
scripts/validate-document.mjsで定期的に品質検証
避けるべきこと
- 曖昧または検証不可能な要件の記述
- 優先度なしでの要件列挙
- ステークホルダー承認前のハンドオフ
- トレーサビリティの欠如
- 品質検証スクリプトの実行省略
リソース参照
references/(詳細知識)
| リソース | パス | 内容 |
|---|---|---|
| ドキュメント構造 | See references/document-structure.md | 要件ドキュメントの構造パターン |
| 品質メトリクス | See references/quality-metrics.md | 品質基準と検証方法 |
| ステークホルダー管理 | See references/stakeholder-management.md | 関係者管理とレビュープロセス |
scripts/(決定論的処理)
| スクリプト | 用途 | 使用例 |
|---|---|---|
validate-document.mjs |
ドキュメント構造検証 | node scripts/validate-document.mjs [document-path] |
log_usage.mjs |
フィードバック記録 | node scripts/log_usage.mjs --result success --phase "Phase 4" |
assets/(テンプレート)
| テンプレート | 用途 |
|---|---|
requirements-document-template.md |
要件定義書の標準テンプレート |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 3.0.0 | 2026-01-02 | 18-skills.md仕様完全準拠:agents追加、references再構成、Trigger英語化 |
| 2.0.0 | 2025-12-31 | 18-skills.md仕様への全面更新:YAML frontmatter標準化、Task仕様ナビ追加 |
| 1.0.0 | 2025-12-24 | 初版作成 |