オプション

バグ、回帰テスト、テスト、および基準に対する構造化されたコードレビュー。PR前またはレビュー依頼時に使用;インタラクティブモードではローカルで修正可能、mode:agentはパイプライン呼び出し元に対してのみ報告を行う。

...すべて拡張します
11
更新された時間 2026年8月26日

ce-code-review について

動的に選択されたレビュアーペルソナを使用してコード変更を評価する、構造化されたコードレビュースキルです。並列サブエージェントを起動して構造化された JSON を返させ、それらの結果をマージおよび重複排除して単一のレポートに統合します。これは、プルリクエストを作成する前、反復的な実装中にタスクを完了した後、または変更に対するフィードバックが必要な場合に実行することを意図しており、スタンドアロンで呼び出したり、より大きなワークフロー内に埋め込んだりすることができます。

2つの動作モードが同じレビューパイプラインを共有しています。デフォルトのインタラクティブモードでは、パイプ区切りで見つかった項目のテーブルと実行可能な項目の概要を含む Markdown レポートを生成し、プリレビュー作業ツリーがクリーンな場合に安全で検証済みの修正を適用してコミットします。mode:agent モード(mode:headless は非推奨のエイリアス)ではレポートのみを行い、プログラムmatic およびクロスハッチ呼び出し元のための決定論的な契約として単一の JSON オブジェクトを返し、作業ツリーを変更せず、適用は呼び出し元に委ねます。中核となる動作原則は「ローカルで適用する;決してプッシュしない」であり、どのモードでもプッシュも、PR の作成も、チケットの提出も行いません。また、ブロッキングプロンプトを回避し、ブランチを切り替えることもありません。PR 番号、URL、またはブランチ名を渡すのはレビュー範囲を選択するためだけであり、ツリーを変更する権限を与えるものではありません。引数は base:、plan:、grouping:auto/off/always などのトークンに対して解析され、レビュアーをディスパッチする前に実行を停止する明確な競合ルールがあります。

見つかった項目は P0-P3 の重大度スケールを使用し、緊急性に答えます。autofix_class(gated_auto、manual、advisory)と owner は、適用権限を付与するのではなく、フォローアップの形状を記述します。合成(Synthesis)が最終的な経路を所有し、意見が分かれた場合はより保守的な経路を選択し、safe_auto などの安全でないクラスを拒否します。クイックレビューのショートサーキットは、ハッチの組み込みレビューに委譲して高速で軽量のレビューを行いますが、mode:agent は常にフルマルチエージェントパイプラインを実行し、JSON を返します。

FAQ

デフォルトモードと mode:agent の違いは何ですか?

デフォルトのインタラクティブモードは Markdown レポートを返し、安全で検証済みの修正を適用します(ツリーがクリーンな場合にコミットします)。mode:agent はレポートのみを行い、単一の JSON オブジェクトを返し、作業ツリーを変更せず、適用は呼び出し元に委ねます。

このスキルは変更をプッシュしたり、プルリクエストを作成したりしますか?

いいえ。中核となる原則は「ローカルで適用する;決してプッシュしない」であり、どのモードでもプッシュも、PR の作成も、チケットの提出も行いません。なぜなら、プッシュはユーザーが所有する外向きのステップだからです。

PR 番号やブランチ名を渡すと、そのブランチをチェックアウトしますか?

いいえ。PR 番号、URL、またはブランチ名を渡すのはレビュー範囲を選択するためだけです。gh pr checkout、git checkout、または git switch を実行することはありません。ブランチ上のローカル作業をレビューするには、自分でチェックアウトする必要があります。

重大度スケールはどのような意味を持ち、自動修正とはどう関係しますか?

重大度は P0(重要:マージ前に修正必須)から P3(軽微:ユーザーの裁量)まで続き、緊急性に答えます。autofix_class と owner フィールドは適用権限ではなく、フォローアップの形状を記述するものであり、適用の判断は合成段階で行われる裁量です。

フルマルチエージェントパイプラインではなく、クイックレビューを受け取ることができますか?

はい。引数がクイック、高速、または軽量のレビューを示し、mode:agent がアクティブでない場合、ハッチの組み込みコードレビューを実行して停止します。mode:agent はこのショートサーキットを常にバイパスし、フルパイプラインを実行します。

