spec-peer-review

仕様のピアレビュー

ユーザーが独立したレビューを依頼した場合に限り、保存済みの設計をレビューします。現状のままレビューすることへの既存の承認を尊重します。選択された指摘事項のみを反映し、追加のラウンドはオプトインとします。

入力と出力

• リクエストまたは現在のコンテキストから仕様を特定します。曖昧な場合にのみ確認します。
• 追加のコンテキストと出力ディレクトリを受け付けます。デフォルトでは、.compozy/tasks/<slug>/ の場合は仕様の qa/ ディレクトリ、それ以外の場合は .peer-reviews/<UTC-timestamp>/ を使用します。
• 設定されたレビュアーのランタイム／モデルと推論設定を使用します。明示的な上書きが優先されます。過去のモデルを固定したり、ユーザーが選択したモデルを暗黙に置き換えたりしないでください。
• 各ラウンドにつき、指摘事項の成果物を1つだけ作成します。<out>/peer-review-findings-roundN.md とします。過去のラウンドは保持します。

レビュー

1. 仕様と、リンクされている契約インデックスを読みます。関連する要件、具体例、テスト契約、ADRの決定事項、影響を受けるサーフェス向けの指示を含めます。依存関係や矛盾を確認する必要がある場合は、他のコンテキストも調べます。すべてのメモリファイルを読み込まないでください。

2. references/quality-markers.md の該当するマーカーを使用します。契約の欠落は指摘事項とし、依頼されたレビューを自動的に中止する理由にはしません。

3. references/peer-review-prompt.md を読み、正確な指摘事項のパス、ラウンド、特定済みのランタイム／モデル、コンテキストのパスなど、プレースホルダーをすべて埋めます。レビュアーが書き込めるのは、その指摘事項ファイルのみです。

4. 利用可能な独立レビュアーのランタイム（設定済みのネイティブレビュアー、Compozy セッション、または herdr TUI）を通じて起動します。そのランタイムのドキュメントに記載されたコマンドを使用し、廃止された compozy exec API が使えると想定しないでください。追加ラウンドでは、利用可能な場合、既存のワーカー ID を引き継ぎます。

5. 指摘事項、引用された根拠、変更されたパスを確認します。成果物を検証します。

   bash <skill-dir>/scripts/validate-findings.sh --kind techspec --round <N> --path <out>/peer-review-findings-roundN.md
   

6. 判定、重要な指摘事項、制限事項、成果物のパスを報告します。出力がない、または不正な形式の場合、レビューは未完了であり、決して READY とはしません。許可されたラウンド内で運用上の問題を修正します。実質的な追加ラウンドを自動的に開始しないでください。

7. ユーザーが選択した指摘事項のみを適用し、変更されたパスとともに処理内容を記録します。すでに与えられた承認を再利用し、まだ選択が必要な場合に限り確認します。次のラウンドを明示的に依頼された場合は、変更されたファイル、過去の指摘事項と処理内容、新しい出力パスを渡し、変更のないコーパスを再度渡さないでください。

このスキルは、コミット、公開、設計の承認を許可するものではありません。実際の製品／セキュリティ／互換性に関する制約は準備完了を妨げることがありますが、形式的なセクションの欠落や文体上の好みはその理由になりません。