mcpField
Q
quality

quality

github.com/potetoテスト・品質564242 回インストール32 週間前に更新
リポジトリ

quality について

完了した Cook の作業を審査する品質レビュー用スキルです。変更範囲、コード品質、原則への準拠、テスト証拠、実行時検証を順に確認し、承認または却下の評価を通知します。

主な機能

  1. 01計画範囲と変更内容の照合
  2. 02Go のチェックとテストの実行
  3. 03プロジェクト原則に基づく変更レビュー
  4. 04新規テストと境界ケースの確認
  5. 05実行時検証の証拠確認
  6. 06レビュー判定イベントの発行

活用シーン

  1. 01Cook ステージで完了したコード変更の審査
  2. 02計画範囲外のファイル変更の発見
  3. 03具体的な指摘に基づく作業の承認または却下

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/poteto/noodle --skill quality

インストール後、Claude Code で/qualityを入力して読み込まれたか確認します。

同梱ファイルreferences/stage-message-schema.md

詳細

品質

完了した調理作業をレビューします。評価を含む stage_message イベントを出力してください。イベントのスキーマについては、references/stage-message-schema.md を参照してください。

完全に自律して作業してください。ユーザーに質問してはいけません。

ステップ 0 — 原則を読み込む

brain/principles.md を読み、すべての [[wikilink]] に従ってください。これらはレビューの指針です。省略してはいけません。

評価パイプライン

順番に実行してください。重大度の高い指摘事項があれば、その時点で停止して却下してください。

1. スコープの確認
  • 調理担当に割り当てられた計画フェーズを確認します(調理担当の最初のプロンプトまたは mise コンテキストから)。
  • 調理担当のコミットについて、git diff --stat と git log --oneline を実行します。
  • 計画フェーズで定められたスコープ外の変更ファイルがあれば、スコープ違反として指摘します。
2. コード品質
  • go vet ./... と go test ./... が成功しなければなりません。
  • sh scripts/lint-arch.sh が存在する場合は実行します。
  • エラー処理がプロジェクトの規約(期待を示すメッセージではなく、失敗状態を示すメッセージ)に従っているか確認します。
3. 原則への準拠
  • 変更されたファイルごとに、読み込んだ原則に照らして確認します。
  • よくある違反:再設計ではなく変更を後付けしている(redesign-from-first-principles)、検証が不足している(prove-it-works)、不必要に複雑さを加えている(subtract-before-you-add)。
4. テストの証拠
  • 新しい動作には、新しいテストが必要です。
  • テストでは実装の詳細ではなく、結果を検証しなければなりません。
  • 計画フェーズで言及されているエッジケースが網羅されているか確認します。
5. 実行時の検証
  • 計画フェーズで実行時の確認が指定されている場合は、実施されたことを検証します。
  • 「コンパイルできる」だけでは検証になりません。

判定

評価を含む stage_message イベントを出力してください。

noodle event emit --session $NOODLE_SESSION_ID stage_message --payload '<json>'

承認:blocking: false を指定して出力します。パイプラインが続行され、スケジューラーに承認が伝わります。

{ "message": "All checks pass. Tests green, scope clean.", "blocking": false }

却下:blocking: true を指定して出力します(または blocking を省略します)。スケジューラーは指摘事項を読み、対応(再試行、oops ステージの追加、または中止)を判断します。

{ "message": "Rejected: 3 high issues. [1] Missing test for edge case in handleCompletion. [2] Scope violation: modified cook_merge.go outside plan phase scope. [3] Error message uses expectation form.", "blocking": true }

スケジューラーが対応できる自然な文章でメッセージを記述してください。再試行する調理担当に指示できるよう、具体的なファイルパス、行の文脈、原則違反を含めてください。

ブロック対象外の問題

却下するほどではない問題(スタイル上の細かな指摘、軽微な改善、ドキュメントの不足)は、バックログアダプターを使ってバックログ項目として登録してください。

原則

  • [[prove-it-works]]
  • [[outcome-oriented-execution]]

コメント