name: plan-review description: AI Translation Engine 2 専用。設計差分と docs 正本をレビューする。差分仕様、UI、シナリオ、ロジックの整合性を implementation 前に確認したいときに使う。
Plan Review
起動確認: このスキルが起動されたら、まず
invoked_skillがplan-reviewであることを確認する。不一致の場合は作業を開始せずエラーを返す。
この skill は設計差分と docs 正本の整合をレビューする skill。
change 文書、docs/ 正本、architecture を照合し、設計上の重大な欠陥から順に指摘する。
使う場面
- 実装前に設計レビューをしたい
logic.md/ui.md/scenarios.mdとdocs/のズレを見たい- docs 正本へ上げるべき仕様断片を確認したい
入力契約
plan-directionから渡された review 対象plan-direction以外から呼び出された場合は、plan-directionへ戻す handoff を返す。- 関連する
changes/文書 - 参照すべき
docs/正本 - review で重点確認したい論点
手順
- 関連する
changes/文書とdocs/正本を集める。 - 以下のアーキテクチャ定義およびコーディング規約に従っているかチェックする。
docs/governance/architecture/spec.mddocs/governance/backend-coding-standards/spec.mddocs/frontend/frontend-coding-standards/spec.md
- 責務逸脱、仕様未反映、未同期、シナリオ抜けの観点で見る。
- Findings を重大度順に並べる。
- 根拠となる文書位置を結び付ける。
- Open Questions と Residual Risks を分けて整理する。
plan-directionが docs sync 要否を判断できるよう、昇格候補があるかを明示する。
出力形式
score(0.0 - 1.0)- Findings を重大度順に並べる
- Open Questions を分ける
- Residual Risks を分ける
- docs 同期要否を最後に短く添える
参照資料
- findings 記録は
references/templates.mdを使う。
許可される動作
- 作業は対話内でタスク化し、常に 1 ステップずつ進める
- 実装差分の是正判断は
plan-directionまたは impl lane へ委ねる - まず findings を重大度順で出す
- 要約は findings の後に置く
- 問題なしならそれを明示する
- change 文書だけでなく
docs/正本との仕様差分も確認する - read-only で扱う
- 次工程へ渡す review は
score >= 0.85を満たすものに限る