# 補助的コーディングから統合型開発へ：AIプログラミングチームの実践導入（PPT）

# {補助的|ほじょてき}コーディングから{統合型|とうごうがた}{開発|かいはつ}へ
## チームはどのようにAIプログラミングを{本当|ほんとう}に{使|つか}いこなすのか

Plan / Skill / AGENTS.md / {安全|あんぜん}{境界|きょうかい} / {効果|こうか}{評価|ひょうか}

---
layout: section
---

# 1. まず{概念|がいねん}をはっきりさせる

---

# AIプログラミングとは{何|なに}か

- ただコードを{補完|ほかん}するだけではない
- ただ「このコードはどんな{意味|いみ}か」に{答|こた}えるだけではない
- ただ1つの{関数|かんすう}やコンポーネントを{生成|せいせい}するだけではない

いま、より{正確|せいかく}な{言|い}い{方|かた}は：

## Agentic Coding

AIが1つの{目標|もくひょう}を{軸|じく}に{継続的|けいぞくてき}に{作業|さぎょう}する：

- コードベースを{読|よ}む
- {規約|きやく}を{理解|りかい}する
- {作業|さぎょう}を{分解|ぶんかい}する
- ファイルを{修正|しゅうせい}する
- コマンドを{実行|じっこう}する
- テストを{実行|じっこう}する
- {結果|けっか}を{報告|ほうこく}する

---

# Agentic Codingと{従来|じゅうらい}のAIコーディングの{違|ちが}い

| {観点|かんてん} | {従来|じゅうらい}のAIコーディング | Agentic Coding |
|------|--------------|----------------|
| {入力|にゅうりょく} | 1つのprompt | リポジトリ + ルール + ツール + {権限|けんげん} |
| {出力|しゅつりょく} | コード{断片|だんぺん} / {提案|ていあん} | レビュー可能な{過程|かてい}と{結果|けっか} |
| {作業|さぎょう}{範囲|はんい} | {現在|げんざい}のファイル / {現在|げんざい}の{問題|もんだい} | {複数|ふくすう}ファイル / {複数|ふくすう}{段階|だんかい} / {長|なが}い{作業|さぎょう}チェーン |
| ツール{能力|のうりょく} | {補完|ほかん}、{説明|せつめい}、{生成|せいせい} | コードの{読|よ}み{書|か}き、コマンド{実行|じっこう}、テスト、ツール{呼|よ}び{出|だ}し |
| {協業|きょうぎょう}{方式|ほうしき} | Q&A{型|がた} | {作業|さぎょう}{型|がた} / agent{型|がた} |

---
layout: section
---

# 2. {主流|しゅりゅう}ツールはどんな{形|かたち}か

---

# {今日|きょう}の{主流|しゅりゅう}ツールの4つの{形態|けいたい}

1. IDE{内|ない}インライン{補完|ほかん}{型|がた}  
   Cursor / Copilot / Windsurf

2. ターミナルAgent{型|がた}  
   Codex CLI / App / Claude Code

3. {複数|ふくすう}Agent / {非同期|ひどうき}{協業|きょうぎょう}{型|がた}  
   worktree、review queue、automations

4. {企業|きぎょう}プロセス{接続|せつぞく}{型|がた}  
   issue / docs / CI / design / review

---

# IDE{内|ない}インライン{補完|ほかん}{型|がた}

{利点|りてん}：

- {速|はや}い
- {集中|しゅうちゅう}の{流|なが}れを{途切|とぎ}らせない
- {日常的|にちじょうてき}なコーディングに{向|む}いている
- {局所的|きょくしょてき}な{修正|しゅうせい}に{向|む}いている

{限界|げんかい}：

- より{短|みじか}い{作業|さぎょう}に{向|む}いている
- {複数|ふくすう}{段階|だんかい}の{作業|さぎょう}は{能力|のうりょく}に{限界|げんかい}がある
- コンテキストは{通常|つうじょう}{現在|げんざい}のファイルを{中心|ちゅうしん}とする

{結論|けつろん}：

## より「{強化版|きょうかばん}エディタ」に{近|ちか}い

---

# ターミナルAgent{型|がた}

{代表例|だいひょうれい}：

- Codex App / CLI
- Claude Code

{特徴|とくちょう}：

- コードベースを{直接|ちょくせつ}{操作|そうさ}する
- ディレクトリをまたいでファイルを{修正|しゅうせい}できる
- コマンドやテストを{実行|じっこう}できる
- より{大|おお}きな{作業|さぎょう}、{長|なが}い{作業|さぎょう}に{向|む}いている
- より「{共同|きょうどう}{開発者|かいはつしゃ}」に{近|ちか}い

