> ~/hayashigoto/works/agent-tools/

Agent Toolsは、AIエージェントが作業中に呼び出す三つのCLIです。自然言語の解釈はモデルへ任せ、サイトの収集、UIの検証、文書の出力だけを再現可能な処理として切り出しました。

三つの役割

• sitesnap：公開サイトをデスクトップとモバイルで収集し、スクリーンショット、マニフェスト、実行記録を保存する
• Shimon：開発中のUIを同じ状態へ戻し、overflow、console error、a11y、プロジェクト固有の条件とスクリーンショットを検査する
• pdfmint：HTMLやMarkdownを日本語組版のPDFと確認用PNGへ変換し、ページ数などの結果をJSONで返す

三つともNode.js 22以上で動きます。処理結果を標準出力のJSONとファイルの両方へ残し、次の判断に使う値と、人が開いて確認する成果物を分けています。

ツールと判断を分離する

CLIは、画面が美しいか、変更が妥当か、文書が読みやすいかまでは決めません。観測、変換、保存だけを安定させ、評価は作業の目的を知る人とエージェントへ残します。Agent Skillには使う場面と失敗時の対応を書き、ブラウザ操作やファイル生成の本体はCLIへ置いています。

現在の位置づけ

モデル自身が検証用のツールを作り、アプリ内のブラウザや成果物機能を直接使えるようになったため、現在は自分の開発に必須ではありません。必要性が短期間で薄れたことも含め、エージェント向けツールの責務をどこまで固定すべきかを試した事例として残しています。