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

forrestchang/karpathy-guidelines

LLMにありがちなコーディングミスを減らすための行動ガイドライン。コードの記述、レビュー、リファクタリング時に使用し、複雑化の回避、手術的な変更、前提条件の明確化、検証可能な成功基準の定義を行います。

karpathy-guidelines とは?

このスキルは、LLMエージェント(Claude Code、Cursor、Codexなど)がコードを記述、レビュー、リファクタリングする際に、よくあるミスを防止するための行動ガイドライン(forrestchang/karpathy-guidelines)を提供します。主な目的は、過度な複雑化を避け、最小限の変更で正確にタスクを遂行し、暗黙の前提を明らかにし、検証可能な成功基準を設定することです。このスキルを使うことで、AIエージェントはより安全で効率的なコード生成が可能になり、大規模な変更や誤った仮定によるバグのリスクを低減します。具体的には、コード変更時には既存の動作を尊重し、必要最小限の修正に留め、変更の影響を常に検証することを促します。あらゆるプラットフォームで動作し、プロンプトにこれらのガイドラインを含めるだけで適用できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forrestchang/andrej-karpathy-skills/tree/main/skills/karpathy-guidelines

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

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

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

ドキュメント

karpathy-guidelines は何をしますか?

LLMにありがちなコーディングミスを減らすための行動ガイドライン。コードの記述、レビュー、リファクタリング時に使用し、複雑化の回避、手術的な変更、前提条件の明確化、検証可能な成功基準の定義を行います。

行動ガイドライン

1. 過度な抽象化や複雑化を避ける

  • 問題を解決するために必要な最小限の変更のみを行う。
  • 将来の予測に基づいた設計は行わず、現在の要件に集中する。
  • 「DRY(Don't Repeat Yourself)」よりも「WET(Write Everything Twice)」を優先する場合もある。

2. 手術的な変更を行う

  • 変更は小さく、焦点を絞り、元に戻しやすくする。
  • 一度に複数の機能を変更しない。
  • 変更前後でコードの動作が変わらないことを確認する。

3. 前提条件を明示する

  • コードやコメントに暗黙の前提を書かず、明示的に記述する。
  • 「なぜこの変更が必要か」を説明する。
  • 外部依存関係や環境変数への依存を明確にする。

4. 検証可能な成功基準を定義する

  • タスクの完了条件を具体的に定義する。
  • 「動作する」ではなく「XXのテストが通る」「YYのエラーが消える」など、測定可能な基準を設定する。
  • 変更後は必ずテストを実行し、期待通りであることを確認する。

使用例

あなたはAIアシスタントです。以下のガイドラインに従ってコードを生成してください。

## ガイドライン
- 過度な抽象化を避け、必要最小限の変更を行う。
- 前提条件を明示し、検証可能な成功基準を定義する。

## タスク

関連スキル