Communitygithub.com

プリランディングセルフレビュー

重要なコード変更をコミットする前に実行する構造化された自己レビューチェックリストです。エッジケース、エラーパス、テストカバレッジ、ドキュメント、コード品質を網羅し、CIを最終手段としながらも最初のレビュアーにしないためのスキルです。

プリランディングセルフレビュー とは?

このスキルは、自律エージェントがコード変更をコミットする前に自己レビューを実行するための構造化チェックリストを提供します。主にClaude Codeなどの自律エージェント向けに設計されており、エッジケース、エラーパス、テストカバレッジ、ドキュメント、コード品質の5つの観点から変更を検証します。通常は人間が行うレビューゲートをスキル化することで、自律エージェントが目に見えるバグや回帰を見逃さずにコミットできるようになります。チェックリストはMarkdown形式で提供され、各ステップは具体的な指示とともにリストアップされているため、エージェントは順に実行できます。また、よくあるアンチパターンとその修正方法もまとめられており、品質を確保するための実践的なガイドとなっています。このスキルを活用することで、CIの往復時間を節約し、ユーザに届くバグを減らし、不要なリバートPRを減らすことができます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/agentskillexchange/skills/tree/HEAD/skills/pre-landing-review

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

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

ドキュメント

プリランディングセルフレビュー は何をしますか?

重要な変更をコミットする前に、このチェックリストを実行してください。CIが問題をキャッチする前、あるいはユーザーが気づく前に問題を発見しましょう。

使用タイミング

以下のいずれかに該当する場合、このスキルを実行してください:

  • 100行以上のコードを変更した
  • 5ファイル以上を変更した
  • コアインフラストラクチャ(executor、storage、メインディスパッチループ)に触れた
  • 新しい抽象化やパブリックAPIを導入した
  • エッジケースや設計上の選択について確信がない

簡単なゲート:

git diff --stat HEAD | tail -5  # どのくらい変更したか?
git diff --name-only HEAD | wc -l  # いくつのファイルを変更したか?

スキップする場合

  • 些細な変更(50行以下、3ファイル以下)
  • 純粋なドキュメントやレッスンの更新
  • テストのみの変更(テストはそれ自体がレビュー)
  • 範囲が明らかで限定された単純な1行のバグ修正
  • ロジック変更を伴わない機械的なリファクタリング

チェックリスト

1. エッジケース

- [ ] null/空の入力は処理されているか?
- [ ] 境界条件(off-by-one、空リスト、ゼロ)がテストされているか?
- [ ] 同時アクセスや競合状態は考慮されているか?
- [ ] テキスト処理時にUnicode/エンコーディングの問題は考慮されているか?

2. エラーパス

- [ ] すべての例外は適切なレベル(広すぎない)でキャッチされているか?
- [ ] エラーメッセージは有益か(何が失敗したか、なぜか、どうすればよいか)?
- [ ] 障害モードは優雅に失敗し、静かに失敗しないか?
- [ ] 裸の `except:` やエラーを飲み込んでいないか?

3. テストカバレッジ

- [ ] 重要なパスにテストがあるか?
- [ ] 上記で特定したエッジケースにテストがあるか?
- [ ] テストは実際に実行され、パスするか?
- [ ] `pass` や `...` で放置されたテストスタブがないか?

4. ドキュメント

- [ ] ドキュメント文字列/コメントは現在の動作と一致しているか?
- [ ] パブリックインターフェースが変更された場合、READMEは更新されているか?
- [ ] コミットメッセージは何が変わったかとその理由を捉えているか?
- [ ] 関連するアーキテクチャドキュメントは依然として正確か?

5. コード品質

- [ ] 名前付けは明確で周囲のコードと一貫性があるか?
- [ ] 明らかなコードの悪臭(神関数、マジックナンバー、ハードコードされたパス)がないか?
- [ ] ファイル/パッケージ内の既存のパターンに従っているか?
- [ ] 静的解析/型チェックはパスするか?

ワンライナースモークテスト

# コミット前に実行(スタックに合わせて適応してください):
make format && make typecheck && pytest -x -q && echo "✅ ランディングクリーン"

いずれかのステップが失敗した場合、コミットする前に修正してください。レッドを出荷しないでください。

アンチパターン

アンチパターン修正方法
「CIがキャッチする」CIは最後の手段であり、自分自身の判断の代わりにはなりません。最初にキャッチしましょう。
「あとでテストを追加する」「あとで」は来ません。今すぐテストを書くか、永久にギャップを受け入れてください。
「手動テストで動いた」手動テストは再現可能ではありません。自動テストを書いて、将来のセッションでも検証できるようにしましょう。
「エラーメッセージはTODO」TODOエラーメッセージはTODOエラーメッセージとして出荷されます。今すぐ本当のメッセージを書きましょう。
「コードを見ればこのケースを処理していることがわかる」テストされていなければ、将来のリファクタリングで見えないうちに壊れます。

