开发与工程 cliworktreesparallel-agentscode-reviewplanningskillssqliteorchestration

Genie

一句愿望,产出可合并的 PR:先访谈成计划,再并行派发智能体,审查通过后才交给你。

FollowAgents 评估 · FARS-2.1
谨慎使用
67/ 100 五分制 3.4 / 5
1 2 3 4 5 6
1信任安全18 / 29 · 3.1/5

证据显示最小权限设计较扎实:工作流使用精确 SHA 固定 action 并声明最小 permissions;NATS 仅在 omni serve 路径动态加载并有白盒测试佐证;删除操作要求'可证明归属'。扣分点:这些多为文档声明,未提供核心 src 代码佐证实际权限边界;WhatsApp 桥与 ed25519 密钥注册涉及主机侧敏感操作,文档深度有限。

2可靠稳定9 / 14 · 3.2/5

自洽性总体良好(README、SECURITY、package.、测试相互印证),冻结锁文件与固定 Bun 版本支撑依赖可用性;失败消息有稳定诊断文本并有测试断言。扣分点:README 中出现 2026 年的日期与版本号,静态审查无法证实其真实性,且 npm 分发已废弃造成历史版本引用混乱。

3适用触发12 / 18 · 3.3/5

面向明确的开发者受众,平台矩阵覆盖 linux/darwin 并明确排除 darwin-x64;技能以运行时中立形式投递多 agent。扣分点:能力边界与触发精度主要靠文字描述,未见技能本体的触发约束文件;Orca 依赖特定最低版本,兼容性由运行时探测而非静态保证。

4规范维护14 / 18 · 3.9/5

信息架构出色:命令表、技能表、生命周期清晰;安装说明详尽(installer、验证脚本、渠道清单)。许可证为完整 MIT。扣分点:未见 CHANGELOG 文件,版本历史依赖渠道清单描述;示例以命令表为主,缺少端到端示例与 FAQ;维护责任有联系渠道与 SLA,但发布者身份未经独立注册处核验。

5有效结果9 / 13 · 3.5/5

输出可用性有设计(版本化 JSON、doctor 诊断行、board 视图);相对自建编排栈有边际价值(文档进 git + 单 SQLite 文件,零常驻进程)。扣分点:实际产出质量(PR 可合并性)依赖未提供的执行证据;学习成本不低(多模式、渠道、遗留迁移)。

6证据核验5 / 8 · 3.1/5

声明可追溯性较好:验证脚本、固定身份三元组、多渠道交叉核对均有具体路径与退出码;测试文件与 README 声明互证(MCP 退役诊断、action 固定匹配器)。扣分点:大量关键声明(签名发布、供应链事件、CanisterWorm 补救)无法在静态审查中独立证实,事实与营销表述在 README 中偶有混排,2026 时间线存疑。

证据充分度: 评估于 2026年9月10日 审查版本 dad7fb8a7842
使用前请注意
  • README 与 SECURITY.md 中出现 2026 年日期、版本号及一次供应链入侵事件描述;静态审查无法证实其真实性,使用前请通过仓库 Git 历史与外部渠道独立核实。
  • 安装脚本采用 curl | bash 模式;虽然文档声称安装器会验证 cosign/SLSA 签名,请在执行前阅读 install.sh 本体并离线核验固定身份。
  • 技能会写入多个 agent 全局技能目录(~/.claude/skills 等),并可能备份覆盖他方目录;升级前检查备份与 digest 记录。
  • Omni WhatsApp 桥涉及密钥注册与远程审批通道;默认关闭,但启用前应评估消息面风险, unmapped 聊天仅存储不回复这一点需自行确认。
  • npm 分发已废弃且历史 4.x 版本被声明为受损;切勿从 npm 安装,仅使用仓库清单指定的渠道。
  • 本评分为静态审查(置信度低),未执行任何测试;无运行时验证。
查看完整评分方法 →

这个 Agent 能做什么,适合哪些场景?

Genie 是为 AI 编码智能体打造的一层规划与执行系统。你用一句话描述需求,它通过访谈将想法固化为 DESIGN.md 与 WISH.md 计划文档,然后以原生子智能体(subagents)并行执行,并由独立审查者对照验收标准给出 SHIP、FIX-FIRST 或 BLOCKED 裁决。架构刻意轻量:没有守护进程、没有 Postgres,操作状态只存在每个仓库一个 SQLite 文件(.genie/genie.db)中,计划文档以普通 markdown 存放在 git 里。CLI 共 15 个命令、4 个运行时依赖,约 0.9 MB 单文件打包,基于 Bun。技能经 skills.sh 渠道分发到 Claude Code、Codex、Goose、Windsurf 等智能体的技能目录,可选的 Orca 插件则提供托管生命周期模式。所有发布产物经 cosign 无密钥签名并附 SLSA 证明,安装器在运行前校验二进制。

