エージェント開発の人間役割：コードを書かずに「承認」する仕事へ

このシリーズについて

AIエージェントが自律的にコードを書き、テストを回し、PRを作成する世界。 そこで人間が担うべき役割は「ドライバー」から「技術編集長（Gatekeeper）」へと進化します。

AIによるコンテンツ生成は「全自動」を目指すべきではありません。 私たちが目指すのは、人間が戦略と品質の最終責任を持ち、AIがその手足となって動く「Human-in-the-Loop（人間がループの中心にいる）」ワークフローです。

本シリーズでは、実際にこのブログの記事作成プロセスを半自動化した知見をもとに、AIワーカーを「最小の科学」で制御するための3つのステップを解説します。

シリーズ構成

この親記事をハブとして、以下の3つの詳細記事で構成されています。

Part 1: 戦略編

「AIエージェントによるブログ自動運用の教科書」 なぜ「全自動」は失敗するのか？ 3レイヤー管理（憲法・戦略・実行）という概念を導入し、継続可能な運用の全体像を解説します。 👉 記事を読む

Part 2: 思考編

「プロンプトからエージェントへ」 AIに対するアプローチを「魔法の言葉を探す（Prompt）」から「自律的な仕組みを作る（Agent）」へと転換するためのマインドセット定義です。 👉 記事を読む

Part 3: 実踐編

「マルチエージェント・デザインパターン」 実際にどのようなディレクトリ構成（.agents/など）やコードを用意すればよいか。notionnext-blog の裏側を公開しながら実装パターンを学びます。 👉 記事を読む

---

The Pain: AIの暴走を止めるコスト

AIエージェントに自律的にコーディングさせると、素晴らしい速度で機能を作ってくれますが、同時に**「あさっての方向」に全速力で走っていく**リスクもあります。

• 仕様無視: 「ライブラリ追加禁止」と言ったのに npm install してしまう。
• 命名規則違反: プロジェクトの kebab-case 規約を無視して camelCase でファイルを作る。
• 過剰エンジニアリング: シンプルな修正で済むのに、勝手にデザインパターンを導入して複雑化させる。

この修正（手戻り）コストが高ければ、結局「自分で書いたほうが早い」となってしまいます。

承認ベースのワークフロー (SDD)

SDDにおける人間の役割は、「ドライバー」から「ナビゲーター兼ゲートキーパー」に変わります。具体的には、2箇所の承認ゲートを設けます。

sequenceDiagram
    participant User as Human (Editor)
    participant AI as エージェント (Writer)
    participant Spec as 仕様書 (Repo)

    User->>AI: 1. Input (Issue)
    AI->>Spec: 2. Plan (Update design.md)
    Note right of AI: STOP (Wait for Approval)
    AI-->>User: STOP: Planning Approval
    User->>AI: 3. Approve 1 (LGTM)
    AI->>Spec: 4. Code (Implement)
    AI-->>User: STOP: Code Review (PR)
    User->>Spec: 5. Approve 2 & Merge

1. Gate 1: Planning Approval (作る前に承認)
2. Gate 2: Code Review (マージする前に承認)

ワークフローの詳細

1. Input: 人間（Editor）が Issue を作成。「これをやりたい」。
2. Plan: エージェントが spec/design.md を更新し、実装計画を提案。
   • STOP: ここでエージェントは停止し、承認を待つ。
3. Approve 1: 人間（Editor）が計画を確認。「OK」または「ここは直して」。
4. Code: エージェントが実装。テストが通るまで試行錯誤。
   • STOP: PRを作成して停止。
5. Approve 2: 人間（Editor）がレビュー。「LGTM」。
6. Merge: マージして完了。

このワークフローにおいて、人間（Editor）はプログラマーというより「技術編集長」や「CTO」に近い立ち位置になります。

---

Human-in-the-Loop の核心

このワークフローの核心は、人間を「ボトルネック」ではなく「ゲートキーパー」として定義することにあります。

1. Plan (AI): 膨大なデータから構成案を提案する。
2. Approve (Human): その構成が読者に価値があるか、私がGOサインを出す。
3. Draft (AI): 承認された構成に基づき、高速に執筆する。
4. Review (AI + Human): AIが技術チェックを行い、人間が最終的な熱量を吹き込む。

このループが回ることで、私たちは「執筆」という作業から解放され、「編集」と「戦略」に集中できるようになります。

---

Series C: プロンプトを「スキル」として資産化する技術

なぜ同じような指示をChatGPTに何度も入力してしまうのか？ プロンプトを「使い捨て」ではなく、バージョン管理可能な「スキル」として定義し、エージェントの自律性を引き出す手法を学びます。

Chapter 1: スキルを定義せよ

同じことを二度と言わないための「スキル定義ファイル」：プロンプトを再利用可能な資産にする

Chapter 2: 思考をパッケージせよ

「いい感じにお願い」からの脱却：思考プロセスをアルゴリズムとしてパッケージ化する技術

Chapter 3: 自律ループを回せ

道具を持たせれば自律する：SkillとToolを結合して「勝手に仕事を見つける」エージェントを作る

---

結論

AIを単なるチャット相手ではなく、信頼できる「エンジニアリング・パートナー」として扱うための第一歩が、この「承認ベースのワークフロー」と「スキル管理」です。

次のシリーズC（Agent Skills Hub）では、さらに進んで、このAIエージェント自体を賢くするための「スキル定義」の手法について解説します。

第1章：スキルを定義せよ