HokiPoki

# HokiPoki Skill

通过 HokiPoki P2P 网络将任务路由到不同的 AI CLI（Claude、Codex、Gemini）。API 密钥永远不会离开提供商的机器；只有加密的请求和结果会被交换。

## 前置条件

必须安装并经过身份验证 HokiPoki CLI：

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

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

## 请求其他 AI 的帮助

向远程 AI 模型发送任务。请始终使用 `--json` 以获得可解析的输出：

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

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

# Whole project (respects .gitignore) hokipoki request --tool gemini --task "Review for security issues" --all --json

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

# Skip auto-apply (just save the patch) hokipoki request --tool codex --task "Refactor module" --dir src/ --no-auto-apply --json ```

工具选择：如果用户未指定工具，请询问使用哪个模型，或省略 `--tool` 以让 HokiPoki 自行选择。

### 补丁自动应用

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

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

## 提供商模式（共享您的 AI）

注册并监听传入请求：

```bash # Register as a provider (one-time) hokipoki register --as-provider --tools claude codex gemini

# Start listening hokipoki listen --tools claude codex ```

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

## 状态与账户

```bash hokipoki whoami # Current user info hokipoki status # Account, workspaces, history hokipoki dashboard # Open web dashboard in browser ```

## 何时建议跳转 - 用户在多次尝试后仍陷入困境 - 用户要求不同的方法或新的视角 - 任务涉及另一个模型擅长的领域（例如，使用 Codex 生成样板代码，使用 Gemini 进行大上下文分析） - 用户明确要求尝试另一个 AI

## 完整命令参考

请参阅 [references/commands.md](references/commands.md) 了解所有 CLI 选项、身份验证令牌位置和高级用法。