hokipoki

HokiPoki 是一个用于在不同 AI CLI 之间路由任务的技能，核心目的是让用户无需切换标签页，就能在 Claude、Codex、Gemini 等模型之间“跳转”，当某个模型卡住时换一个模型继续处理。它通过 HokiPoki P2P 网络工作，API 密钥不会离开提供方的机器，网络中只交换加密的请求和结果。

用途

该技能适用于以下场景：用户多次尝试后仍卡在某个问题上；用户希望换一种思路或获得新的视角；任务涉及某个模型更擅长的领域（例如 Codex 适合样板代码，Gemini 适合大上下文分析）；或者用户明确要求尝试另一个 AI。

前置条件

使用前必须安装并认证 HokiPoki CLI：

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

可用 hokipoki whoami 验证。如果尚未安装，需要引导用户完成设置。

向另一个 AI 请求帮助

向远程 AI 模型发送任务时，建议始终使用 --json 以获得可解析的输出。示例命令包括：

指定文件

hokipoki request --tool claude --task "Fix the auth bug" --files src/auth.ts --json

整个目录

hokipoki request --tool codex --task "Add error handling" --dir src/services/ --json

整个项目（遵循 .gitignore）

hokipoki request --tool gemini --task "Review for security issues" --all --json

路由到团队工作区

hokipoki request --tool claude --task "Optimize queries" --files src/db.ts --workspace my-team --json

跳过自动应用（仅保存补丁）

hokipoki request --tool codex --task "Refactor module" --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 # 在浏览器中打开 Web 仪表盘

完整命令参考

所有 CLI 选项、认证令牌位置和高级用法可参见 references/commands.md。