Smalltalk における AI エージェントの課題

AI コーディングエージェントをそのまま Smalltalk に使ってもうまくいきません：

• Pharo の知識がない — AI は環境の操作方法を知らない
• プロジェクト構造が不明 — Tonelやパッケージ構成を知らない
• テスト・デバッグができない — テスト実行やエラー診断の仕方がわからない
• ライブラリへのアクセスができない — 既存のクラスやメソッドを参照できない
• コーディングスタイルが悪い — Smalltalk のイディオムや慣習を知らない

smalltalk-dev-plugin の登場

AI に Smalltalk 開発の完全なスキルセットを与えました：

結果: AI が信頼できる Smalltalk 開発パートナーになります！

コアとなる哲学

「AIによる編集を唯一の真実の源として扱う」

AI が Tonel ファイルを編集し、Pharo にインポートして、テストする という流れを繰り返す。

概要

• 9 個のスラッシュコマンド
• 5 種類の専門 AI スキル
• 22 種の Pharo との連携用 MCP ツール
• 自動コード品質チェックとコメント生成

対応 AI エージェント

本プレゼンテーションでは Claude Code での利用を中心に紹介します。

インストール (1) — プラグインのインストール

# GitHub からマーケットプレイスを追加
claude plugin marketplace add mumez/smalltalk-dev-plugin

# プラグインをインストール
claude plugin install smalltalk-dev

インストール (2) — Pharo 側のセットアップ

オプションA: Docker（簡単）

smalltalk-interop-docker を使って設定済み Pharo イメージを起動：

docker compose up -d

オプションB: ローカルでPharoを準備

PharoSmalltalkInteropServerを手動でインストールして起動：

Metacello new
  baseline: 'PharoSmalltalkInteropServer';
  repository: 'github://mumez/PharoSmalltalkInteropServer:main/src';
  load.

SisServer current start.

インストール — その他の AI エージェント

各エージェント向けのセットアップスクリプトが用意されています：

./extra/setup-cursor.sh [target-directory]
./extra/setup-windsurf.sh [target-directory]
./extra/setup-antigravity.sh [target-directory]
./extra/setup-copilot.sh [target-directory]   # GitHub Copilot CLI
./extra/setup-opencode.sh [target-directory]  # OpenCode
./extra/setup-codex.sh [target-directory]     # Codex CLI

制限事項

• エージェントによって機能が異なる場合があります
• Pharo 側のセットアップは Claude Code と同じです

Claude の起動場所

空のディレクトリまたは既存プロジェクトのディレクトリで claude を実行します。

• Iceberg リポジトリのディレクトリを指定することもできます
• ただし競合を避けるため、リポジトリを別のディレクトリにクローンしてそちらを使うことを推奨します

/st-buddy — メインとなるエントリーポイント

/st-buddy は適切なツールに誘導してくれる親しみやすいアシスタントです。

やりたいことを言葉で説明するだけです：

/st-buddy nameとageを持つPersonクラスを作成したい

アシスタントが自動的に以下を行います：

1. 適切なスキルの読み込み
2. Tonel ファイルの作成
3. リント、インポート、テストの支援

/st-buddy — インテリジェントなルーティング

どのツールを使えばよいか覚える必要はありません — /st-buddy に話しかけるだけです。

スキル (1) — 開発者 & デバッガー

smalltalk-developer

コアとなる開発スキル。Tonel フォーマット、パッケージ構造、「編集 → リント → インポート → テスト」のワークフロー全体を把握しています。

smalltalk-debugger

体系的なデバッグの専門家。エラーを診断し、/st-eval を使って段階的にコードを実行し、修正方法をガイドします。

スキル (2) — コードファインダー

smalltalk-usage-finder

クラスやメソッドの使われ方を調査します。使用例を見つけ、利用パターンを分析し、未知の API の理解を助けます。

smalltalk-implementation-finder

クラス階層を横断してメソッドの実装を検索します。コーディングイディオムの学習やリファクタリングの影響評価に役立ちます。

スキル (3) — ドキュメント

smalltalk-commenter

ドキュメント不足のクラスに対して CRC スタイルのクラスコメントを自動提案します。フック経由でファイル編集後にトリガーされます。 機械的にではなく、ドキュメントが最も必要なクラスを優先します。

スラッシュコマンド

MCP サーバー

2 つの MCP サーバーが連携の裏側を支えています：

pharo-interop (22 ツール)

Pharo との通信 — eval、インポート/エクスポート、テスト、コードナビゲーション など。

smalltalk-validator (5 ツール)

Tonel の検証とリント。

注意: これらを直接操作する必要はほとんどありません。
オーケストレーションは /st-buddy が担当します。

例 1 — ゼロからのスタート

空のディレクトリから Smalltalk 初心者として始めるシンプルなユースケース。

/st-buddy 私はSmalltalkの初心者です。
異なる通貨単位間で算術演算を行えるMoneyクラスを作成したいです。
プロジェクトの初期設定から手助けして。

例 2 — グラフアルゴリズム

Smalltalk に慣れたユーザー向けのより複雑なユースケース。

/st-buddy 有向グラフを表現するためにGrNodeとGrArcを作成し、
最短経路問題を解きたいと考えています。
ノードにはnameが、アークにはscoreがあります。
GraphGearプロジェクトとして始めましょう。

例 3 — GUI プログラミング

Spec2 を使った GUI アプリケーションの構築。

/st-buddy Spec2フレームワークを使って、シンプルなToDoリストを作成したい。
各項目にチェックボックスと入力フィールドを配置し、
下部に「追加」と「削除」のボタンを配置する。
削除できるのは、チェックされている項目のみとする。着手して。

pharo-acp

ACP プロトコルで Pharo 側から AI エージェントに接続するためのライブラリ。

接続先: Gemini CLI、Claude Code、OpenCode、Copilot CLI、Codex CLI など

https://github.com/mumez/pharo-acp

pharo-acp-chat-ui

Pharo 向けシンプルな AI Chat GUI。内部で pharo-acp を使用。

https://github.com/mumez/pharo-acp-chat-ui

まとめ

smalltalk-dev-plugin は AI アシスタントによる Pharo Smalltalk 開発を実用的かつ生産的にします。

/st-buddy と入力して、開発を始めましょう。