mcpField
A
agent-cli-creator

agent-cli-creator

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

agent-cli-creator について

agent-cli-creator は、kimi-webbridge ブラウザデーモンを使う Web サイト自動化 CLI の構築を AI コーディングエージェントに案内するスキルです。実装前のサイト調査から、コマンドの段階的な検証、利用手順スキルの作成までを定めています。

主な機能

  1. 01kimi-webbridge の状態を確認
  2. 02サイトと初期機能の要件を収集
  3. 03コーディング前のサイト調査を必須化
  4. 04読み取り、書き込みの順で実装
  5. 05コマンドとエラー出力を個別に検証
  6. 06利用手順の補助スキルを作成

活用シーン

  1. 01特定サイト向け自動化 CLI の計画
  2. 02実装前にサイト API 呼び出しを検証
  3. 03CLI コマンドとエラー処理を段階的にテスト
  4. 04将来のエージェント向け利用ガイド作成

インストール

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

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

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

同梱ファイル

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

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

詳細

Agent CLI Creator

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

フェーズ 1: 前提条件

~/.kimi-webbridge/bin/kimi-webbridge status
結果対応
running: true + extension_connected: true続行
コマンドが見つからないユーザーに https://www.kimi.com/features/webbridge (中文: https://www.kimi.com/zh-cn/features/webbridge) を訪問してインストールするよう伝える
running: false または extension_connected: falsekimi-webbridge スキル → references/operations.md を呼び出す

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

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

  1. 対象 Web サイトの URL (必須)
  2. プログラミング言語 — Go (推奨。references/go-layout.md が標準テンプレート) / Python / Node.js / その他
  3. ログインは必要ですか? — はい / いいえ / 不明 (今はスキップ可能)
  4. 最初の 1〜3 個の機能 — 一般的なカテゴリから選択:
    • 読み取り: ホームフィード、検索、プロフィールページ、投稿/アイテム詳細
    • 書き込み: 投稿作成、いいね/いいね解除、コメント、ブックマーク/保存
    • アカウント: ログイン状態、ユーザー情報

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

「まず 1〜3 個の機能から始めて、さらに追加する前にアプローチをエンドツーエンドで検証します。まだ必要のない機能のためにサイトを探索するのは時間の無駄です。機能は後からフェーズ 3 から再実行していつでも追加できます。」

フェーズ 3: サイト探索 (コードを書く前に必須)

このフェーズは省略できません。探索が完了するまでビジネスロジックを書かないでください。

計画した各機能について、references/site-exploration.md にある完全なプロトコルを実行します。

このプロトコルから得られるもの: API エンドポイント、必要なヘッダー、レスポンスの形状、そしてブラウザセッション内で API が動作することを証明する検証済みの evaluate 呼び出しです。

あらゆる制限事項を書き留める前に健全性を確認してください: 人間が自分のブラウザで同じフローをクリックして進めた場合、その制限に遭遇するでしょうか? 遭遇しない場合、その違いはあなたの自動化設定 (タブの可視性、イベントのタイミング、ハイドレーション) にあり、サイト側にはありません。実際の例: 「検索は 20 件で上限に達する」というものがありますが、人間がそのページをスクロールすると 200 件取得できます — references/site-exploration.md → The Background Tab Trap を参照してください。

計画したすべての機能について動作する 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 初始化独立 module，按 references/go-layout.md 的结构搭建，包含自己的轻量 browser client 和 output helper。

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

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

目的: 将来の AI エージェントに、CLI をどのように使うかを伝えるものであり、どのように構築するかではありません。2 つのスキルは、異なる時点で異なる対象者に役立ちます。

コメント

Markdown 対応