すべてのファイル

24 filesreferences/personas/julik-frontend-races-reviewer.md3.2 KBViewreferences/personas/maintainability-reviewer.md4.8 KBViewreferences/personas/previous-comments-reviewer.md3.3 KBViewreferences/personas/reliability-reviewer.md3.3 KBViewreferences/personas/swift-ios-reviewer.md10.5 KBViewreferences/review-output-template.md12.6 KBViewreferences/validator-template.md5.1 KBViewreferences/action-class-rubric.md1.5 KBViewreferences/findings-schema.json8.4 KBViewreferences/personas/adversarial-reviewer.md7.8 KBViewreferences/personas/api-contract-reviewer.md3.3 KBViewreferences/personas/data-migration-reviewer.md4.8 KBViewreferences/diff-scope.md2.4 KBViewreferences/persona-catalog.md5.4 KBViewreferences/personas/agent-native-reviewer.md9.1 KBViewreferences/personas/correctness-reviewer.md3.5 KBViewreferences/personas/deployment-verification-agent.md4.9 KBViewreferences/personas/learnings-researcher.md16.1 KBViewreferences/personas/performance-reviewer.md3.5 KBViewreferences/personas/project-standards-reviewer.md6.6 KBViewreferences/personas/security-reviewer.md3.7 KBViewreferences/personas/testing-reviewer.md3.8 KBViewreferences/subagent-template.md20.5 KBViewSKILL.md67.0 KBView

GitHubで見る

Setup

Run this once at the start of this invocation, before any subagent dispatch, and follow the directives it prints — except where one conflicts with this skill's own rules on asking the user questions, whether those rules are scoped to a non-interactive mode or apply in every mode, in which case this skill's rules win and no blocking question is asked. Run the fence exactly as written, as its own command: do not pipe or filter it (no head, tail, or grep), do not truncate its output, and do not bundle it into a batch with other commands. Its output opens with a === skill context header and ends with CE_CONTEXT_END; if you received one of those lines without the other, the output was truncated — rerun the fence verbatim once. That recovery is the only rerun: otherwise do not rerun it within the same invocation; a later invocation of this or any other skill runs its own. If no Node runtime is available the skill proceeds unchanged.

SKILL_DIR="<absolute path of the directory containing the SKILL.md you just read>";NODE="$(for c in node nodejs; do command -v "$c" >/dev/null 2>&1 && "$c" -e '' >/dev/null 2>&1 && { echo "$c"; break; }; done)";if [ -n "$NODE" ]; then"$NODE" "$SKILL_DIR/scripts/context.mjs" || echo "context script failed; continue with the skill's normal behavior";elseecho "no Node runtime; continue with the skill's normal behavior";fi

Artifact Root

Resolve the CE artifact root <root> before composing any artifact path.

  • Read docs_root from <repo-root>/.compound-engineering/config.yaml only (<repo-root> = git rev-parse --show-toplevel). Do not read it from config.local.yaml. Unset -> <root> is docs, exactly as before.
  • Validate a set value: a repo-relative directory whose real, symlink-resolved path stays inside the repo and is neither the repo root nor under .git/. Otherwise stop with an error naming docs_root and the value -- never fall back to docs.
  • Use <root> as the sole artifact location: create it if absent, compose each path as <root>/<subdir> with this skill's own subdirectory, and never also read docs.

Execution spine

