karpathy-agentic-engineering について
エージェントを使う開発者向けのコーディングスキルです。明確なタスク、検証可能な成功基準、段階的な変更、人によるレビューを重視し、指示テンプレートと反復可能な開発手順を示します。
主な機能
- 017段階の段階的なコーディング手順
- 02検証可能な基準を含むタスクプロンプト
- 03CLAUDE.md と AGENTS.md のテンプレート
- 04差分レビューと検証の指針
- 05よくある失敗を防ぐ対策
活用シーン
- 01エージェントを使うコーディング作業の開始
- 02リポジトリ用エージェント指示の作成
- 03エージェントと複雑な問題をデバッグ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/karpathy-agentic-engineeringを入力して読み込まれたか確認します。
詳細
スキル 1：エージェント型エンジニアリング
出典：https://x.com/karpathy/status/2004607146781278521 | https://x.com/karpathy/status/2015883857489522876 | https://x.com/karpathy/status/2026731645169185220 「プログラミングがこれほど変わったことを伝えるのは難しいです。」— 約 37k 件のいいね
基本原則
もうコードを書く必要はありません。疲れを知らないジュニアエンジニアのチームを指揮するのです。
変化の流れ：コードを書く → 成功基準を定めたタスクを書く → エージェントのループ → 人間のセンスによるレビュー
7 ステップのインナーループ（Karpathy のインクリメンタルコーディングのリズム）
これは、すべてのコーディングセッションで行うマイクロループです。
- コンテキストを詰め込む — プロジェクト全体をコンテキストに読み込む（
files-to-prompt、関連ドキュメント、最近の差分） - 計画について話し合う — コードを書く前に、エージェントに長期的なアプローチとそのメリット・デメリットを尋ねる
- 最初の草案を依頼する — アプローチを 1 つ選び、最小限の初期実装を作ってもらう
- 実装しながら学ぶ — 差分を手動でレビューし、知らない API があればエージェントに説明を求める
- テストする — テストを実行し、出力を確認し、成功基準を検証する
- コミットする — 理解し、検証したものだけをコミットする
- 次の作業を尋ねる — 次の段階的なステップをエージェントに提案してもらう
ステップ 4 は絶対に省略しないでください。 差分をすべて確認せずに承認していると、理解は衰えていきます。
CLAUDE.md / AGENTS.md テンプレート
エージェントで最もよくある失敗を防ぐため、このファイルをプロジェクトのルートに作成します。
# Agent Instructions for [Project Name]
## Behavior Rules
- Make one incremental change at a time. Do NOT refactor unrelated code.
- Always explain WHY you're making a change before the diff.
- If unsure about intent, ASK before implementing.
- Do NOT add new dependencies without explicit approval.
- Prefer simple, readable solutions over clever ones.
## Success Criteria (task-specific — fill in per session)
- [ ] Tests pass: `[test command]`
- [ ] No new lint errors: `[lint command]`
- [ ] Behavior matches: [description of expected output]
## Project Context
- Stack: [language, framework, key libs]
- Entry point: [file]
- Test command: [command]
- Forbidden: [list things agent must never do]
マスタープロンプトテンプレート
You are an agentic engineer on this project.
Project context: [paste relevant files or use files-to-prompt output]
Task: [specific, unambiguous description]
Success criteria (ALL must be true when done):
1. [verifiable check 1]
2. [verifiable check 2]
3. [verifiable check 3]
Constraints:
- Only change files relevant to this task
- No new dependencies without asking
- Output: one incremental diff at a time
Start by proposing a high-level plan with 2-3 options and trade-offs. Wait for approval before writing code.
防ぐべきよくある失敗
| エージェントの問題 | 防止策 |
|---|---|
| 過剰なリファクタリング | 「タスクに直接関係するファイルだけを変更してください」 |
| 迎合的な同意 | 「この計画で問題になりそうな点を教えてください」 |
| 存在しない API の捏造 | 「使用する API について、ドキュメント内の該当行を正確に示してください」 |
| 依存関係の肥大化 | 「確認なしに新しい pip/npm パッケージをインストールしないでください」 |
| 成功基準がない | 作業を始める前に、必ず完了条件を定義する |
ワークフロー
ワークフローに属します：アイデアからリリースまで（開発者）
| 位置 | 上流 | 下流 |
|---|---|---|
| ステップ 2 | karpathy-idea-files（まずアイデアを定義） | karpathy-minimalism（最小限の実装） |
全体の流れ：idea-files → agentic-engineering → minimalism → supply-chain-hygiene → vibe-to-agentic
バイアスを避ける意思決定ワークフローでは、実行レイヤーとして登場することもよくあります。意思決定が完了して実行に移す必要があるときは、このスキルに切り替えます。
プロンプトの契約
You are an agentic engineer. Project context: <files, constraints, current state>. Task: <specific goal>. Success criteria: <verifiable checklist>. First propose a high-level plan with tradeoffs. Then make only the next incremental change. After each change, run the relevant verification and report: changed files, evidence of success, remaining risk, and next step.
検証チェックリスト
- 成功基準が確認可能な項目として記述されている（曖昧な説明ではない）
- 各変更に実際の検証証拠がある：テスト合格、lint エラーなし、差分の範囲が適切
- エージェントがタスクの範囲外のファイルを変更していない
- 人間が各差分のうち理解できない部分をレビューしている（ステップを飛ばしていない）
- 最終コミットの前に、何を変更したか、なぜ変更したかを同僚に一言で説明できる
このスキルを適用する場面
- 30 分を超えるコーディングタスクを始めるとき
- エージェントの支援を受けて新しいプロジェクトをセットアップするとき
- 複雑な問題をデバッグするとき（エージェントを相談相手兼実装者として使う）
- リポジトリ用の CLAUDE.md / AGENTS.md を作成するとき