名称： hokipoki
描述： "使用 HokiPoki CLI 无需切换标签页即可切换 AI 模型。当某个模型卡住时，可在 Claude、Codex 和 Gemini 之间跳转。适用于以下场景：用户希望请求其他 AI 模型帮助、跳转到另一个 AI、获取其他模型的第二意见、切换模型、与团队成员共享 AI 订阅，或管理 HokiPoki 的提供者/监听器模式。触发词包括：‘用 codex/gemini 处理这个’、‘跳转到其他模型’、‘问问其他 AI’、‘获取第二意见’、‘切换模型’、‘hokipoki’、‘监听请求’。"

HokiPoki 技能

通过 HokiPoki P2P 网络将任务路由到不同的 AI CLI（Claude、Codex、Gemini）。API 密钥始终保留在提供者的机器上，仅交换加密的请求和结果。

前提条件

必须安装并完成 HokiPoki CLI 的认证：

npm install -g @next-halo/hokipoki-cli
hokipoki login

使用 hokipoki whoami 验证安装。如果未安装，请引导用户完成设置。

请求其他 AI 帮助

将任务发送到远程 AI 模型。为获得可解析的输出，请始终使用 --json 参数：

# 指定文件
hokipoki request --tool claude --task "修复认证错误" --files src/auth.ts --json

# 整个目录
hokipoki request --tool codex --task "添加错误处理" --dir src/services/ --json

# 整个项目（遵循 .gitignore）
hokipoki request --tool gemini --task "审查安全性问题" --all --json

# 路由到团队工作空间
hokipoki request --tool claude --task "优化查询" --files src/db.ts --workspace my-team --json

# 跳过自动应用（仅保存补丁）
hokipoki request --tool codex --task "重构模块" --dir src/ --no-auto-apply --json

模型选择：如果用户未指定模型，请询问使用哪个模型，或省略 --tool 参数让 HokiPoki 自动选择。

补丁自动应用

当目标目录是已提交文件的 Git 仓库时，补丁会自动应用。如果自动应用失败，请通知用户并建议：

git init && git add . && git commit -m "initial"

提供者模式（共享你的 AI）

注册并监听传入的请求：

# 注册为提供者（一次性操作）
hokipoki register --as-provider --tools claude codex gemini

# 开始监听
hokipoki listen --tools claude codex

任务在隔离的 Docker 容器中执行（只读文件系统、tmpfs 工作空间、自动清理）。Docker 必须处于运行状态。

状态与账户

hokipoki whoami      # 当前用户信息
hokipoki status      # 账户、工作空间、历史记录
hokipoki dashboard   # 在浏览器中打开网页控制面板

何时建议跳转

• 用户多次尝试后仍卡在某个问题上
• 用户要求不同的方法或新视角
• 任务涉及另一个模型擅长的领域（例如，Codex 适合样板代码，Gemini 适合大上下文分析）
• 用户明确要求尝试其他 AI

完整命令参考

查看 references/commands.md 获取所有 CLI 选项、认证令牌位置及高级用法。