Menu
設計書を作成・更新した後に発動。100点満点で自己評価し、不足点をタスクリストにして設計書を改善。矛盾や収載漏れがないことを最終確認する。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | update-design |
| description | 設計書を作成・更新した後に発動。100点満点で自己評価し、不足点をタスクリストにして設計書を改善。矛盾や収載漏れがないことを最終確認する。 |
設計書（docs/design/*.md）を作成・更新した直後に実行する。
設計書の品質を100点満点で自己評価し、不足点を特定・改善し、最終的に矛盾や漏れがないことを確認する。
ultrathink
引数で指定された設計書、または直前に作成・更新した設計書を特定する。
# 引数がない場合、最近変更された設計書を特定
git diff --name-only HEAD~3 -- docs/design/
対象の設計書を全文読み込む。同時に、関連するソースコードも確認する。
確認対象:
docs/design/<feature>.md）docs/requirements.md）との整合性src/ 配下）以下の10カテゴリ × 10点満点で評価する。各カテゴリの採点基準に従い、厳密に採点すること。
| # | カテゴリ | 配点 | 評価観点 |
|---|---|---|---|
| 1 | 基本構造 | 10点 | 必須セクション（概要・コンポーネント設計・実装詳細・テスト・セキュリティ）が揃っているか |
| 2 | 目的・スコープの明確性 | 10点 | 何を実装するか、何を実装しないかが明確か。読み手が迷わないか |
| 3 | コンポーネント設計の完全性 | 10点 | Inkコンポーネントの Props 型定義、状態管理、レンダリングロジックが網羅されているか |
| 4 | AWS SDK連携設計 | 10点 | CodeCommit API呼び出し、認証フロー、エラーハンドリング、モック方針が明記されているか |
| 5 | 内部アーキテクチャ | 10点 | ファイル構成、コンポーネント階層、データフロー等が記述されているか |
| 6 | エッジケース・異常系 | 10点 | 境界条件、エラー処理、不正入力への対処が考慮されているか |
| 7 | テスト戦略 | 10点 | ユニットテスト・スナップショットテストの方針と具体的なテストケースがあるか |
| 8 | セキュリティ考慮 | 10点 | AWS認証情報の取り扱い、入力検証、権限管理等が検討されているか |
| 9 | 技術選定の根拠 | 10点 | Ink・React・AWS SDK v3の活用方針、採用・不採用の理由が明記されているか |
| 10 | 実装計画 | 10点 | Phase/Iteration分割、ファイル構成、依存関係が具体的か |
| 点数 | 基準 |
|---|---|
| 9-10 | 模範的。実装着手に必要な情報が全て揃っている。追加すべき内容がない |
| 7-8 | 良好。軽微な追記で完成する |
| 5-6 | 普通。重要な情報が一部欠けている |
| 3-4 | 不十分。大幅な追記が必要 |
| 1-2 | 骨格のみ。ほぼ未記述としない |
| 0 | セクション自体が存在しない |
各カテゴリを採点し、以下のフォーマットで結果を出力する。
## 自己評価結果
| # | カテゴリ | 点数 | 評価コメント |
|---|---------|------|-------------|
| 1 | 基本構造 | X/10 | ... |
| 2 | 目的・スコープの明確性 | X/10 | ... |
| 3 | コンポーネント設計の完全性 | X/10 | ... |
| 4 | AWS SDK連携設計 | X/10 | ... |
| 5 | 内部アーキテクチャ | X/10 | ... |
| 6 | エッジケース・異常系 | X/10 | ... |
| 7 | テスト戦略 | X/10 | ... |
| 8 | セキュリティ考慮 | X/10 | ... |
| 9 | 技術選定の根拠 | X/10 | ... |
| 10 | 実装計画 | X/10 | ... |
| | **合計** | **XX/100** | |
8点未満のカテゴリを改善対象として抽出し、優先度を付ける:
Phase 2の評価結果からタスクリストを作成する。TodoWriteツールを使用してタスクを管理する。
タスクの粒度:
タスクリストに従い、設計書を更新する。
更新ルール:
タスクを1つ完了するごとに:
設計書の更新が完了したら、全文を再読して以下を検証する。
docs/requirements.md）の機能スコープと、設計書の記述が矛盾していないか既に実装が存在する場合:
src/ のソースコードと一致しているか矛盾や漏れが見つかった場合:
問題がなくなるまで繰り返す（最大3回）。
最終的な評価結果をユーザーに報告する。
報告フォーマット:
## 設計書評価レポート: <設計書名>
### 初回評価: XX/100点
### 改善後評価: YY/100点
### 改善内容
- <改善1>
- <改善2>
- ...
### 最終検証結果
- 内部一貫性: ✅ / ⚠️（詳細）
- 収載漏れ: ✅ / ⚠️（詳細）
- ソースコード整合性: ✅ / ⚠️（詳細） / N/A（未実装）
docs/requirements.md）のフォーマットを参考に新規作成を提案する