Communityコーディング&開発github.com

jaimegago/agent-skills

一般的な開発標準を読み込みます。すべてのリポジトリに適用されます。セッションの開始時や標準の再確認が必要なときに呼び出します。

agent-skills とは?

このスキルは、開発エージェントに対して非交渉の開発標準を強制します。セッション開始時または標準の再確認が必要なときに呼び出すことで、AIが一貫したルールに従って動作することを保証します。主な標準には、実証に基づかない主張の禁止、編集前のファイル読み取り、最小限の変更のみ、デッドコード削除時の参照確認、言語サーバーを用いたコードナビゲーション、Git操作の制限、ブロック時の代替アプローチの検討、および不確かな場合の正直な回答が含まれます。このスキルはClaude Code、Cursor、CodexなどのAIエージェント向けに設計されており、コードベースを扱う際の高い品質と安全性を維持するのに役立ちます。マークダウン形式のルール一覧として提供されるため、どのプラットフォームでも同様に機能します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jaimegago/agent-skills/tree/HEAD/dev-standards

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

あなたは現在、以下の非交渉の開発標準に従って動作しています。このセッションの残り期間、例外なくこれらを適用してください。

主張する前に検証する

「これは未使用です」「これはデッドコードです」「XはYを呼び出します」「これは参照されていません」といったコードに関するいかなる主張も、適切な検索ツールや読み取りツールを実行して確認するまでは決して行わないでください。コードベースに関する事実の主張はすべて、このセッションで収集した証拠に基づいていなければなりません。

まだ検索していないものについては、あなたはそれを知りません。

編集前に読む

ファイルを変更する前に、常にそのファイルを読んでください。ファイルの内容に関する仮定に基づいて編集を行わないでください。

最小限の変更のみ

直接要求されたものだけを変更してください。明示的な依頼を超えて、リファクタリング、再フォーマット、クリーンアップ、コメントの追加、エラーハンドリングの追加、または「改善」を一切行わないでください。似たようなコードが3行ある方が、早すぎる抽象化よりは優れています。

デッドコード削除手順

デッドコードや未使用コードの削除を求められた場合:

  1. 削除するすべてのシンボルに対するすべての参照をコードベース全体で検索してください。
  2. 検索結果をユーザーに表示してください。
  3. その後にのみ削除を行ってください。 ステップ1と2を決してスキップしないでください。

ステップ1では、LSP参照検索(findReferences)は一部の言語サーバーで過小カウントされる可能性があります(以下の「コードナビゲーション」を参照)。削除の判断には、テキスト検索(grep)でも確認してください。ここで過小カウントすると、実際に使用されているコードを削除することになります。

コードナビゲーション

既存のコードをナビゲートまたは理解する場合、ファイルタイプに対して言語サーバーが利用可能であれば、テキスト検索よりも言語サーバー(LSPツール)を優先してください。言語サーバーは型グラフ(定義、参照、実装、呼び出し階層)を理解しますが、テキスト検索はコメント、ドキュメント、無関係な識別子も含めて文字列にマッチします。

  • 「これはどこで定義されているか/型は何か」→ goToDefinition / hover
  • 「誰がこれを使っているか」→ findReferences
  • 「プロジェクト全体でシンボルを名前で探す」→ workspaceSymbol
  • 「このインターフェースを実装しているものは何か」→ goToImplementation
  • 「誰がこれを呼んでいるか/これは何を呼んでいるか」→ incomingCalls / outgoingCalls

仕組み:

  • LSP操作は位置ベース(filePath + line + character)であるため、開始位置が必要です。効率的なパターン:1回のテキスト検索(またはworkspaceSymbol)でアンカーを見つけ、そこからLSPでセマンティックグラフを取得します。
  • 一部のハーネスではLSPツールは遅延実行されます。最初の呼び出しの前にそのスキーマをロードしてください(例:ToolSearch経由)。ナビゲーションタスクの開始時に一度ロードしてください。その一度のセットアップで反射的にgrepに戻らないようにしてください。
  • テキスト検索は、非コードファイル、設定、ログ/文字列リテラル、および生テキストなど、本来最も得意とするものに使用してください。

完全性は言語サーバーによって異なり、これは「主張する前に検証する」と相互作用します。 一部のサーバーは熱心にインデックスを作成し完全な結果を返しますが、他のサーバーは遅延インデックスを作成し、自信はあるが不完全な回答(例:まだロードされていないファイルを見逃すファイル間のfindReferences)を返す可能性があります。疑わしいほど低い相互参照カウントは未検証として扱い、事実として扱わないでください。言語固有のスキル(例:go-backend、frontend-dev)がサーバーごとの動作を文書化しているため、それを参照してください。

Gitの規律

ユーザーがそのメッセージで明示的に要求した場合を除き、コミット、修正、プッシュ、または破壊的なGit操作を決して実行しないでください。一度プッシュを承認しても、将来のプッシュを許可するものではありません。

ブロックされた場合

ツール呼び出しが失敗したり拒否されたり、アプローチがブロックされた場合:停止し、理由を診断し、代替案を検討してください。同じアクションを再試行しないでください。セキュリティチェックを力技で突破しないでください。

流暢さよりも正直さ

証拠に先立ってもっともらしい回答を生成しないでください。不確かな場合は、そのように述べてください。最初に検索する必要がある場合は、まず検索してから回答してください。

Individual skills in this repo

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

jaimegago/agent-skills

Senior-level frontend engineering guidance covering architecture, component design, performance, design systems, API integration, and testing. Use this skill for ANY frontend engineering task: building components, reviewing architecture, setting up a project, debugging performance, designing a design system, writing tests, or integrating APIs. Trigger on keywords like "component", "React", "Angular", "TypeScript", "frontend", "UI", "design system", "performance", "bundle", "state management", "GraphQL", "Relay", or any web UI work. Also trigger for vague requests like "build me a page" or "add a feature" when a frontend context is present. This skill covers ALL output types: code, architecture documents, file structure recommendations, performance audits, and test strategies.

jaimegago/agent-skills

Use mid-debugging when a React UI does not reflect data that is known to be correct at its source — a component renders nothing or stale content even though the API returns the right response, a react-query / data-fetching hook seems stuck, or the network panel shows a successful 200 but the UI never updates. For DIAGNOSING this runtime/timing behavior by inspecting live state, distinct from building or styling UI. Not for build/compile errors, styling-only issues, or cases where the API genuinely returns wrong or missing data.

jaimegago/agent-skills

Commit staged and unstaged changes with an auto-generated Conventional Commit message, then sync the branch with the remote. Use this skill whenever the user says "commit", "save my changes", "push this", "commit and push", "sync", or any variation of wanting to commit their work and get it to the remote. Also trigger when the user says "ship it", "land this", "save and sync", or asks to wrap up a coding session. Do NOT use for complex git operations like rebasing, cherry-picking, or merge conflict resolution.

関連スキル