agent-cli-creator

Agent CLI 创建器

指导 AI 编码 Agent 构建一个由 kimi-webbridge 浏览器守护进程支持的网站自动化 CLI 工具。

阶段 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: false	调用 kimi-webbridge 技能 → references/operations.md

阶段 2：需求访谈

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

1. 目标网站 URL（必填）
2. 编程语言——Go（如果本仓库使用 Go，建议选择）/ Python / Node.js / 其他
3. 是否需要登录？——是 / 否 / 未知（可以暂时跳过）
4. 首批 1–3 项功能——从常见类别中选择：
   • 读取：主页信息流、搜索、个人资料页、帖子/项目详情
   • 写入：创建帖子、点赞/取消点赞、评论、收藏/保存
   • 账号：登录状态、用户信息

向用户说明迭代开发：

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

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

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

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

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

只有在每项计划实现的功能都拥有可用的 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，而不是如何构建它。这两个技能面向不同受众，服务于不同阶段。