Menü
基本設計書を入力として、詳細設計書を作成し、モックアップ生成とテスト設計までを一貫して行うワークフロー。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
PR作成後のCI監視、失敗時の分類と対応、自動マージまでの完全なワークフローを定義
GitHub Issue間の依存関係（Is blocking / Blocked by）を設定・取得するためのAPI操作を提供
GitHub Issueのラベルとメタデータを使用した環境状態管理。worktree/ホスト環境すべてからアクセス可能なSingle Source of Truth
PRの作成からマージ、クリーンアップ、ロールバックまでの標準フローを定義
バージョン整合性チェック→提案→承認→GitHub Release作成までの標準リリースフロー（マルチエコシステム対応）
Git worktree を作成し、並行開発用の独立したブランチ環境を構築する。プラットフォーム固有コード開発時に使用。
| name | detailed-design-workflow |
| description | 基本設計書を入力として、詳細設計書を作成し、モックアップ生成とテスト設計までを一貫して行うワークフロー。 |
基本設計書を入力として、詳細設計書を作成し、モックアップ生成とテスト設計までを一貫して行うワークフロー。
$ARGUMENTS（基本設計書のパス）
| Phase | 名称 | 内容 |
|---|---|---|
| 0 | ドキュメント計画 | 機能分解、ドキュメント一覧作成、ユーザー確認 |
| 0.5 | 影響分析 | 既存設計書・Issue・コードとの整合性確認（追加仕様時） |
| 1 | 設計書作成 | 詳細/BE/FE/画面/共通設計書の作成 |
| 1.5 | 検証 & モックアップ | ASCII禁止チェック、HTML作成、スクリーンショット |
| 2 | 品質保証ループ | detailed-design-reviewer によるレビュー（9点以上） |
| 2.5 | ユーザー承認 | approval-gate skill |
| 3 | 成果物作成 | テスト項目書、Epic/子Issue作成、Sub-issue連携 |
Phase規約:
workflow-phase-conventionskill を参照
| 機能タイプ | 詳細設計書 | BE | FE | 画面設計書 |
|---|---|---|---|---|
| 画面あり機能 | O | O | O | O |
| API専用機能 | O | O | - | - |
| バッチ処理 | O | O | - | - |
| 設計書 | 必須 |
|---|---|
| データベース設計書.md | O |
| インフラ設計書.md | O |
| セキュリティ設計書.md | O |
トリガー: 既存の詳細設計書・Issue・コードが存在する場合
| チェック項目 | 確認内容 |
|---|---|
| API互換性 | 既存APIシグネチャを破壊しないか |
| 型定義互換性 | 既存の型定義と矛盾しないか |
| 依存Issue | 新規Issueが既存Issueに依存するか |
| 既存モジュール | src/ のどのファイルを変更するか |
ユーザー確認オプション: 1. 続行 / 2. 調整 / 3. 中断（番号選択）
detailed-design-writer エージェントが各サブ機能に対して設計書を作成。
テンプレート:
detailed-design-templatesskill を参照
grep -r -l '┌\|┐\|└\|┘\|│\|─' docs/designs/detailed/{機能名}/**/画面設計書.md
# → 0件であること
ツール:
wireframe-generatorskill を使用
bun run generate.ts で mockup.html 等を生成生成対象:
mockup.html (Desktop)mockup-mobile.html (Mobile, 固定幅375px)mockup-error.html| 条件 | アクション |
|---|---|
| スコア >= 9 & FE設計書あり | Phase 2.5へ |
| スコア < 9 | Phase 1に戻り修正（最大3回） |
| スコア悪化 | 即時中断 |
共通仕様:
approval-gateskill を参照
| ステップ | 担当 | 成果物 | 制約 |
|---|---|---|---|
| 3.1 テスト項目書作成 | test-spec-writer | .md ファイルのみ | Issue作成禁止 |
| 3.2 Epic Issue作成 | メインエージェント | GitHub Issue | 重複チェック必須 |
| 3.3 子Issue作成 | メインエージェント | GitHub Issue | 重複チェック必須 |
| 3.4 ドキュメントIssue | メインエージェント | GitHub Issue | 重複チェック必須 |
| 3.5 Sub-issue連携 | メインエージェント | GraphQL API | - |
| 制約 | 上限 |
|---|---|
| コード量 | 200行以下 |
| ファイル数 | 1-3ファイル |
| 責務 | 単一責務 |
test-spec-writer エージェントに以下を指示：
MUST DO:
- テスト項目書を {出力パス} に作成する
- 設計書のテスト観点を網羅する
MUST NOT DO:
- GitHub Issue を作成しない（Issue作成は後続ステップで行う）
- gh コマンドを実行しない
- 設計書内の TASK-XXX を Issue 化しない
# Issue作成前に既存Issueを確認
gh issue list --repo $REPO --search "{機能ID}" --json number,title
# 重複がなければ作成
gh issue create --title "..." --body "..."
GraphQL API:
github-graphql-apiskill を参照
テンプレート:
detailed-design-templatesskill を参照
詳細設計書.md が存在バックエンド設計書.md が存在画面設計書.md と フロントエンド設計書.md が存在共通仕様・出力形式:
approval-gateskill の「ワークフロー完了後の次ステップ選択」を参照
| 項目 | 値 |
|---|---|
| ワークフロー名 | 詳細設計 |
| 次ワークフロー | 実装フェーズ（TDD推奨） |
| 追加成果物 | Epic Issue, 子Issue群 |
| 状況 | アクション |
|---|---|
| モックアップ生成失敗 | placeholder.png を置いて続行、警告を残す |
| FE設計書欠落 | Phase 3で検出してPhase 1に戻る |
| レビュー3回失敗 | 中断、ユーザーにエスカレーション |
| スキル | 用途 |
|---|---|
detailed-design-templates skill | 設計書・Issueテンプレート |
approval-gate skill | ユーザー承認ゲート |
workflow-phase-convention skill | Phase命名規約 |
github-graphql-api skill | Sub-issue登録 |
design-document-types skill | 設計書タイプ判定 |
wireframe-generator skill | Phase 1.5 モックアップ生成 |
| バージョン | 変更内容 |
|---|---|
| v2.10 | Phase 3の責任分離明確化（Issue重複作成防止）、test-spec-writerへのMUST NOT DO追加 |
| v2.9 | ドキュメント更新Issue自動作成 |
| v2.8 | Sub-issue登録をGraphQL APIに変更 |
| v2.7 | Sub-issue連携の自動化 |
| v2.6 | 既存システム影響分析の追加 |
| v2.5 | ASCII自動検証の追加 |
| v2.4 | ドキュメント計画フェーズ追加 |
| v2.3 | 画面設計書からASCII禁止 |
| v2.2 | フロントエンド設計書必須化 |