Menu
docs/dev/spec.ja.md の設計書を 5 カテゴリ×20点で評価・改善し、ソースコードとの齟齬を双方向で検出する。設計レビューや実装着手前の品質確認、user が「/update-design」と言ったときに発動する。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | update-design |
| description | docs/dev/spec.ja.md の設計書を 5 カテゴリ×20点で評価・改善し、ソースコードとの齟齬を双方向で検出する。設計レビューや実装着手前の品質確認、user が「/update-design」と言ったときに発動する。 |
chokkin（Python 向け静的到達可能性解析ツール）の設計書 docs/dev/spec.ja.md を
体系的に評価・改善するスキル。4 フェーズで検証する。
docs/dev/spec.ja.md（§1–§21）と src/ の API を対応付け、モジュール階層
（cli/config/manifest/parser/resolver/graph/rules/reporters/fix/plugins）の
依存関係を確認する。Cargo.toml の lint 設定（unsafe forbid、unwrap/expect/panic 禁止）
も前提として押さえる。
5 カテゴリ × 20点で採点する:
| カテゴリ | 評価観点 |
|---|---|
| モジュール / struct 設計 | Rust の境界が明確か、lib.rs 中心の構成か |
| 静的解析制約 | Python コードを実行しない設計が貫かれているか（import/exec/spawn 禁止） |
| ルール / ポリシー | CHK001–CHK010 の判定ロジックと既定挙動が妥当か |
| エラー処理 | Result/Option 伝播、unwrap 回避、終了コード規約の遵守 |
| テスト容易性 | カバレッジ維持戦略、parser/graph のテスト設計 |
設計書とソースコード間の齟齬を双方向で検出する:
src/ の実装変更を README.md / README.ja.md / docs/dev/ / CLAUDE.md / AGENTS.md に同期する。コード変更後やドキュメントの陳腐化が疑われるとき、user が「/update-docs」と言ったときに発動する。
タスク完了時に simplify と update-docs を順に実行し、最後に /compact のリマインドを出す。Stop hook の block reason から起動されるか、user が「タスク完了」「/wrapup」と言ったときに発動する。
プランや設計について、共通理解に達するまで user を徹底的に問い詰める。決定木の各分岐を 1 つずつ解消する。プランをストレステストしたいとき、設計をレビューさせたいとき、user が「grill me」と言ったときに発動する。
プランモード完了直前に、プランファイルの品質を update-design 同等の基準で検証・改善し、合格してから ExitPlanMode を呼ぶ統合スキル。プラン確定前、user が「/update-plan」と言ったときに発動する。
