一键导入
operating-docs
設計ドキュメントの一覧表示、進捗確認、内容参照、インデックス更新、Markdown Lint を実行。ドキュメント管理や整備時に使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
設計ドキュメントの一覧表示、進捗確認、内容参照、インデックス更新、Markdown Lint を実行。ドキュメント管理や整備時に使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
開発フェーズ全体の TDD ワークフローをオーケストレーション。バックエンド・フロントエンドの開発順序と TDD サイクルの実践方法を案内し、Codex 分業体制もサポートする。「開発を始めたい」「TDD の進め方を知りたい」「Codex と分業で開発したい」「開発フェーズの全体像を把握したい」といった場面で発動する。開発フローを標準化することで、品質のブレを防ぎチーム全体の生産性を底上げする。
ビジネスアーキテクチャ分析を支援。要件定義の前段階として、ビジネスモデルキャンバス、バリューストリーム、ケイパビリティマップ、組織マップ、情報マップ、ビジネスシナリオを作成。「ビジネスモデルを整理したい」「バリューストリームを描きたい」「ケイパビリティマップを作りたい」「事業構造を分析したい」といった場面で発動する。ビジネスの全体像を理解してからシステム要件に落とし込むことで、本当に必要な機能を見極められる。
DDD の戦術的設計パターンに基づくドメインモデル設計を支援。エンティティ、値オブジェクト、集約、ドメインサービスの設計。「ドメインモデルを設計したい」「DDD で設計したい」「集約を定義したい」「エンティティと値オブジェクトを識別したい」「ユビキタス言語を整理したい」といった場面で発動する。ドメインモデルを先に設計することで、業務ロジックが実装コードに正しく反映される。
インセプションデッキの作成を支援。プロジェクトの「なぜ」「何を」「どうやって」を 10 の問いで整理し、チーム全体の認識を揃える。「インセプションデッキを作りたい」「プロジェクトの方向性を整理したい」「10 の問いに答えたい」「チームの認識を揃えたい」「プロジェクトを立ち上げる」といった場面で発動する。プロジェクトの方向性を最初に揃えておくことで、後工程での手戻りを大幅に減らせる。
RDRA 2.0 に基づく体系的な要件定義を支援。システム価値→外部環境→境界→内部構造の 4 層で要件を整理。「要件定義を始めたい」「システムの要求を整理したい」「RDRA で分析したい」「業務フローを整理したい」「システムコンテキストを作りたい」といった場面で発動する。要件を体系的に整理することで、開発フェーズでの「何を作ればいいかわからない」問題を防ぐ。
インセプションデッキの Markdown から PowerPoint スライド(.pptx)を自動生成。pptxgenjs を使用し、テンプレート準拠の 12 枚構成プレゼンテーションを出力する。「スライドを生成したい」「インセプションデッキの pptx を作りたい」「プレゼン資料を出力したい」「スライドを更新したい」といった場面で発動する。Markdown から自動生成することで、内容更新のたびに手動でスライドを作り直す手間を排除する。
| name | operating-docs |
| description | 設計ドキュメントの一覧表示、進捗確認、内容参照、インデックス更新、Markdown Lint を実行。ドキュメント管理や整備時に使用。 |
設計ドキュメントの一覧表示、進捗確認、内容参照を行います。
--list : ドキュメント一覧のみを表示--status : ドキュメントの作成状況を詳細表示--read <ファイル名> : 指定したドキュメントの内容を表示--summary : 全ドキュメントの概要を表示--update : docs/index.md と mkdocs.yml を現在のドキュメント構成に合わせて更新--update-index : docs/index.md のみを更新--update-mkdocs : mkdocs.yml のみを更新--lint : Markdown フォーマットをチェックし、違反を自動修正# ドキュメント一覧と進捗確認
# 「設計ドキュメントの一覧と作成状況を確認」
# 特定ドキュメントの参照
# --read tech_stack
# 「技術スタック選定ドキュメントの内容を表示」
# docs/index.md と mkdocs.yml を更新
# --update
# 「現在のドキュメント構成に合わせて両ファイルを更新」
# Markdown フォーマットをチェック・修正
# --lint
# 「タスク項目の前に空行がないなどのフォーマット違反を検出し自動修正」
本プロジェクトのドキュメントは以下の構成で管理されています:
要件定義ドキュメント (docs/requirements/)
requirements_definition.md : 要件定義書(RDRA 2.0)business_usecase.md : ビジネスユースケースsystem_usecase.md : システムユースケースuser_story.md : ユーザーストーリー設計ドキュメント (docs/design/)
architecture_backend.md : バックエンドアーキテクチャarchitecture_frontend.md : フロントエンドアーキテクチャarchitecture_infrastructure.md : インフラストラクチャdata-model.md : データモデル設計domain-model.md : ドメインモデル設計ui-design.md : UI 設計test_strategy.md : テスト戦略non_functional.md : 非機能要件operation.md : 運用要件tech_stack.md : 技術スタック選定--update オプションを使用すると、現在のドキュメント構成に合わせて docs/index.md と mkdocs.yml と 各ディレクトリの index.md を自動更新できます。
docs/index.md の更新内容:
mkdocs.yml の更新内容:
nav セクションを現在のドキュメント構成に合わせて更新各ディレクトリの index.md の更新内容:
--lint オプションを使用すると、Markdown ドキュメントのフォーマットをチェックし、違反を自動修正できます。
チェックルール:
NG 例 - ラベルの直後にリスト:
**受入条件**:
- [ ] ログアウトボタンをクリックするとログアウトできる
OK 例:
**受入条件**:
- [ ] ログアウトボタンをクリックするとログアウトできる
NG 例 - 番号付きリストの直後にサブリスト:
1. **対処**: SMB バージョンを確認
- コントロールパネル > ファイルサービス > SMB で設定
OK 例:
1. **対処**: SMB バージョンを確認
- コントロールパネル > ファイルサービス > SMB で設定
NG 例 - コロンで終わる行の直後にリスト:
PMD はカスタム設定で以下をチェック:
- マジックナンバーの使用
OK 例:
PMD はカスタム設定で以下をチェック:
- マジックナンバーの使用
実行手順:
docs/ 配下の全 Markdown ファイルをスキャン設計ドキュメント一覧
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
docs/requirements/
├─ requirements_definition.md (要件定義書)
├─ business_usecase.md (ビジネスユースケース)
├─ system_usecase.md (システムユースケース)
└─ user_story.md (ユーザーストーリー)
docs/design/
├─ architecture_backend.md (バックエンドアーキテクチャ)
├─ architecture_frontend.md (フロントエンドアーキテクチャ)
├─ data-model.md (データモデル設計)
├─ domain-model.md (ドメインモデル設計)
├─ ui-design.md (UI 設計)
├─ test_strategy.md (テスト戦略)
├─ non_functional.md (非機能要件)
├─ operation.md (運用要件)
└─ tech_stack.md (技術スタック選定)
進捗: 14/14 ドキュメント完成 (100%)
docs/ ディレクトリが存在すること--update 実行前に現在の docs/index.md と mkdocs.yml をバックアップすることを推奨--update-mkdocs を使用する場合、MkDocs がインストールされている必要がある--update でインデックスを同期する--update-mkdocs 後は mkdocs serve でナビゲーションを確認する--lint でフォーマットの一貫性を確保するorchestrating-analysis : 分析フェーズ全体の作業支援analyzing-requirements : 要件定義関連の作業支援analyzing-architecture : アーキテクチャ設計支援tracking-progress : プロジェクト全体の進捗確認