Follow these steps in order; the references supply the detail but never change the order. Each reference named below is a required read for its step: load it before doing that step's work.

  1. Read references/modes-and-output.md first. It settles what the arguments mean, which argument conflicts stop the run before any reviewer is dispatched, whether the quick-review short-circuit applies, and what this invocation returns.
  2. Stage 1. Read references/scope.md and resolve the reviewed diff, the scope mode, and the deterministic scope signals.
  3. Stage 2. Read references/intent-and-plan.md, write the intent summary every reviewer receives, and discover the plan Stage 6 verifies requirements against.
  4. Stage 3. Read references/persona-catalog.md and references/select-and-route.md, then select the risk-driven reviewer roster, discover applicable standards paths, and bind the adversarial route.
  5. Stage 3d. When adversarial is selected for a local reviewed tree, start and persist the sanctioned cross-model job that references/cross-model-review.md defines, before any local persona dispatch. Invoking this skill is itself the authorization for its configured or allowlisted peer route, once you have made the required disclosure of the recipient and of the code that leaves the machine. Do not ask the user to confirm a second time, and do not skip the peer because the user did not repeat that authorization. An explicit user prohibition on external review overrides it, as does a checkout that sets cross_model_review_mode: off with no live opt-in; both are resolved before you bind a route. A started peer replaces the local adversarial persona at this stage, and only a real failure to scope, allowlist, reach, authenticate, or start it leaves the local fallback in the roster; a later stage may still restore the local reviewer under the conditions that reference states.
  6. Stage 4. Read references/dispatch-reviewers.md. Dispatch the materialized local roster as one foreground concurrent batch sized to the host's active-agent cap, and collect every reviewer before synthesis however this host returns them: one blocking wait where same-message calls run concurrently, repeated non-polling collection waits where the subagent primitive is asynchronous, and serial dispatch where neither applies. Detaching local review into a polled background job is forbidden. The cross-model peer is the only detached work, and it may overlap this batch.
  7. Stages 5 and 6. Once the reviewer returns are ready, read references/finish-review.md. Fold in the peer once, run the documented findings mechanics, and run every validator the reference selects; only then return the report. Never synthesize directly from raw reviewer artifacts. In the multi-agent path, emit only this skill's report: do not also invoke a harness-native findings or reporting tool, which belongs to the quick-review short-circuit alone.

Operating principles

  • Report-only by default; never push. A bare ce-code-review invocation produces findings and does not apply them. Entering the apply stage requires apply:local, or an explicit user request in the invoking prompt to apply or fix this review's findings; a deprecated mode:autofix token is neither. mode:agent never mutates the tree, even when nested inside a workflow that later applies findings. Never push, open PRs, or file tickets in any mode.
  • No blocking prompts. Never use AskUserQuestion, request_user_input, ask_user, or other blocking question tools. Infer intent, plan, and scope from explicit tokens, git state, PR metadata, and conversation. Note uncertainty in Coverage or the verdict — do not stop to ask.
  • Explicit mutations only. Never run gh pr checkout, git checkout, git switch, or similar branch-switch commands. Passing a PR number, URL, or branch name selects review scope, not permission to mutate the working tree. Uncommitted work can only be reviewed from the checkout that holds it, so to review it on a feature branch, stay on that branch (or check it out yourself) and pass base: or no target.
  • Report outcomes, not machinery. What you show the user is about the review: what is being examined, which coverage is included and the one-line reason for each conditional lens, the independent cross-model pass, and the findings. Name what the user would recognize — a PR number, a reviewer's concern, a peer model — rather than this skill's plumbing, whose internal labels, dispatch bookkeeping, and setup narration stay out of user-facing text. Never claim more about the peer than its receipt attests. This governs what you surface and suppress, not the wording; use your own voice.

Task Visibility

For the multi-agent path, once the review scope is resolved, use the platform's task-tracking capability when available to show a short user-facing view derived from the execution spine. Track review outcomes, not individual personas, setup mechanics, or tool calls; add conditional work only when its gate fires, and update the view at meaningful transitions. If no task-tracking capability is available, continue with the normal progress and final report without simulating a task list in chat.

すべてのファイル

0件のファイル

ce-code-reviewをインストール

スキルファイルをダウンロードして、.claude/skills/ ディレクトリに展開してください。

ZIPをダウンロード

リポジトリをクローンし、スキルファイルをプロジェクトにコピーしてください。

git clone https://github.com/EveryInc/compound-engineering-plugin/blob/main/skills/ce-code-review/SKILL.md # Copy SKILL.md to your .claude/skills/ directory

コピー コピー
クイックセットアップ: スキルフォルダを .claude/skills/ にコピーしてください。Claude はそのスキルを自動的に検出し、使用します。

関連スキル

code-simplify
更新された時間 2026年7月2日
requesting-code-review
更新された時間 2026年6月29日
Git Commit Helper
更新された時間 2026年6月29日
commit-standards
更新された時間 2026年6月29日
OR