Genie
一句愿望，产出可合并的 PR：先访谈成计划，再并行派发智能体，审查通过后才交给你。
- Star 数
- ★ 345
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 67/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在 Claude Code 或 Codex 中工作的开发者，想把一句模糊需求变成经过评审、可并行执行并最终产出可合并代码的流程
- 不适合
- 仍在使用 v4 的 Postgres 后端、面板编排或桌面应用的用户：v5 是破坏性切换，这些能力已全部移除
- 依赖旧版 MCP 或 UI bridge 工作流的团队：genie mcp 与 genie ui-bridge 只返回非零退役诊断
- 源码审查
- 67/100 · 存在缺口
这个 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 同样显式执行。
- 在 Claude Code 或 Codex 中工作的开发者，想把一句模糊需求变成经过评审、可并行执行并最终产出可合并代码的流程
- 维护多 worktree 仓库的团队，需要所有 worktree 共享同一份任务状态而无需手动同步
- 希望代码由独立于编写者的审查智能体按验收标准裁决（而非作者自审）的工程负责人
- 想从手机远程批准智能体操作或下达简短任务的用户，可通过 genie omni 的 WhatsApp 桥完成
- 已采用 Orca 编排平台、希望由 Orca 统一接管任务/看板/路线图生命周期的团队
如何安装或部署这个 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 有哪些优点和局限？
- 轻量无负担：无守护进程、无 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 与同类方案有什么区别？
README 将 v4（保留于 v4 分支）作为对照：v4 使用 Postgres 后端、面板式进程编排与桌面应用，v5 刻意裁剪为技能 + git 文档 + 单个 SQLite 文件。另一个被点名的替代界面是 Orca：standalone 模式与 Orca 模式二选一，Orca 模式下 Orca 成为唯一生命周期权威。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Genie 当前 | 67 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 345 | 1 天前 | TypeScript | Codex · Claude Code |
| Freebuff – 免费AI编码与研究平台 | 20 · 缺口较多 | 命令行工具免费 | ★ 14k | 今天 | TypeScript | — |
| MCO | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 540 | 17 天前 | Python | Codex · Claude Code |
| InPlan 交互式规划编辑器 | 81 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 24 | 2 个月前 | TypeScript | Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示最小权限设计较扎实：工作流使用精确 SHA 固定 action 并声明最小 permissions；NATS 仅在 omni serve 路径动态加载并有白盒测试佐证；删除操作要求'可证明归属'。扣分点：这些多为文档声明，未提供核心 src 代码佐证实际权限边界；WhatsApp 桥与 ed25519 密钥注册涉及主机侧敏感操作，文档深度有限。
自洽性总体良好（README、SECURITY、package.、测试相互印证），冻结锁文件与固定 Bun 版本支撑依赖可用性；失败消息有稳定诊断文本并有测试断言。扣分点：README 中出现 2026 年的日期与版本号，静态审查无法证实其真实性，且 npm 分发已废弃造成历史版本引用混乱。
面向明确的开发者受众，平台矩阵覆盖 linux/darwin 并明确排除 darwin-x64；技能以运行时中立形式投递多 agent。扣分点：能力边界与触发精度主要靠文字描述，未见技能本体的触发约束文件；Orca 依赖特定最低版本，兼容性由运行时探测而非静态保证。
信息架构出色：命令表、技能表、生命周期清晰；安装说明详尽（installer、验证脚本、渠道清单）。许可证为完整 MIT。扣分点：未见 CHANGELOG 文件，版本历史依赖渠道清单描述；示例以命令表为主，缺少端到端示例与 FAQ；维护责任有联系渠道与 SLA，但发布者身份未经独立注册处核验。
输出可用性有设计（版本化 JSON、doctor 诊断行、board 视图）；相对自建编排栈有边际价值（文档进 git + 单 SQLite 文件，零常驻进程）。扣分点：实际产出质量（PR 可合并性）依赖未提供的执行证据；学习成本不低（多模式、渠道、遗留迁移）。
声明可追溯性较好：验证脚本、固定身份三元组、多渠道交叉核对均有具体路径与退出码；测试文件与 README 声明互证（MCP 退役诊断、action 固定匹配器）。扣分点：大量关键声明（签名发布、供应链事件、CanisterWorm 补救）无法在静态审查中独立证实，事实与营销表述在 README 中偶有混排，2026 时间线存疑。
- README 与 SECURITY.md 中出现 2026 年日期、版本号及一次供应链入侵事件描述；静态审查无法证实其真实性，使用前请通过仓库 Git 历史与外部渠道独立核实。
- 安装脚本采用 curl | bash 模式；虽然文档声称安装器会验证 cosign/SLSA 签名，请在执行前阅读 install.sh 本体并离线核验固定身份。
- 技能会写入多个 agent 全局技能目录（~/.claude/skills 等），并可能备份覆盖他方目录；升级前检查备份与 digest 记录。
- Omni WhatsApp 桥涉及密钥注册与远程审批通道；默认关闭，但启用前应评估消息面风险， unmapped 聊天仅存储不回复这一点需自行确认。
- npm 分发已废弃且历史 4.x 版本被声明为受损；切勿从 npm 安装，仅使用仓库清单指定的渠道。
- 本评分为静态审查（置信度低），未执行任何测试；无运行时验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v6.261024.1 预发布
发布说明摘录
Release v6.261024.1 (channel: dev) <!-- genie-agent-sync-migration-v1 --> One-time integration convergence: when upgrading from a Genie release older than 5.260711.6 to 5.260711.6 or later, let the first command finish and run genie update once more explicitly. The newly installed binary preserves user-owned skills/agents and converges the plugin, hooks, and optional role agents. Confirm exactly H3/H4/H6, review changed hashes with /hooks, and start a new Codex task; SessionStart never performs this hop.在 GitHub 查看 ↗ -
发布说明摘录
Release v6.261015.3 (channel: stable) <!-- genie-agent-sync-migration-v1 --> One-time integration convergence: when upgrading from a Genie release older than 5.260711.6 to 5.260711.6 or later, let the first command finish and run genie update once more explicitly. The newly installed binary preserves user-owned skills/agents and converges the plugin, hooks, and optional role agents. Confirm exactly H3/H4/H6, review changed hashes with /hooks, and start a new Codex task; SessionStart never performs this hop.在 GitHub 查看 ↗