agentleFS
jam7jam7/ai-dev-gates/.claude/skills/self-review/SKILL.md

self-review

Skill0 starsChanged 3 months agoMITView on GitHub

Attach a structured self-review to any non-trivial design or patch before presenting it, so the human can review by focus points instead of reading everything. Use when presenting a patch, design, or multi-file change for human review, or when the user asks "review this before I look".

51 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use latex-formatting, novelty-assessment and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • lingzhi227Skill

    latex-formatting

    Handle LaTeX formatting, templates, and styling for academic papers. Set up conference templates (ICML, ICLR, NeurIPS, AAAI, ACL), fix formatting issues, manage packages, and ensure venue-specific compliance. Use when the user needs to set up a paper template, fix LaTeX formatting, or prepare for submission.

    Also in 4 projects that use this

  • lingzhi227Skill

    novelty-assessment

    Assess research idea novelty through systematic literature search. Multi-round search-evaluate loops with harsh critic persona. Binary novel/not-novel decision with justification. Use before committing to a research direction.

    Also in 4 projects that use this

  • michaelboedingSkill

    slide-generation

    Use this skill to create presentation slides from structured content. Triggers: "create slides", "generate presentation", "make powerpoint", "create pptx", "build slides", "presentation from content", "slide deck", "slides for" Outputs: PPTX files, Markdown slides, or HTML presentations. Used by: pitch-deck-agent, market-researcher-agent, and other agents needing slides.

    Also in 4 projects that use this

  • juanlurgSkill

    paper-to-code

    Reads a research paper and generates an implementation notebook with equations, code, and a toy example. Use when the user wants to implement a paper, convert a paper to code, or reproduce a paper's algorithm.

    Also in 4 projects that use this

  • OpenAISkill

    idea-generation

    Use when triaging public-equity idea candidates. Do not use for final trade recommendations, pitches, memos, or models.

    Also in 3 projects that use this

  • sunnyclinches44Skill

    explain

    Explains code using real-world analogies and ASCII diagrams

    Also in 5 projects that use this

  • +6 more from lingzhi227

The file

Files
SKILL.md

self-review: AI 出力にレビューパックを付ける

目的: 人間のレビューを「全部読む」から「重点確認」に変える。 パッチや設計を提示するとき、本体の後ろに以下のレビューパックを付ける。 簡潔に — 各項目 1〜3 行。長いレビューパックは本末転倒。

レビューパック形式

---
## レビューパック

**変更の要約**: (1 文)

**根拠**: 根本原因 → この修正がそれを解決する理由。推測が混ざる場合は「推測:」と明記。

**影響範囲**: この変更が触る他の機能/ターゲット/呼び出し元。
「影響なし」と書く場合は、なぜ無いと言えるか (検索した・テストした) を添える。

**テスト証跡**: 実際に実行したコマンドと結果。実行していないなら「未実行」と正直に書き、
実行すべきコマンドを示す。

**重点確認ポイント**: 人間に見てほしい 1〜3 箇所 (file:line)。
「ここは自信がない」「ここは仕様判断が必要」を優先して挙げる。

**未解決事項**: あれば。なければ省略。

ルール

  • テスト証跡を捏造しない。実行していないものは「未実行」と書く。
  • 「該当なし」「影響なし」「問題なし」は、確認した根拠 (実行したコマンド・ 見た file:line・grep 結果) を添えたときだけ書ける。添えられなければ 「未確認」と書く。根拠を書こうとして書けないことが、自分がまだ見ていないことを 教えてくれる。項目は提示時に思い出して埋めず、読んだその場で確認する。
  • 逆向きの主張「壊れている」「まだ直っていない」も同じ。特に別リポジトリ・ 別セッションの現在状態は、自分の記憶やノートより新しくなっている可能性が常に ある — 記録は「書いた時点の状態」であって現在ではない。数秒で測れるものを 測らずに現在形で書かない。
  • 自信のない箇所を隠さない。重点確認ポイントは「自信のない順」に並べる。
  • 3 行以下の自明な変更にはレビューパック不要 (過剰適用しない)。
  • コンパイラ関連の変更では references/compiler-checklist.md を確認し、 該当する項目があれば影響範囲/重点確認ポイントに反映する。
  • コード品質 (関数化・結合度・ネスト・命名) は提示前に cq-review Skill の references/checklist.md で自己チェックし、 未解消の観点があれば「重点確認ポイント」に正直に挙げる。

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.