ホーム / 全スキル / ワークフロー＆基本ツール / caveman-review
English (EN)简体中文 (ZH)日本語 (JA)
ワークフロー＆基本ツール · juliusbrussee/caveman

caveman-review

指摘ごとに場所・問題・修正案を1行に凝縮したコードレビュー。/caveman-review、「review this PR」、「review the diff」で使用します。

L1 基本 · ソース登録のみV1 コミット固定Dual-pass Audit
Author juliusbrusseeGitHub juliusbrussee/caveman ↗Stars 104500License MIT + BSL-1.1 分拆（技能本体 MIT；GitHub API spdx NOASSERTION）。Commit 15581d1400
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

プロンプト完結型のレビュー出力圧縮機能：コアとなるのは出力フォーマットプロトコルであり、指摘1件につき1行「`L<行番号>: <問題>. <修正>.`」、複数ファイルの diff の場合は「`<file>:L<line>:`」のプレフィックスを付与します。

skills/caveman-review/SKILL.md
**Format:** `L<line>: <problem>. <fix>.` — or `<file>:L<line>: ...` when reviewing multi-file diffs.
自由記述の散文をフォーマットプロトコルに置き換え：場所＋問題＋修正案の3部構成により、レビューコメントを俯瞰しやすくPRへそのまま貼り付け可能な単一行へと圧縮します。

任意の重要度プレフィックス分類：🔴 bug / 🟡 risk / 🔵 nit / ❓ q の4段階を提供し、PR作成者が緊急度に応じてフィルタリングできるようにします。

skills/caveman-review/SKILL.md
`🔴 bug:` — broken behavior, will cause incident
4段階の定義それぞれにトリガー条件（インシデントに繋がる / 脆弱だが動作する / 無視可能なスタイル問題 / 提案ではなく純粋な質問）が定められており、複数の重要度が混在する場合にのみプレフィックスを付与します。

脱テンプレート表現ルール：削除すべき冗長なパターン（「I noticed that…」「You might want to consider…」、コード行の単なる復唱、曖昧な言い回し）を明示し、対応する✅の代替表現を提示します。

skills/caveman-review/SKILL.md
**Drop:** - "I noticed that...", "It seems like...", "You might want to consider..." - "This is just a suggestion but..." — use `nit:` instead -
各❌の例に対応する✅の単行書き換え例を用意し（例：「I noticed that on line 42 you're not checking if the user object is null…」→「L42: 🔴 bug: user can be null after .find(). Add guard before .email.」）、対比によって出力の習慣付けを行います。

技術的精度を担保する保持リスト：正確な行番号、バッククォートで囲んだシンボル名の維持、「consider refactoring」のような曖昧な表現ではなく具体的な修正案を提供します。

skills/caveman-review/SKILL.md
**Keep:** - Exact line numbers - Exact symbol/function/variable names in backticks - Concrete fix, not "consider refactoring this" -
圧縮するのはトーンや前置きのみであり、特定性（行番号やシンボル名）や実行可能性（具体的な修正方法）は一切圧縮しません。

Auto-Clarity 例外：CVEクラスのセキュリティ指摘、アーキテクチャ上の意見の不一致、新人への指導シーンでは完全な段落形式の記述にフォールバックし、その後に単行モードへと復帰します。

skills/caveman-review/SKILL.md
Drop terse mode for: security findings (CVE-class bugs need full explanation + reference), architectural disagreements (need rationale, not just a one-liner), and onboarding contexts where the author is new and needs the "why".
メインの caveman スキルの Auto-Clarity メカニズムと同等であり、リスクが高い場面や文脈理解が必要なシーンでは圧縮を行いません。

境界規律：レビューコメントのテキスト生成のみを行い、修正コードの記述、承認/却下、リンターの実行は行いません。出力はそのまま貼り付け可能です。

skills/caveman-review/SKILL.md
Reviews only — does not write the code fix, does not approve/request-changes, does not run linters.
スキルの位置づけはレビューのワークフローではなく「レビューの表現スタイル」です。アクション（承認/変更要求/ツールの実行）は明確に除外されており、純粋な出力フォーマットのガイダンスに特化しています。