完整流程为:/brainstorm 将模糊想法打磨成 DESIGN.md 并强制设计评审 → /wish 把通过的设计转成带执行分组的 WISH.md → /review 做计划评审(通过或列出缺口)→ /work 以原生角色子智能体逐波构建 → /review 独立实现评审并裁决 SHIP / FIX-FIRST / BLOCKED。genie context --wish <slug> 输出一行版本化 JSON(分支 + 基线 SHA + 待办任务)供生成子智能体时消费;genie board 实时派生看板;genie task 读写单个 SQLite 文件驱动任务状态。仓库的 git common 目录被多个 worktree 共享,因此所有链接 worktree 看到同一个 genie.db。genie omni 通过 Omni 中心与 NATS 连接 WhatsApp,实现远程审批(回复 y/n 或 emoji 反应)和入站一次性任务。genie setup --orchestration-mode orca 可把生命周期权威切换给 Orca(需 Orca 1.4.192+),切换回 standalone 同样显式执行。

  1. 在 Claude Code 或 Codex 中工作的开发者,想把一句模糊需求变成经过评审、可并行执行并最终产出可合并代码的流程
  2. 维护多 worktree 仓库的团队,需要所有 worktree 共享同一份任务状态而无需手动同步
  3. 希望代码由独立于编写者的审查智能体按验收标准裁决(而非作者自审)的工程负责人
  4. 想从手机远程批准智能体操作或下达简短任务的用户,可通过 genie omni 的 WhatsApp 桥完成
  5. 已采用 Orca 编排平台、希望由 Orca 统一接管任务/看板/路线图生命周期的团队

这个 Agent 有哪些优点和局限?

优点
  • 轻量无负担:无守护进程、无 Postgres,单仓库一个 SQLite 文件,命令运行一次事务即退出,约 0.9 MB 单文件打包、仅 4 个运行时依赖
  • 审查独立性是硬性设计:审查智能体与编写智能体分离(reviewer ≠ engineer),裁决基于 WISH 验收标准而非作者自评
  • 供应链安全完备:每次发布均 cosign 无密钥签名并附 SLSA 证明,安装前自动验证;卸载只删除可证明归属 Genie 的文件,被修改的文件保留并报告
  • 多智能体技能分发:同一套运行时中立的技能同时落到 Claude Code、Codex、Goose、Windsurf 的技能目录,覆盖的智能体共享同一生命周期
  • 多 worktree 天然共享状态:genie.db 从 git common 目录解析,一个 worktree 创建的任务立即可见于其他 worktree
局限
  • 依赖宿主智能体运行时:技能需要 Claude Code、Codex、Goose 或 Windsurf 的技能目录才能生效,Genie 本身不提供模型调用层
  • v4 到 v5 是破坏性切换:Postgres 后端、面板编排、执行器注册表、全屏控制台与桌面应用全部移除,v5 明确不支持这些能力
  • 遗留 MCP 与 UI 桥已退役:genie mcp 和 genie ui-bridge 只返回非零诊断错误,依赖这些旧集成的工作流必须迁移或回滚到 pre-A7 版本
  • Orca 模式是单向权威:切换后 Genie 不再读写本地 genie.db,且无本地回退——Orca 不可用时操作直接失败而非静默降级
  • 技能渠道与发布可能不同步:npx skills add 走仓库默认分支,可能超前或落后于任何已签名发布

如何安装或部署这个 Agent?

一键安装:curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash。安装器会在运行前通过 gh attestation verify(回退 cosign verify-blob)校验 cosign 签名的二进制。随后运行 genie install 收敛技能渠道(--integrations auto|codex|claude|all|none 控制写入哪些智能体技能目录),也可手动执行 npx skills add automagik-dev/genie(加 -g --all 写入所有智能体目录)。在已初始化的可信仓库内运行 genie init 建立状态结构,再用 genie doctor 确认安装完整。需要 Bun 运行时与 git。

如何使用这个 Agent?

在仓库内按生命周期调用技能:/brainstorm(或 "brainstorm this")→ /wish → /review → /work → /review。Claude Code 中以斜杠命令调用,Codex 等其他智能体按名称或自然语言调用。任意时刻运行 genie board 查看看板快照,genie task 检查或推进任务状态,genie context --wish <slug> 获取生成子智能体所需的分支与基线信息。WhatsApp 桥需先在 Omni 中心连接 WhatsApp 实例,运行一次 genie omni handshake 注册 ed25519 密钥,再以 genie omni serve 作为常驻进程。安装或更新后运行 genie doctor;更新用 genie update,回滚用 genie update --rollback。

这个 Agent 与同类方案有什么区别?

README 将 v4(保留于 v4 分支)作为对照:v4 使用 Postgres 后端、面板式进程编排与桌面应用,v5 刻意裁剪为技能 + git 文档 + 单个 SQLite 文件。另一个被点名的替代界面是 Orca:standalone 模式与 Orca 模式二选一,Orca 模式下 Orca 成为唯一生命周期权威。

常见问题

我必须使用 Claude 吗?
不必。技能按运行时中立契约编写,会安装到 Claude Code、Codex、Goose、Windsurf 等所有已检测到的智能体技能目录;--integrations 选项控制安装范围,除 none 外会写入每个检测到的技能目录。
它在我机器上常驻什么进程?
默认无常驻进程:每个命令打开 SQLite、执行一次事务后退出。唯一例外是 genie omni serve,它是 WhatsApp 桥的常驻进程,也是唯一的 NATS 客户端。
会覆盖我已有的智能体配置吗?
技能安装前会备份其他工具已拥有的同名技能目录并报告备份位置;genie uninstall 只删除内容摘要仍匹配记录的 Genie 目录,被修改或不明的文件一律保留。
更新失败会破坏现有安装吗?
不会。genie update --rollback 检查保留的回滚状态;失败的更新、回滚或模式预检都会保持原有配置与权威不变,技能安装失败也绝不回滚已晋升的二进制,而是打印补救命令并返回非零退出码。
启动 Orca 集成有什么要求?
需要 Orca 1.4.192 或更新版本且支持 orchestration.contract.v1。genie setup --orchestration-mode orca 会先验证插件载荷与运行时兼容性,成功后才备份配置并原子切换;插件本身需另行在 Orca 侧通过 orca-plugin ref 安装。

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents