Communityライティング&編集github.com

Dev-PGVAA/skills

フォーカスされた検証可能なコード変更の記述、または差分・コミット・プルリクエストに対する欠陥優先のレビューを実行します。実装規律、リファクタリング、コードレビューに使用。レビューモードは要求された場合のみ選択します。新しい名前は短く読みやすく保ち、コメントには「何を」ではなく「なぜ」を記述します。

skills とは?

このスキルは、AIエージェントがコード変更やレビューを実行する際に、焦点を絞った検証可能な作業を促します。実装/リファクタリングモードとレビューモードの2つがあり、それぞれ異なるガイドラインに従います。小さな編集には過剰な計画や抽象化を作成せず、リポジトリの既存のツールを使用します。また、サブエージェントへの委譲をサポートし、独立したファイルに跨る実装やリスクベースのレビュー分割を効率的に行います。最終的には、変更された動作や発見された問題点、実際に実行されたチェック、および重要な制限事項を報告します。「所見なし」も有効な結果であり、型チェックの通過だけではランタイムの動作やデプロイの証明にはなりません。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/code-quality

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

ドキュメント

コード品質

要求された動作をフォーカスした変更で正しくし、具体的な証拠を用いて欠陥をレビューします。リポジトリの指示、既存のアーキテクチャ、ユーザーの編集、要求された読み取り/書き込みスコープを尊重します。

モードの選択

  • 実装/リファクタリング: ガイドラインを読んでください。観測可能な受け入れ基準を定義し、リポジトリの実際のツールを使用します。
  • レビュー: レビューを読んでください。修正も要求されない限り、読み取り専用に留めてください。結論を出す前に比較対象を確認します。
  • 小さな編集には小さなワークフローで十分です。このスキルを満たすためだけに、計画、抽象化、テスト、または余分なファイルを作成しないでください。

有用な委譲

利用可能なサブエージェントを使用して、不確実性を大幅に低減する独立した作業を行ってください。コンテキストの転送コストがタスクそのものよりも高い場合は委譲をスキップし、エージェントが利用できない場合は同じロールを順番に使用します。

  • 実装: コントラクトスカウトが親が実装している間に呼び出し元、インターフェース、既存のテストを読み取り、安定したパッチの後に検証者が変更された動作を実行します。実装は本当に独立したファイルにのみ分割し、ファイルごとに1人の所有者を割り当て、親が統合ファイルを所有します。
  • レビュー: リスク(例:認可/データ処理と状態/並行性)または互いに素なモジュールで分割します。すべてのレビューアに同じベース/ヘッドと必要なユーザー動作を指定します。親はクロスモジュールパスをトレースし、各提案された所見をチェックし、重複を削除し、最終的な重大度を割り当てます。
  • 委譲されたタスクは、目的、許可されたパス、読み取り/書き込みスコープ、前提条件、停止点、期待される証拠を指定します。変更されたファイルまたは path:line の所見、実際の再現/テスト結果、未解決の質問を返します。有用な境界のある理由なしに再帰的に委譲しないでください。

完了

変更された動作または実行可能な所見、実際に実行されたチェック、および重要な制限事項を報告します。「所見なし」は有効です。型チェックの通過は、ランタイムの動作やデプロイの証明にはなりません。

Individual skills in this repo

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

関連スキル