mcpField
A
agent-cli-creator

agent-cli-creator

github.com/better-world-ai开发2881 次安装10 周前更新
代码仓库

关于 agent-cli-creator

agent-cli-creator 是指导 AI 编码 Agent 构建网站自动化命令行工具的技能，工具以 kimi-webbridge 浏览器守护进程为基础。它规定了先探索网站、再逐项实现和验证命令的开发流程。

主要功能

  1. 01检查 kimi-webbridge 运行状态
  2. 02访谈确认网站与首批功能需求
  3. 03要求编码前完成网站探索
  4. 04按读取和写入顺序实现命令
  5. 05逐条验证命令与错误输出
  6. 06生成配套使用技能

适用场景

  1. 01规划针对特定网站的自动化 CLI
  2. 02在实现前验证网站 API 调用
  3. 03逐项测试 CLI 命令及错误路径
  4. 04为后续 Agent 编写 CLI 使用指南

安装

复制下面的命令，在终端中运行。

$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 创建器

指导 AI 编码 Agent 构建一个由 kimi-webbridge 浏览器守护进程支持的网站自动化 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: false调用 kimi-webbridge 技能 → references/operations.md

阶段 2：需求访谈

在一条消息中询问用户，然后等待回复：

  1. 目标网站 URL（必填）
  2. 编程语言——Go（推荐；references/go-layout.md 是规范模板）/ Python / Node.js / Other
  3. 是否需要登录？——是 / 否 / 未知（暂时可以跳过）
  4. 首批 1–3 项功能——从常见类别中选择：
    • 读取：主页信息流、搜索、个人资料页面、帖子/条目详情
    • 写入：创建帖子、点赞/取消点赞、评论、收藏/保存
    • 账户：登录状态、用户信息

向用户说明迭代开发方式：

“我们将从 1–3 项功能开始，端到端验证方案后再添加更多功能。探索暂时用不到的功能会浪费时间。之后你可以随时从阶段 3 重新开始，以添加更多功能。”

阶段 3：网站探索（编写任何代码前必须完成）

此阶段不可跳过。探索完成前不要编写业务逻辑。

针对每项计划中的功能，运行 references/site-exploration.md 中的完整流程。

该流程将得出：API 端点、必需的请求头、响应结构，以及一个经过验证的 evaluate 调用，以证明 API 在浏览器会话中可用。

**记录任何限制前都要进行合理性检查：**如果人类在自己的浏览器中通过相同流程操作，也会遇到这个限制吗？如果不会，差异就在你的自动化设置中——标签页可见性、事件时机、水合过程——而非网站本身。真实限制的例子：“搜索结果最多为 20 条”，而人类滚动该页面可以看到 200 条——参见 references/site-exploration.md → 后台标签页陷阱。

只有在每项计划中的功能都有可用的 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 Agent 如何使用 CLI，而不是如何构建它。这两个技能面向不同的使用者，适用于不同的阶段。

评论

支持 Markdown