| name | update-spec |
| description | .kiro/specs/ 配下の spec (requirements / design / tasks) を評価し、front/back/infra のソースと突き合わせて整合性を検証・改善するスキル。 |
update-spec スキル
.kiro/specs/<feature>/ の spec を 収集 → 評価 → 整合確認 → 改善提案 の
4 フェーズで点検する。
Phase 1: コンテキスト収集
- 対象 feature の
requirements.md / design.md / tasks.md を読む
- spec が触れる
front/ back/ infra/ のソースを読む
- 関連する
.kiro/steering/ の規約を読む
Phase 2: spec 品質評価 (100 点満点 / 5 カテゴリ)
各 20 点で採点。合計 90 点以上で construction 継続可。50 点未満は再設計。
| カテゴリ | 観点 |
|---|
| アーキテクチャ / 層境界設計 | front/back/infra の責務分離、層をまたぐ依存の妥当性 |
| API 契約 | front↔back の型整合 (OpenAPI)、back↔infra の構成整合 |
| ドメイン適合 / 要件トレース | requirements.md の EARS 要件と design/tasks の対応 |
| エラーハンドリング / 可観測性 | 異常系の設計、ログ・メトリクスの出力点 (監視システムゆえ重視) |
| テスト容易性 | vitest / pytest / cdk test のカバレッジ戦略、テスト追加箇所の具体性 |
Phase 3: 整合性チェック
- spec ↔ ソースの双方向比較 (spec 済みだが未実装 / 実装済みだが未 spec を列挙)
- spec ↔
.kiro/steering/ の規約整合
requirements ↔ design ↔ tasks 間の用語・データ型の不整合検出
Phase 4: 改善提案
- P0 (実装ブロッカー) / P1 (品質低下) / P2 (Nice to have) で分類
- 各指摘は「対象ファイル:行 → 問題 → 推奨修正」の形式で記述
出力テンプレート
## 評価サマリ
| カテゴリ | 点数 |
| --- | --- |
| アーキテクチャ / 層境界設計 | xx / 20 |
| API 契約 | xx / 20 |
| ドメイン適合 / 要件トレース | xx / 20 |
| エラーハンドリング / 可観測性 | xx / 20 |
| テスト容易性 | xx / 20 |
| **合計** | **xx / 100** |
## 主要所見
...
## spec ↔ ソース整合性
...
## 改善提案
- P0: ...
- P1: ...
- P2: ...