Agent skill

code-review

コードレビューを実施するためのスキル。ユーザーがコードの品質、セキュリティ、テスト、パフォーマンス、アーキテクチャの観点からコードレビューを依頼した場合に使用します。「コードレビュー」「コードをチェック」「PRをレビュー」「このコードを確認して」などのコードレビュータスクに言及した場合にトリガーします。セキュリティ脆弱性、ロジックエラー、テスト品質、パフォーマンス問題を優先順位付けして指摘し、具体的な改善提案を行います。

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/ks6088ts-labs/skills/tree/main/skills/code-review

SKILL.md

コードレビュー

コードの品質、セキュリティ、テスト、パフォーマンス、アーキテクチャの観点から包括的なコードレビューを実施します。

レビュー優先順位

🔴 CRITICAL（マージブロック）

  • セキュリティ: 脆弱性、シークレットの露出、認証/認可の問題
  • 正確性: ロジックエラー、データ破損リスク、競合状態
  • 破壊的変更: バージョニングなしの API 契約変更
  • データ損失: データ損失・破損のリスク

🟡 IMPORTANT（要議論）

  • コード品質: SOLID 原則の重大な違反、過度な重複
  • テストカバレッジ: クリティカルパスや新機能のテスト欠落
  • パフォーマンス: 明らかなボトルネック（N+1 クエリ、メモリリーク）
  • アーキテクチャ: 確立されたパターンからの大幅な逸脱

🟢 SUGGESTION（非ブロッキング）

  • 可読性: 命名の問題、簡素化可能な複雑なロジック
  • 最適化: 機能に影響しないパフォーマンス改善
  • ベストプラクティス: 慣習からの軽微な逸脱
  • ドキュメント: 不足・不完全なコメント/ドキュメント

レビューワークフロー

1. コンテキスト確認

レビュー開始前に以下を確認：

  1. レビュー対象のコード範囲を特定
  2. プロジェクトの技術スタック・アーキテクチャを把握
  3. 変更の目的・背景を理解

2. 観点別レビュー

以下の観点で順にチェック：

  1. セキュリティ: 脆弱性、機密データ、入力検証
  2. コード品質: 命名、単一責任、DRY、エラーハンドリング
  3. テスト: カバレッジ、テスト構造、エッジケース
  4. パフォーマンス: N+1 クエリ、アルゴリズム、リソース管理
  5. アーキテクチャ: 関心の分離、依存関係、パターン

各観点の詳細なチェック項目と例は references/guide.md を参照。

3. コメント作成

レビューコメントは優先度とカテゴリを明示し、問題の説明・影響・修正案を含める。

コメントのフォーマットと例は references/comment-template.md を参照。

リファレンス

  • 詳細ガイド: references/guide.md - 各観点のチェック項目と具体例
  • チェックリスト: references/checklist.md - レビュー時の確認項目一覧
  • コメントテンプレート: references/comment-template.md - コメントの書き方と例

レビュー原則

  1. 具体的に: 正確な行、ファイルを参照し、具体的な例を提供
  2. コンテキストを提供: なぜ問題なのか、潜在的な影響を説明
  3. 解決策を提案: 間違いだけでなく、修正されたコードを示す
  4. 建設的に: 作者を批判するのではなく、コードの改善に焦点
  5. 良い実践を認める: 適切に書かれたコードやスマートな解決策を認める
  6. 実用的に: すべての提案が即座の実装を必要とするわけではない
  7. 関連するコメントをグループ化: 同じトピックについて複数のコメントを避ける

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

ks6088ts-labs/skills

reverse-engineering

ソフトウェアのリバースエンジニアリングレポートを作成するスキル。リポジトリの構造や機能を調査し、外部仕様・内部実装・使用方法を明確にするレポートを作成します。「リバースエンジニアリングレポートを作成して」「コードベースを分析して」「プロジェクトの構造を調査して」「システムの仕組みを解析して」等のリクエストで使用してください。新規開発者のオンボーディング、プロジェクトの理解、ドキュメント作成、将来の開発のための基礎資料として活用できます。

1 0
Explore
ks6088ts-labs/skills

architecture-design-creator

PRDと機能設計書に基づいてアーキテクチャ設計書を作成するスキル。docs/prd.md と docs/functional-design.md が存在する場合に、テクノロジースタック、レイヤードアーキテクチャ、データ永続化戦略、パフォーマンス要件、セキュリティ設計等を含むアーキテクチャ設計書を作成します。「アーキテクチャ設計書を作成して」「技術仕様書を書いて」「architecture design を作って」等のリクエストで使用してください。

1 0
Explore
ks6088ts-labs/skills

marp-slide-reviewer

ローカルサーバーで起動している Marp スライドを視覚的に検証し、レイアウト問題を自動修正するスキル。「スライドをレビュー」「Marp スライドの視覚的チェック」「スライドのレイアウトを確認」「プレゼン資料の見た目を検証」などのリクエストでトリガーします。テキストの切れ目、重なり、配置問題、コントラスト不足、はみ出し、余白不足などの視覚的問題を検出・修正します。

1 0
Explore
ks6088ts-labs/skills

agents-md-creator

AIコーディングエージェント向けの指示書「AGENTS.md」を作成するスキル。プロジェクトにAIエージェントが作業するための文脈と指示を集約するファイルを作成したい場合に使用します。「AGENTS.mdを作成」「AIエージェント用の指示書を作る」「エージェント向けREADMEを作成」などのリクエストでトリガーします。OpenAI Codex、Claude Code、GitHub Copilot、Cursorなど、複数のAIエージェントで共通利用できるオープンな標準フォーマットです。

1 0
Explore
ks6088ts-labs/skills

doc-writer

ドキュメント執筆をサポートするスキル。ユーザーがPRDに基づいてドキュメントを作成、編集、または更新したい場合に使用します。このスキルは、docs/prd.md に記載されたプロダクト要求仕様書を参照しながら、技術ドキュメント、設計ドキュメント、ユーザーガイド、APIドキュメントなどの執筆を支援します。「ドキュメントを書く」「仕様書を作成」「ガイドを作る」などのドキュメント作成タスクに言及した場合にトリガーします。

1 0
Explore
ks6088ts-labs/skills

glossary-creator

プロジェクト用語集を作成するスキル。docs/prd.md や docs/functional-design.md が存在する場合に、ドメイン用語、技術用語、略語、アーキテクチャ用語等を体系的に定義した用語集を作成します。「用語集を作成して」「glossary を作って」「用語を定義して」等のリクエストで使用してください。

1 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results