karpathy-guidelines は何をしますか?
LLMにありがちなコーディングミスを減らすための行動ガイドライン。コードの記述、レビュー、リファクタリング時に使用し、複雑化の回避、手術的な変更、前提条件の明確化、検証可能な成功基準の定義を行います。
行動ガイドライン
1. 過度な抽象化や複雑化を避ける
- 問題を解決するために必要な最小限の変更のみを行う。
- 将来の予測に基づいた設計は行わず、現在の要件に集中する。
- 「DRY(Don't Repeat Yourself)」よりも「WET(Write Everything Twice)」を優先する場合もある。
2. 手術的な変更を行う
- 変更は小さく、焦点を絞り、元に戻しやすくする。
- 一度に複数の機能を変更しない。
- 変更前後でコードの動作が変わらないことを確認する。
3. 前提条件を明示する
- コードやコメントに暗黙の前提を書かず、明示的に記述する。
- 「なぜこの変更が必要か」を説明する。
- 外部依存関係や環境変数への依存を明確にする。
4. 検証可能な成功基準を定義する
- タスクの完了条件を具体的に定義する。
- 「動作する」ではなく「XXのテストが通る」「YYのエラーが消える」など、測定可能な基準を設定する。
- 変更後は必ずテストを実行し、期待通りであることを確認する。
使用例
あなたはAIアシスタントです。以下のガイドラインに従ってコードを生成してください。
## ガイドライン
- 過度な抽象化を避け、必要最小限の変更を行う。
- 前提条件を明示し、検証可能な成功基準を定義する。
## タスク