Standard Review Policy for Downstream
Skill7 starsChanged 5 months agoMITView on GitHub
Applies standard AI review policy guidelines for downstream (test/QA) phase reviews.
In this repository140 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .codex/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- static/llms.txtllms.txt
- ask-codexSkill
- river-review-disciplineSkill
- skill-creatorSkill
- skill-ops-plannerSkill
- skill-optimizerSkill
- commandsSkill
- adversarial-reviewSkill
- review-teamSkill
- river-review-architectureSkill
- river-review-codeSkill
- river-review-docsSkill
- river-review-frontendSkill
- river-review-performanceSkill
- river-review-security-auditSkill
- river-review-securitySkill
- river-reviewSkill
- river-review-testingSkill
- unknown-coverage-reviewSkill
- Coverage and Failure Path GapsSkill
- Flaky Test Risk CheckSkill
- GitHub Actions Workflow Security ReviewSkill
- Test Assertion Effectiveness 常に PASS するテストの検出Skill
- Test Presence for Changed CodeSkill
- Test Naming and StructureSkill
- テスト観点レビュー(差分ドリブン)Skill
- a11y Accessible Name BasicsSkill
- Agent Skill Bridge ReviewSkill
- Altitude Generalization GuardSkill
- API Compatibility and Test Gap ReviewSkill
- Assumption Resolution Trace Plan の前提解消トレーサビリティSkill
- Async Correctness 非同期処理の正しさ検証Skill
- Behavior-Structure Separation 振る舞い変更と構造変更の分離・外部挙動維持Skill
- Closure Scope Retention GuardSkill
- Component Variants / States Documentation コンポーネント状態の文書化Skill
- Configuration File ReviewSkill
- Cross-File Leakage リファクタ後の caller 側残骸検出Skill
- Design Source-of-Truth Conformance デザイン定義準拠Skill
- Design System Component Reuse GuardSkill
- Design Token EnforcementSkill
- Detector Detection Power 検査器の検出力の検証Skill
- Documentation Hygiene ドキュメント衛生Skill
- End-to-End Wiring 末端到達・貫通の検証Skill
- Existing-Pattern Conformance 既存パターン準拠の確認Skill
- Firebase Security Rules ReviewSkill
- Fix Scope Integrity 指摘対応ループのスコープ逸脱・前提破壊検出Skill
- GitHubレビューコメント対応(修正案つき)Skill
- Hallucinated Reference 幻覚的参照の実在確認Skill
- Hello Skill (Always-On Sample)Skill
- i18n Unused Key ReviewSkill
- Impact Evidence Coverage 影響・失敗系・外部依存の証拠充足Skill
- Independent Review SynthesisSkill
- Invisible Unicode Injection Scan 不可視 Unicode コード注入検出Skill
- Knowledge-to-Code Alignment 新知識のコード反映・設計知識の保全Skill
- Laravel Eloquent N+1 and Query Efficiency ReviewSkill
- Laravel Mass Assignment and Authorization ReviewSkill
- The first 60 shown.
The file
Files
Goal / 目的
- テスト/QA フェーズの差分に対して、テスト不足・失敗系の抜け・フレークのリスクを短く指摘する。
Non-goals / 扱わないこと
- 変更と無関係な “テストを増やすべき” の一般論を言わない。
- プロジェクトのテスト方針(E2E/Unit 比率など)を断定して押し付けない。
False-positive guards / 抑制条件
- 変更がテストの整形/リネームのみで、意味的な変更がない場合は深入りしない。
- テスト観点が不確実な場合は、欠陥ではなく質問として提示する。
Rule / ルール
- 指摘は差分に紐づける(根拠は
<file>:<line>)。 - 優先する観点は「失敗系」「境界」「クリティカルパス」(例: 認証、課金、データ整合性、権限)。
- 可能なら最小の追加テスト案を 1 つ添える(大改造ではなく追加 1 ケース)。
Evidence / 根拠
- 追加/変更された分岐や例外パスに対して、対応するテスト差分がない点を根拠として示す。
Output / 出力
- 各指摘を 1 行で出力する:
<file>:<line>: <message> <message>は日本語で簡潔に(目安: 200 文字以内)。- PR の本文(説明)と PR コメント(レビューコメント)は日本語で書く。
- 最大 8 件。指摘がなければ
NO_ISSUESのみ。
Heuristics / 判定の手がかり(例)
- 新規/変更された分岐に対するテストが増えていない
- 例外/エラー戻りのアサーションがない(メッセージ、ステータス、code など)
- 時刻/乱数/外部依存でフレークしやすい構造になっている(固定化/モック不足)
- セットアップが重複し、テスト意図が読み取りにくい
評価指標(Evaluation)
- 合格基準: 指摘が差分に紐づき、根拠と次アクションが説明されている。
- 不合格基準: 差分と無関係な指摘、根拠のない断定、抑制条件の無視。
人間に返す条件(Human Handoff)
- 仕様や意図が不明確で解釈が分かれる場合は質問として返す。
- 影響範囲が広い設計判断やトレードオフは人間レビューへ返す。
レビュー姿勢(Standard of Code Review)
- テスト / QA レビューでも完璧を求めず、「このテスト追加 / 修正が回帰検出と保守性を改善するか」を判断軸にする (
google/eng-practicesの "Improve the overall code health" 原則)。 - テスト観点では「意味のある assertion」「flaky 回避」「適切な scope (unit / integration / e2e)」を最優先する。命名やフォーマットは nit 扱い。
- nit / 好み相当の指摘は
severity: minor以下に留める。詳しい対応表はdocs/development/google-eng-practices-mapping.mdを参照する。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