{結論|けつろん}：

## これはAgentic Codingで{最|もっと}も{注目|ちゅうもく}に{値|あたい}するルートである

---

# {複数|ふくすう}Agent / {非同期|ひどうき}{協業|きょうぎょう}{型|がた}

キーワード：

- {複数|ふくすう}agentの{並列|へいれつ}{実行|じっこう}
- worktreeによる{分離|ぶんり}
- review queue
- automations
- {長時間|ちょうじかん}{作業|さぎょう}の{非同期|ひどうき}{実行|じっこう}

{何|なに}が{変|か}わるのか：

「{私|わたし}と1つのAIが{対話|たいわ}する」から

{次|つぎ}の{状態|じょうたい}へ

## 「{私|わたし}が1{組|くみ}のagentに{仕事|しごと}を{割|わ}り{振|ふ}る」

---
layout: section
---

# 3. {本当|ほんとう}に{効果|こうか}を{決|き}めるのはモデル{参数|ぱらめーた}ではない

---

# なぜコンテキストエンジニアリングのほうが{重要|じゅうよう}なのか

{同|おな}じモデルでも：

- {規約|きやく}がないと、{出力|しゅつりょく}はしばしば「{正|ただ}しそうに{見|み}える」
- {境界|きょうかい}がないと、{権限|けんげん}を{越|こ}えやすい
- プロセスがないと、{手戻|てもど}りと{審査|しんさ}コストが{高|たか}い

いったんルール、コマンド、{境界|きょうかい}、プロセスを{固定化|こていか}すると：

- {安定性|あんていせい}が{向上|こうじょう}する
- {再利用性|さいりようせい}が{向上|こうじょう}する
- チーム{協業|きょうぎょう}コストが{下|さ}がる

---

# {私|わたし}が{勧|すす}めるチーム{構築|こうちく}{順序|じゅんじょ}

## `AGENTS.md` > Skill > MCP

{理由|りゆう}：

- `AGENTS.md`はプロジェクトの{統一|とういつ}{方針|ほうしん}を{解決|かいけつ}する
- Skillは{高頻度|こうひんど}プロセスの{再利用|さいりよう}を{解決|かいけつ}する
- MCPは{外部|がいぶ}システム{接続|せつぞく}を{解決|かいけつ}する

この{順番|じゅんばん}を{逆|ぎゃく}にしてはいけない。

---

# `AGENTS.md`は{何|なに}のためのものか

それは：

## リポジトリ{単位|たんい}の{永続的|えいぞくてき}{説明書|せつめいしょ}

{何|なに}を{書|か}くのに{向|む}いているか：

- リポジトリ{構造|こうぞう}
- {変更|へんこう}してよいもの、してはいけないもの
- テストとビルドのコマンド
- コードスタイルとレビュー{要件|ようけん}
- {過去|かこ}の{落|お}とし{穴|あな}と{業務|ぎょうむ}{制約|せいやく}

{価値|かち}：

- {毎回|まいかい}の{対話|たいわ}でプロジェクトルールを{自動的|じどうてき}に{含|ふく}められる
- 「プロジェクト{背景|はいけい}の{説明|せつめい}を{繰|く}り{返|かえ}す」コストを{下|さ}げる

---

# なぜSkillのほうがMCPよりチームでの{初期|しょき}{導入|どうにゅう}に{向|む}いているのか

Skillがより{適|てき}しているのは：

- code review
- changelog{生成|せいせい}
- YApi docs-sync
- {問題|もんだい}{調査|ちょうさ}
- {公開前|こうかいまえ}{確認|かくにん}
- onboarding

{本質的|ほんしつてき}には：

## {方法|ほうほう}、{手順|てじゅん}、{制約|せいやく}、スクリプト

であり、ただの「{外部|がいぶ}{接続|せつぞく}プロトコル」ではない。

---

# Skillの5つの{強|つよ}み

1. チームの{方法論|ほうほうろん}を{蓄積|ちくせき}しやすい
2. バージョン{管理|かんり}とレビューがしやすい
3. {権限|けんげん}{範囲|はんい}が{通常|つうじょう}より{小|ちい}さい
4. {再現性|さいげんせい}がより{高|たか}い
5. まず{導入|どうにゅう}して、そのあと{拡張|かくちょう}しやすい

ひとことで{言|い}うと：

## Skillはより「{標準作業手順書|ひょうじゅんさぎょうてじゅんしょ}」に{近|ちか}い