これが重要な理由

自律エージェントは、修正を避けるのに十分な「良い」出力を生成するように訓練されています。構造化されたレビューゲートがなければ、自律エージェントによるコードコミットは、通常は回帰やエッジケースをキャッチする人間参加型チェックをバイパスします。このスキルはそのゲートとして機能します。5つの焦点を当てたレンズを順番に実行することで、明らかなものがすり抜けるのを防ぎます。

その効果は積み重なります。レビューパスが実際の問題をキャッチするたびに、CIの往復時間が節約され、ユーザーバグが回避され、不要なリバートPRが削減されます。

関連

Individual skills in this repo

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

Academic Paper Citation Network Mapper

Builds citation networks from Semantic Scholar API and CrossRef DOI metadata. Visualizes paper influence graphs using NetworkX, identifies seminal works, and tracks research lineage across fields.

ACF Custom Fields REST Exposer

Exposes Advanced Custom Fields data through the WordPress REST API using register_rest_field and acf_format_value. Handles repeater fields, flexible content layouts, and gallery fields with proper serialization.

ACF Extended for Advanced Custom Fields Workflows

An ASE skill built around ACF Extended, the WordPress enhancement suite for Advanced Custom Fields that adds field types, admin improvements, front-end forms, options pages, and developer tooling. It is a practical fit for agents working inside complex WordPress content models and custom field workflows.

ACF to Gutenberg Block Migrator

Converts Advanced Custom Fields field groups into native Gutenberg blocks using the ACF Block API v2 and @wordpress/scripts build pipeline. Maps ACF repeaters, groups, and flexible content to InnerBlocks and block attributes with server-side rendering via acf_register_block_type().

Activepieces Open Source Workflow Automation

Activepieces is an open-source, self-hostable workflow automation platform with 200+ integrations. It provides a visual builder for creating automated workflows and exposes all its connectors as MCP servers for AI agent use.

ActivityWatch Cross-Platform Automated Time Tracker and Producti

ActivityWatch is a privacy-first, open-source automated time tracker that records application usage, browser activity, and AFK status across Windows, macOS, and Linux. With 16k+ GitHub stars, it provides detailed productivity analytics without sending data to external servers.

act Local GitHub Actions Runner

act is an open-source CLI tool that runs GitHub Actions workflows locally using Docker, enabling fast feedback on workflow changes without pushing to GitHub. It is a standard tool for local Actions development and testing.

Add a browser review checkpoint before risky agent actions with

Use AgentClick when an agent should pause before risky commands, plans, drafts, or code changes so a human can inspect, edit, approve, or reject them in a purpose-built browser UI.

Add Claude design-system and accessibility workflows with UX/UI

Use UX/UI Agent Skills when Claude should generate tokens, component specs, accessibility audits, and framework-specific UI code from a repeatable design workflow.

Add executable smoke tests for shell scripts and CLIs before ref

Use Bats-core when an agent needs to turn fragile shell scripts or command-line workflows into something it can verify repeatedly after edits. The agent writes focused Bash tests for success paths, failure paths, and output contracts, then runs them locally or in CI before a refactor, release, or incident fix goes out.

Add graph-backed memory and context retrieval to agent workflows

Use Cognee to ingest project knowledge into graph and vector memory so agents can retrieve durable context across sessions and workflows.

Add IDE-style semantic code navigation and symbol-safe refactors

Give a coding agent symbol-aware lookup, cross-file rename, and structural edit tools before it starts making brittle text-only changes.

Add managed long-term memory to LangGraph agents with LangMem

Give LangGraph agents memory management and search tools so they can store, retrieve, and update durable facts across sessions.

Add multimodal lifelong memory to MCP and Python agents with Sim

Use SimpleMem to store, compress, index, and retrieve text or multimodal memories for agents through MCP or Python integrations.

Add persistent project memory and hook-driven synthesis with Cla

Keep Claude Code sessions grounded in prior decisions, project context, and daily handoff notes instead of starting from zero every time.

Add Postgres-native vector retrieval to agent and RAG workflows

Store embeddings beside application data in Postgres, create vector indexes, and query nearest neighbors for semantic search, RAG, recommendations, or agent memory retrieval.

Address GitHub PR review comments from the current branch with g

Find the open PR for the current branch, gather unresolved review comments, and drive a focused comment-resolution workflow with gh-authenticated context.

Add runtime guardrails to TypeScript agents with VoltAgent

Use VoltAgent to intercept, validate, and enforce input/output policies in TypeScript agent workflows.

Add temporal context memory to agent workflows with Zep

Use Zep as an external context layer for agents that need to store events, assemble temporal graph context, and retrieve relevant memory before model calls.

Adobe Firefly API Batch Image Generator

Calls Adobe Firefly

関連スキル