mcpField
A
agent-cli-creator

agent-cli-creator

github.com/better-world-ai開発43299 回インストール9 週間前に更新
リポジトリ

agent-cli-creator について

kimi-webbridgeのブラウザデーモンを使ったWebサイト自動化CLIの開発を、AIコーディングエージェントに案内するスキルです。要件確認、サイトAPIの調査、段階的な実装と検証を経て、CLI用の補助スキルも作成します。

主な機能

  1. 01kimi-webbridgeの状態確認
  2. 02サイトと機能要件のヒアリング
  3. 03サイトAPIの調査と検証
  4. 04CLIの段階的な実装とテスト
  5. 05CLI用補助スキルの作成

活用シーン

  1. 01対象サイト向け自動化CLIの計画
  2. 02実装前のブラウザーセッション内API検証
  3. 03CLIコマンドの個別実装と動作確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/better-world-ai/x-cli --skill agent-cli-creator

インストール後、Claude Code で/agent-cli-creatorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
go-layout.md
site-exploration.md
companion-skill-template.md
login-handling.md

詳細

エージェント CLI クリエーター

kimi-webbridge ブラウザデーモンを利用してウェブサイトを自動化する CLI ツールを構築するよう、AI コーディングエージェントをガイドします。

フェーズ 1：前提条件

~/.kimi-webbridge/bin/kimi-webbridge status
結果アクション
running: true + extension_connected: true続行します
コマンドが見つからないインストールするには、ユーザーに https://www.kimi.team/features/webbridge（中文: https://www.kimi.team/zh-cn/features/webbridge）へアクセスするよう伝えます
running: false または extension_connected: falsekimi-webbridge スキル → references/operations.md を呼び出します

フェーズ 2：要件のヒアリング

ユーザーに1つのメッセージで質問し、返信を待ちます：

  1. 対象ウェブサイトの URL（必須）
  2. プログラミング言語 — Go（このリポジトリで使われている場合は推奨）／Python／Node.js／その他
  3. ログインが必要ですか？ — はい／いいえ／不明（今はスキップできます）
  4. 最初に実装する機能を1〜3個 — よくあるカテゴリから選択します：
    • 読み取り：ホームフィード、検索、プロフィールページ、投稿／アイテムの詳細
    • 書き込み：投稿の作成、いいね／いいねの取り消し、コメント、ブックマーク／保存
    • アカウント：ログイン状態、ユーザー情報

反復的な開発についてユーザーに説明します：

「まず1〜3個の機能から始め、アプローチを最初から最後まで検証してから、さらに追加します。まだ必要のない機能のサイト調査に時間をかけるのは無駄です。機能は後からいつでも追加できます。その場合はフェーズ 3 から再開してください。」

フェーズ 3：サイト調査（コードを書く前に必須）

このフェーズは必須です。調査が完了するまで、ビジネスロジックを書いてはいけません。

予定している機能ごとに、references/site-exploration.md に記載されたプロトコルを最後まで実行します。

このプロトコルでは、API エンドポイント、必要なヘッダー、レスポンスの形式、およびブラウザーセッション内で API が動作することを証明する、検証済みの evaluate 呼び出しを特定します。

予定しているすべての機能について、動作する evaluate 呼び出しを確認してから、フェーズ 4 に進んでください。

フェーズ 4：実装

順序が重要です。先に進んだり、手順を飛ばしたりしないでください：

  1. プロジェクトのひな形作成 — Go の場合は references/go-layout.md を参照し、その他の言語では各言語の慣習に合わせます
  2. login-status コマンド — サイトでログインが必要な場合は、references/login-handling.md を参照します
  3. 読み取りコマンド — 副作用はありません。先に実装してテストします
  4. 書き込みコマンド — 副作用があります（投稿、いいねなど）。読み取りが動作してから実装します

各コマンドの実装後、次に進む前にただちに検証してください：

{platform}-cli {command} --help          # --help must work
{platform}-cli {command} [args]          # must return {"ok": true, "data": ...}

書き込みコマンドでは、エラーパスの検証も行ってください（例：ID の誤りや必須フラグの不足で、{"ok": false, ...} を返し、終了コードがゼロ以外になること）。

検証に失敗した場合は、次のコマンドの実装に進む前に修正してください。

すべての言語に共通する CLI の仕様：

  • すべてのコマンドで --help / -h が動作すること
  • すべての出力は {"ok": true, "data": ...} または {"ok": false, "error": {"code": "...", "message": "..."}} であること
  • エラー時はゼロ以外の終了コードを返すこと

Go： go mod init {platform}-cli を使って独立したモジュールを初期化し、references/go-layout.md の構成に従って、独自の軽量ブラウザークライアントと出力ヘルパーを含めて構築します。

フェーズ 5：コンパニオンスキルの作成

CLI が動作したら、references/companion-skill-template.md のテンプレートを使って ~/.claude/skills/{platform}-cli/SKILL.md を作成します。

目的： 将来の AI エージェントに CLI の「使い方」を伝えることです。CLI の構築方法ではありません。この2つのスキルは、それぞれ異なる利用者に、異なるタイミングで役立ちます。

コメント

Markdown 対応