---

# MCPは{有用|ゆうよう}だが、{既定|きてい}の{答|こた}えではない

MCPがより{向|む}いているのは：

- Figma
- Jira / Linear
- Google Drive / Docs
- Slack / {外部|がいぶ}{知識|ちしき}ベース
- リアルタイムデータシステム

それが{解決|かいけつ}するのは：

## {接続|せつぞく}{問題|もんだい}

であって、

## チームの{方法論|ほうほうろん}の{問題|もんだい}

ではない。

---

# MCPのいくつかの{現実的|げんじつてき}な{問題|もんだい}

1. {接続|せつぞく}は{解決|かいけつ}しても、{方法|ほうほう}は{解決|かいけつ}しない
2. ガバナンスコストがより{高|たか}い
3. セキュリティ{面|めん}がより{広|ひろ}い
4. プロジェクトの{暗黙的|あんもくてき}ルールを{載|の}せるのに{向|む}かない

{典型的|てんけいてき}な{暗黙的|あんもくてき}ルールには{次|つぎ}がある：

- どのディレクトリに{触|ふ}れてはいけないか
- どのフィールドを{変更|へんこう}してはいけないか
- どのテスト{群|ぐん}を{必|かなら}ず{実行|じっこう}しなければならないか
- どの{種類|しゅるい}の{問題|もんだい}でまずどのログを{見|み}るべきか

これらは`AGENTS.md`とSkillに{書|か}くほうが{適|てき}している。

---
layout: section
---

# 4. {原理|げんり}レベルを{明確|めいかく}に{説明|せつめい}する

---

# モデルはどうやってこれらの{仕組|しく}みをいつ{使|つか}うかを{知|し}るのか

| {仕組|しく}み | {本質|ほんしつ} | だれが{起動|きどう}するか |
|------|------|--------|
| `AGENTS.md` | リポジトリ{単位|たんい}の{永続的|えいぞくてき}{説明書|せつめいしょ} | agent / ホストが{作業|さぎょう}{開始|かいし}時に{読|よ}み{込|こ}む |
| `CLAUDE.md` | Claude Codeの{永続的|えいぞくてき}{説明|せつめい}ファイル | {起動時|きどうじ}に{読|よ}み{込|こ}み、{下位|かい}{階層|そう}は{必要時|ひつようじ}に{読|よ}み{込|こ}む |
| Skill | {再利用|さいりよう}できるワークフローパッケージ | モデルの{一致判定|いっちはんてい}またはユーザーの{明示的|めいじてき}{指定|してい} |
| MCP Prompt | テンプレートprompt | ユーザーが{起動|きどう}する |
| MCP Resource | {外部|がいぶ}コンテキスト | アプリが{追加|ついか}する、またはユーザーが{参照|さんしょう}する |
| MCP Tool | {外部|がいぶ}{操作|そうさ}インターフェース | モデルが{呼|よ}び{出|だ}しを{判断|はんだん}する |

---

# MCPの{原理|げんり}とは{何|なに}か

MCPはプラグインではなく、1つのプロトコルである。

{中核|ちゅうかく}{構造|こうぞう}：

- host
- client
- server

{中核|ちゅうかく}{機能|きのう}：

- prompts
- resources
- tools
- sampling

{動作|どうさ}{方式|ほうしき}：

1. initialize
2. capability negotiation
3. normal operation

---

# Skillの{原理|げんり}とは{何|なに}か

Skillは1つのprompt{文|ぶん}ではない。

それはむしろ、ディレクトリ{構成|こうせい}されたワークフローパッケージに{近|ちか}い：

- `SKILL.md`
- scripts
- references
- resources

{重要|じゅうよう}なポイント：

## {必要|ひつよう}なときだけ{読|よ}み{込|こ}み、{常時|じょうじ}コンテキストを{占有|せんゆう}しない

これこそがSkillが「{長大|ちょうだい}なシステムプロンプト」より{効率的|こうりつてき}である{理由|りゆう}でもある。

---

# `CLAUDE.md`と`AGENTS.md`の{違|ちが}い

{共通点|きょうつうてん}：

- どちらも{永続的|えいぞくてき}{説明|せつめい}ファイルである
- どちらもcoding agentにプロジェクトルールを{注入|ちゅうにゅう}するために{使|つか}われる

{違|ちが}い：

- `CLAUDE.md`：Anthropicはより{詳細|しょうさい}な{読|よ}み{込|こ}み{仕組|しく}みを{公開|こうかい}している
- `AGENTS.md`：OpenAIはpersistent contextを{提供|ていきょう}すると{明言|めいげん}しているが、{実装|じっそう}{詳細|しょうさい}の{公開|こうかい}はより{少|すく}ない

