Communityコーディング&開発github.com

レビュースコープ

コード変更が意図されたスコープと要件に一致し、境界を超えていないことを検証します

レビュースコープ とは?

このスキルは、コード変更が指定された要件、制約、許可されたファイルの範囲内で正確に実装されていることを検証するためのパス/フェイルゲートです。開発者やAIエージェントは、TDD検証フェーズやPRレビュー時にこのスキルを活用し、スコープ漏れや過剰な変更を検出できます。実装計画や設計書、変更ファイルを入力として受け取り、各変更が許可されたファイルセットに含まれているか、要件に対応しているか、制約に違反していないかを自動でチェックします。違反があればファイルと行番号付きで報告し、必要に応じてリファクタリングの余地に関するフラグも出力します。このスキルは建設的なフィードバックやコードスタイルのレビューは行わず、純粋にスコープ準拠の二値判定に特化しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbgbt/bottlerocket-forest/tree/main/skills/review-scope

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

レビュースコープスキル

目的

コード変更が意図されたとおりの動作をすることを検証する — それ以上でもそれ以下でもありません。 これはパス/フェイルゲートであり、フィードバックセッションではありません。

使用するタイミング

  • TDD検証フェーズ
  • スコープ準拠のためのPRレビュー
  • スコープ検証が必要なコードレビュー全般

必要な入力

context_files

  • 実装計画または要件文書
  • 設計書(利用可能な場合)
  • レビュー対象の変更ファイル

context_data

  • commit_details: この変更が行うべきこと
  • requirements: 対応するREQ-*のリスト
  • constraints: 満たすべきCC-*制約のリスト
  • allowed_files: 変更が許可されるファイル(スコープ境界)

手順

1. スコープ境界の確立

入力から以下を特定する:

  • 実行しなければならないこと(要件)
  • 実行してはならないこと(制約)
  • 変更してもよいファイル
  • 期待される動作

2. 変更のレビュー

変更された各ファイルについて:

  1. このファイルは許可されたセットに含まれているか?
  2. 変更は明示された要件に対応しているか?
  3. 要件に関係ない変更が含まれていないか?
  4. 変更は制約に違反していないか?

3. 結果の報告

すべてのチェックに合格した場合:

ACCEPT

いずれかのチェックが失敗した場合、違反を列挙する:

VIOLATIONS:
- <ファイル>:<行> - <説明(自分の言葉で)>
- <ファイル> - <説明>

[オプション] THEMES: <注目に値するパターン>

違反の形式

違反は、場所と明確な説明を添えて自然に記述する:

- src/parser.rs:45 - コミットスコープに含まれないロギングインフラを追加
- src/config.rs - 許可セット外のファイルを変更

違反にまたがるパターンに気づいた場合は、それを指摘する:

THEMES: 複数の変更が、明示された要件を超えてエラーハンドリングのリファクタリングに及んでいる

最小変更バイアスチェック

実装エージェントは、目標を達成するために可能な限り最小の変更を行うバイアスを持っています。 違反を特定した後、次のことを考慮する:

違反は、コードをより保守しやすくするための潜在的なリファクタリングを示唆していないか? 実装者は、より良い構造的解決策を避けて、簡単な修正を優先していないか?

該当する場合は、REFACTORINGセクションにこれを記録する:

REFACTORING: <実装者が避けた構造的改善の説明>

これは違反ではなく、オーケストレーターが検討するためのフラグです。

このスキルが行わないこと

  • 違反に関係のない改善を提案する
  • 一般的な建設的フィードバックを提供する
  • コードスタイルをレビューする(その場合は review-style を使用)

これは二値ゲートです:ACCEPT または VIOLATIONS。リファクタリングノートはオプションのフラグであり、ブロッカーではありません。

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

ad-hoc-implementation-plan

Transform a rough plan into implement-commit ready artifacts. Allows rigorous review while implementing.

build-kit-locally

Build a kit and publish it to a locally hosted registry for development testing

build-variant-from-local-kits

Build a variant using locally published kits for development validation

deep-research

Create educational documents that build understanding progressively with citations

edit-spec-file

Edit Bottlerocket RPM spec files following project style conventions

fact-find

Quick lookup of specific facts about Bottlerocket with citations

idea-honing

Clarify feature ideas through iterative Q&A, recording insights to guide concept development

implement-commit

Implement commits from an implementation plan using a TDD pipeline

local-registry

Start and manage a local OCI registry for Bottlerocket kit development

prepare-core-kit-release

Prepare bottlerocket-core-kit for release by bumping version and updating changelog

propose-feature-concept

Create a new feature concept document to pitch the idea and explain the problem/solution

propose-feature-design

Create or update feature technical design document with architecture and implementation guidance

propose-feature-requirements

Create or update feature requirements specification using EARS notation with examples and appendices

propose-feature-test-plan

Create a test plan mapping EARS requirements and Critical Constraints to specific tests

propose-implementation-plan

Create an implementation plan with atomic commits that build toward a complete feature

review-code

Deep code review generating PR comments via principled question-driven analysis

review-style

Verify code follows project style guides without providing improvement suggestions

test-local-twoliter

Build and test local changes to twoliter before releasing

update-twoliter

Update all Bottlerocket repositories to a new Twoliter version

関連スキル