{
  "markdown": "# ZooKeeper\n\n同时适配 OpenCode 和 pi 两个宿主的编排器插件，具备静态权限配置 + 运行时 Prompt 注入。\n\n## 功能特性\n\n### Agent 定义\n\n| Agent | 角色 |\n|-------|------|\n| `dolphin` | 编排器 — 任务分发与结果验证 |\n| `mola` | 规划顾问 — 产出 plan artifacts 到 `.zoo/plans`，不执行代码 |\n| `lynx` | 代码探索 — 搜索和理解代码库，只读 |\n| `beaver` | 编码实现 — 读写文件、执行命令 |\n| `spider` | 网络调研 — 网页抓取和信息收集 |\n| `eagle` | 代码审查 — 只读审查，由 code-review 技能加载 |\n| `kiwi` | 知识分析 — wiki 蒸馏/验证，由对应技能加载 |\n\n### 运行时增强\n\n插件在运行时通过 Prompt 注入和行为引导 hook 增强 Agent 能力：\n\n- **Prompt 注入**：自动将 `src/agents/<name>.ts` 中定义的 prompt 常量注入到对应 Agent，无需手动配置\n- **Task Prompt 校验**：拦截格式不合规的 `task()` 调用，要求包含 SUMMARY / CONTEXT / ACCEPTANCE 三段式结构\n- **直接工作提醒**：当编排器直接执行代码编辑时，提醒其应当委派子代理完成任务\n- **JSON 错误恢复**：检测工具输出中的 JSON 解析错误，自动注入修复提示\n- **任务完成验证**：每次子代理返回后，注入标准化的验证清单（post-task nudge），确保结果被严格审查\n- **Prompt 长度检测**：自动检测 Task Prompt 是否过长或包含不推荐的代码片段\n- **上下文管理**：自动管理上下文，包括消息去重、错误清理、压缩与用量提醒\n- **模型变体**：支持为不同 Agent 分配模型变体（high / low / max 等）\n\n### 技能管理\n\n插件内置 10 个技能，存放在 `core/skills/` 目录下（每个技能为一个独立子目录），会根据任务类型按需自动加载：\n\n- `beaver-tdd` — 测试驱动开发\n- `code-review` — 代码审查\n- `git-commit` — 标准化的 Git 提交\n- `grill` — 计划/设计审查，沿决策树逐层质询直至达成共识\n- `kiwi-distill` — 知识蒸馏\n- `kiwi-verify` — 源回溯验证\n- `mola-plan` — 从需求澄清到计划落地\n- `wiki-ingest` — wiki 知识收录\n- `wiki-query` — wiki 知识查询\n- `wiki-verify` — wiki 知识验证\n\n## 安装\n\n### 前置要求\n\n- Python 3（无需额外依赖，仅使用标准库）\n- OpenCode 和/或 pi（`install.py` 自动检测已安装的宿主，缺失则跳过对应配置）\n\n### 安装步骤\n\n**1. 克隆仓库**\n\n```bash\ngit clone <repository-url>\ncd ZooKeeper\n```\n\n**2. 配置环境变量**\n\n```bash\ncp .env.example .env\n```\n\n编辑 `.env`，填入你的 LLM API 凭据：\n\n```\n# 模型 ID\nZOO_WHALE_MODEL=Cambricon/glm-5.1\nZOO_HIPPO_MODEL=Cambricon/glm-5.1\nZOO_ANT_MODEL=Cambricon/deepseek-v4-flash\n\n# Provider 凭据 — 只需设置你实际使用的 Provider，其余可注释或留空\nCAMBRICON_API_KEY=your-api-key-here\nCAMBRICON_BASE_URL=https://api.example.com/v1\nDEEPSEEK_API_KEY=your-deepseek-api-key-here\nDEEPSEEK_BASE_URL=https://api.deepseek.com/anthropic\n\n# GitLab MCP（可选）\nGITLAB_MCP_URL=https://api.example.com/mcp\nGITLAB_ACCESS_TOKEN=your-gitlab-private-token-here\n```\n\n**3. 生成宿主配置**\n\n```bash\nuv run python install.py\nuv run python install.py --mono  # 单智能体模式\n```\n\n**4. 添加 CLI 工具到 PATH**\n\n将 `~/.zoo/tools/bin` 加入 `PATH` 后即可使用：\n\n- `zwiki` — wiki 知识库管理\n- `zlog` — 日志过滤\n- `zfind` — 会话搜索\n- `zinspect` — 事件统计\n- `ztrace` — 编排追踪\n",
  "bytes": 2210,
  "sha": "6a6243fd3588d7098f48f4ef01951b6fbc70def245e37c8311f1173cc50773cc",
  "repo_slug": "418-teapot/zookeeper",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_418_teapot_zookeeper_wiki_index_md_665ccd23/readme"
}