{結論|けつろん}：

## どちらもツール{呼|よ}び{出|だ}し{機構|きこう}ではなく、{長期的|ちょうきてき}コンテキストへの{入口|いりぐち}である

---
layout: section
---

# 5. {安全|あんぜん}、サンドボックス、{権限制御|けんげんせいぎょ}

---

# AIプログラミングは{効率|こうりつ}だけを{語|かた}ってはいけない

ひとたびagentが{次|つぎ}をできるようになると：

- ファイルを{読|よ}む
- コードを{修正|しゅうせい}する
- コマンドを{実行|じっこう}する
- ネットワークに{接続|せつぞく}する

リスクモデルは{完全|かんぜん}に{変|か}わる。

{本当|ほんとう}に{議論|ぎろん}すべきなのは：

- ファイルシステム{分離|ぶんり}
- ネットワーク{分離|ぶんり}
- {最小権限|さいしょうけんげん}
- {人手|ひとで}による{確認|かくにん}
- {全経路|ぜんけいろ}{追跡|ついせき}可能性

---

# チームが{少|すく}なくとも{実現|じつげん}すべき5つのこと

1. {既定|きてい}で{最小権限|さいしょうけんげん}
2. ファイルシステム{境界|きょうかい}を{限定|げんてい}する
3. ネットワークのホワイトリスト
4. すべての{越権|えっけん}を{可視化|かしか}する
5. {高|こう}リスク{操作|そうさ}は{必|かなら}ず{人手|ひとで}で{確認|かくにん}する

{高|こう}リスク{操作|そうさ}の{例|れい}：

- {遠隔|えんかく}ブランチへpushする
- {本番|ほんばん}{設定|せってい}を{変更|へんこう}する
- {大量|たいりょう}のファイルを{削除|さくじょ}する
- データベース{変更|へんこう}を{実行|じっこう}する
- {実際|じっさい}の{本番|ほんばん}{書|か}き{込|こ}みAPIを{呼|よ}ぶ

---
layout: section
---

# 6. どう{効果|こうか}を{測|はか}るか、demoだけではない

---

# なぜデモだけを{見|み}てはいけないのか

Demoがしばしば{答|こた}えるのは：

- それが{賢|かしこ}そうに{見|み}えるか
- それがそれらしいコード{断片|だんぺん}を{生成|せいせい}できるか

チームが{本当|ほんとう}に{問|と}うべきなのは：

- それが{実際|じっさい}の{作業|さぎょう}を{安定的|あんていてき}に{処理|しょり}できるか
- それがチーム{環境|かんきょう}で{再現|さいげん}できるか
- それがどれだけ{手戻|てもど}りと{審査|しんさ}コストを{増|ふ}やすか
- それが{本当|ほんとう}に{提供|ていきょう}{効率|こうりつ}を{上|あ}げるか

---

# {外部|がいぶ}benchmarkで{何|なに}が{見|み}えるか

SWE-benchの{価値|かち}：

- {実際|じっさい}のGitHub issue
- {再現可能|さいげんかのう}な{評価|ひょうか}{環境|かんきょう}
- {見|み}ているのは「{本当|ほんとう}に{修正|しゅうせい}してテストに{通|とお}せるか」

それが{示|しめ}せるのは：

## AIプログラミングの{評価|ひょうか}はdemo{動画|どうが}や{単発|たんぱつ}サンプルだけを{見|み}てはいけないということ

しかし、それは{直接的|ちょくせつてき}に{次|つぎ}と{同義|どうぎ}ではない：

## あなたたちのチームはすでに{効率化|こうりつか}できている

---

# チームがより{追跡|ついせき}すべき8つの{指標|しひょう}

- {最初|さいしょ}の{実用的|じつようてき}なpatchまでの{時間|じかん}
- {作業|さぎょう}{完了率|かんりょうりつ}
- 1{回|かい}での{統合率|とうごうりつ}
- {人手|ひとで}による{手戻|てもど}り{時間|じかん}
- テスト{通過率|つうかりつ}
- レビュー{差|さ}し{戻|もど}し{率|りつ}
- ドキュメント{同期率|どうきりつ}
- {安全|あんぜん}な{越権|えっけん}{回数|かいすう}

ひとことで{言|い}うと：

## {見|み}るべきは{実際|じっさい}の{作業|さぎょう}{完了|かんりょう}{品質|ひんしつ}であり、{生成|せいせい}{速度|そくど}だけではない

