majiayu000 SDD ドキュメンテーションスキル
ソフトウェア設計ドキュメント（SDD）の作成・管理・実装を統括するオーケストレータースキルです。
概要
このスキルは、以下の6つのサブスキルを連携させて、要件定義から実装・メンテナンスまでの全工程を管理します：
| サブスキル | 役割 | 成果物 |
|---|---|---|
| requirements-defining | EARS記法による要件定義 | docs/requirements/ |
| software-designing | 技術アーキテクチャ設計 | docs/design/ |
| task-planning | AIエージェント向けタスク分解 | docs/tasks/ |
| task-executing | タスク実行・逆順レビュー | 実装コード |
| sdd-troubleshooting | 問題分析・修正方針策定 | docs/troubleshooting/, docs/tasks/ |
| sdd-document-management | ドキュメント管理・メンテナンス | docs/archive/, docs/reports/ |
ドキュメント構成
docs/
├── requirements/ # 要件定義
│ ├── index.md # 目次・概要
│ ├── stories/US-XXX.md # ユーザーストーリー詳細
│ └── nfr/*.md # 非機能要件
├── design/ # 設計
│ ├── index.md # 目次・アーキテクチャ概要
│ ├── components/*.md # コンポーネント詳細
│ ├── api/*.md # API設計詳細
│ ├── database/schema.md # データベーススキーマ
│ └── decisions/DEC-XXX.md # 技術的決定事項
├── tasks/ # タスク管理
│ ├── index.md # 目次・進捗サマリ
│ └── phase-N/TASK-XXX.md # タスク詳細
├── troubleshooting/ # トラブルシューティング
│ └── [YYYY-MM-DD]-[issue-name]/
├── archive/ # アーカイブ（完了済み）
│ ├── tasks/ # 完了済みタスク
│ ├── decisions/ # 古い決定事項
│ └── troubleshooting/ # 完了した問題分析
└── reports/ # 管理レポート
├── consistency/ # 整合性チェックレポート
├── sync/ # 実装同期チェックレポート
├── archive/ # アーカイブレポート
└── optimize/ # 最適化レポート
このスキルを使用する場面
一括初期化
- 新規プロジェクトでSDDドキュメント一式が必要な場合
全体管理
- 3つのドキュメント間の整合性を確認したい場合
- 逆順レビュー（タスク → 設計 → 要件）を実施したい場合
実装フェーズ
- docs/tasks/に沿って実装を行う場合
- 実装後の逆順レビューが必要な場合
トラブルシューティング
- システムの動作不良や問題が報告された場合
- 問題の根本原因を分析したい場合
- 修正方針の策定と承認が必要な場合
ドキュメント管理
- ドキュメント間の矛盾を検出・解消したい場合
- 実装とドキュメントの同期を確認したい場合
- 完了済みタスクをアーカイブしたい場合
- 肥大化したファイルを整理したい場合
個別作業が必要な場合
特定の工程のみ実施する場合は、各サブスキルを直接使用：
- 要件定義のみ →
requirements-defining - 設計のみ →
software-designing - タスク計画のみ →
task-planning - 実装のみ →
task-executing - 問題分析のみ →
sdd-troubleshooting - ドキュメント管理のみ →
sdd-document-management
ワークフロー
新規開発フロー
1. 初期化 → docs/ディレクトリ構造を作成
↓
2. requirements-defining → docs/requirements/
↓ ユーザー確認・承認
3. software-designing → docs/design/
↓ ユーザー確認・承認
4. task-planning → docs/tasks/
↓ ユーザー確認・承認
5. ドキュメント逆順レビュー
↓
6. task-executing → 実装コード
↓
7. 実装逆順レビュー → 完了
トラブルシューティングフロー
1. 問題事象の確認
↓
2. 根本原因の分析
↓
3. 仕様との照合（docs/requirements/, docs/design/）
↓
4. 修正方針の策定
↓
5. ★ ユーザー承認 ★（必須ゲート）
↓
6. タスク分割 → docs/tasks/に追加
↓
7. task-executing → 修正実装
ドキュメント初期化
「docsディレクトリを初期化してください」と依頼されたら：
- ディレクトリ構造の作成
- requirements/index.md - テンプレート:
requirements-defining/assets/templates/requirements_index_template_ja.md - design/index.md - テンプレート:
software-designing/assets/templates/design_index_template_ja.md - tasks/index.md - テンプレート:
task-planning/assets/templates/tasks_index_template_ja.md
逆順レビュープロセス
docs/tasks/ → docs/design/ → docs/requirements/
詳細なチェック項目は references/checklist_ja.md を参照。
EARS記法クイックリファレンス
| パターン | 形式 | 使用場面 |
|---|---|---|
| 基本 | システムは〜しなければならない |
常時適用される要件 |
| イベント | 〜の時、システムは〜しなければならない |
イベント駆動要件 |
| 条件 | もし〜ならば、システムは〜しなければならない |
状態依存要件 |
| 継続 | 〜の間、システムは〜しなければならない |
継続的要件 |
| 場所 | 〜において、システムは〜しなければならない |
コンテキスト固有要件 |
ユーザーとの対話ガイドライン
情報分類プロセス
- 明示された情報: ユーザーが明確に述べた要件、仕様、制約
- 不明な情報: 推測が必要な項目（「おそらく〜」は不明として扱う）
確認の形式
ドキュメント作成の前に、以下の点を確認させてください：
【明示された情報】
- [ユーザーから明示的に指定された内容]
【不明/要確認の情報】
1. [項目1]: [選択肢A] / [選択肢B] / その他
2. [項目2]: [具体的な質問]
上記の不明点について教えていただけますか？
リソース
リファレンス
- ワークフローガイド:
references/workflow_guide_ja.md - 検証チェックリスト:
references/checklist_ja.md
サブスキル
- 要件定義:
requirements-defining/SKILL.md - 設計:
software-designing/SKILL.md - タスク計画:
task-planning/SKILL.md - タスク実行:
task-executing/SKILL.md - トラブルシューティング:
sdd-troubleshooting/SKILL.md - ドキュメント管理:
sdd-document-management/SKILL.md