2コア機能

011行形式のレビューコメント出力（`L<line>: <problem>. <fix>.`、複数ファイル時は file プレフィックス付き）
024段階の重要度分類（bug/risk/nit/q）
03定型句や曖昧な言い回し（hedging）の排除（不確実な場合は q: を使用）
04正確な位置情報と具体的な修正案の保持（行番号、シンボル名、修正アプローチ）
05Auto-Clarity：セキュリティ、アーキテクチャ、指導シーンにおける詳細な自動展開
06そのままPRに貼り付け可能なコメント出力（承認やツール実行は非対応）

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
自動ロード可能
管理者向け
ソースとバージョンの記録
判定根拠（ファイルパスと抜粋）
  • SKILL.md: プロンプト指示およびルールテキストのみで構成され、スクリプト実行や外部への影響はありません。
監査ノート： 純粋なインストラクション型スキルです。スクリプト実行、ネットワーク通信、認証情報利用、ローカル書き込みは一切ありません。出力はフォーマットに従って再構成されたレビューテキストのみであり、Auto-Clarity によりセキュリティ上の重大な指摘（CVE）は無理に圧縮されず詳細に展開されます。考慮事項は対話上のガイダンスのみであり、コードレベルのリスクは存在しません。

5二重目の独立検証

  • [ok] 纯 prompt、无脚本 — skills/caveman-review 目录 git ls-tree 仅 SKILL.md + README.md；无任何可执行文件。
  • [ok] 单行格式协议 — 原文 '**Format:** `L<line>: <problem>. <fix>.`' 存在；多文件变体 `<file>:L<line>:` 亦在。
  • [ok] 四档严重度 — 🔴 bug / 🟡 risk / 🔵 nit / ❓ q 四行定义逐字存在。
  • [ok] Drop/Keep 清单 — 'Drop:' 下列出 I noticed that… 等套话与复述代码行；'Keep:' 下列出精确行号/符号名/具体修法。
  • [ok] Auto-Clarity 例外 — 原文含 security findings (CVE-class…)/architectural disagreements/onboarding contexts 三类展开条件。
  • [ok] 边界声明与源码一致 — 'does not write the code fix, does not approve/request-changes, does not run linters' 逐字在——无任何工具调用指令。
  • [ok] 外部依赖为空 — 文件级扫描 URL/CLI/API 零命中；无 linter/CI/评审平台依赖。
  • [ok] meta 元数据 — 与 caveman 同仓库：stars 104500、pushed_at 2026-09-09、本地 HEAD==origin/main==pin 15581d1；技能 MIT 面。

6結論

  • 極めて実行しやすい出力プロトコル：単行の「場所/問題/修正」構成により、レビューコメントの俯瞰、フィルタリング、PRへの直接貼付が容易になります。
  • 重要度分類によるノイズ削減：PR作成者は 🔵 nit を無視して 🔴 bug だけに集中できます。
  • 具体例を伴う脱定型句ルールにより、モデルのアライメントが容易です。
  • セキュリティ上の指摘は圧縮対象外：CVEクラスの問題には完全な説明とリファレンスを提供します。
  • クリーンな責務境界：コード改変、承認、ツール実行に踏み込まず、純粋な出力スタイルとして機能します。
    • 最適な用途： 「短く、俯瞰しやすく、PRにそのまま貼れる」レビュースタイルを求める開発者のコードレビューセッション（/caveman-review、「review this PR」、「review the diff」）に最適です。また、コードベースにすでに精通しており、問題箇所と修正のヒントだけを必要とするレビュアーやPR作成者にも適しています。
    不向きな用途： 完全な論証が必要とされるセキュリティ監査やアーキテクチャレビューには不向きです（Auto-Clarity で展開されるものの、全体の出力は単行ベースの傾向があります）。また、新人のオンボーディングなど教育的レビュー（全項目を展開するとコストが高くなる）や、リンターの自動実行・承認処理・コード修正のコミットなどをスキルに期待するワークフロー（明確にテキスト出力のみに限定されています）には適していません。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload caveman-review.tar.gz
    sha256: 94f8129bf1ddbecf…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 15581d1400.