---
layout: section
---

# 7. チームの{現実的|げんじつてき}な{導入|どうにゅう}に{戻|もど}る

---

# {私|わたし}たちの{現在|げんざい}の{導入|どうにゅう}{方法|ほうほう}

- Planモードでまず{分解|ぶんかい}してから{開発|かいはつ}する
- Skill{体系|たいけい}で{高頻度|こうひんど}プロセスを{固定化|こていか}する
- YApi docs-syncでインターフェースの{唯一|ゆいいつ}の{事実源|じじつげん}を{統一|とういつ}する
- Changelogで{変更|へんこう}{履歴|りれき}を{残|のこ}す
- AIが{第1段階|だいいちだんかい}レビューを行い、{人|ひと}が{最終|さいしゅう}{判断|はんだん}をする

{目標|もくひょう}は「AIに{人|ひと}を{置|お}き{換|か}えさせる」ことではなく、

むしろ：

## AIを{研究開発|けんきゅうかいはつ}プロセスに{入|い}れ、{安定的|あんていてき}な{生産力|せいさんりょく}にすること

---

# {私|わたし}たちのチームで、どのSkillが{最|もっと}も{価値|かち}があるか

{全体|ぜんたい}{共通|きょうつう}レベル：

- YApi Skill
- ZenTao Skill

プロジェクトレベル：

- ログ Skill
- KV Skill
- データベース Skill

{価値|かち}は「どれだけ{高度|こうど}か」にあるのではなく、

むしろ：

## {高頻度|こうひんど}で、{安定|あんてい}していて、{再利用|さいりよう}でき、レビューできること

---

# 1つの{実際|じっさい}の{協業|きょうぎょう}ケース

インターフェース{項目|こうもく}が{変更|へんこう}されたとき：

- バックエンド：コードを{修正|しゅうせい}する
- バックエンド：YApi Skillでdocs-syncをする
- フロントエンド：YApiの{変更|へんこう}を{読|よ}む
- フロントエンドとバックエンド：Planに{沿|そ}って{接続試験|せつぞくしけん}を{調整|ちょうせい}する

{効果|こうか}：

- ドキュメントとコードの{整合性|せいごうせい}が{高|たか}まる
- {重複|ちょうふく}コミュニケーションが{減|へ}る
- YApiが{唯一|ゆいいつ}の{事実源|じじつげん}になる

---

# チーム{導入|どうにゅう}で{最|もっと}も{現実的|げんじつてき}な{順序|じゅんじょ}

1. まず`AGENTS.md`をきちんと{書|か}く
2. {高頻度|こうひんど}{作業|さぎょう}をSkillにする
3. {必要|ひつよう}な{外部|がいぶ}システムだけをMCPに{接続|せつぞく}する
4. {最後|さいご}にautomationsとmulti-agentを{検討|けんとう}する

この{順序|じゅんじょ}は「先にツールを積み上げて、そのあと{統治|とうち}を{補|おぎな}う」より{安定|あんてい}している。

---
layout: section
---

# 8. {最後|さいご}に4つの{言葉|ことば}だけ{覚|おぼ}える

---

# {核心的|かくしんてき}{結論|けつろん}

1. AIプログラミングはすでに「コード{補完|ほかん}」から「Agentic Coding」へ{進|すす}んでいる
2. チーム{導入|どうにゅう}の{鍵|かぎ}はモデル{参数|ぱらめーた}ではなく、コンテキストエンジニアリングである
3. {既定|きてい}の{優先順位|ゆうせんじゅんい}は`AGENTS.md` > Skill > MCPであるべきだ
4. AIプログラミングの{評価|ひょうか}はdemoだけを{見|み}てはならず、{境界|きょうかい}、{品質|ひんしつ}、{実際|じっさい}の{研究開発|けんきゅうかいはつ}{指標|しひょう}を{見|み}るべきだ

---

# {参考資料|さんこうしりょう}

- OpenAI《Introducing Codex》
- OpenAI《Introducing the Codex app》
- OpenAI PDF《How OpenAI uses Codex》
- Anthropic《Claude Code overview》
- Anthropic《How Claude remembers your project》
- Anthropic《Making Claude Code more secure and autonomous with sandboxing》
- MCP {公式|こうしき}{仕様|しよう} / MCP Architecture
- SWE-bench {公式|こうしき} Overview

---

# ありがとうございました

{議論|ぎろん}キーワード：

`Agentic Coding` / `Skill` / `MCP` / `AGENTS.md` / `CLAUDE.md`