automagik-dev/genie

解决的问题

Genie 提供了一种结构化的代理式软件开发工作流程，确保 AI 代理不仅是编写代码，而是遵循严谨的头脑风暴、规划与独立审查流程。它通过要求每个关卡（审查）必须由未参与该工作的代理执行，来防止进度“幻觉”，并将所有设计与计划作为版本控制的 markdown 文件保留在仓库中，以维持长期上下文。

运作方式

Genie 作为一组技能与已保存的工作流程运作，并与 AI 代码代理（如 Claude Code 或 Codex）整合。它使用特定的循环来处理任务：

• 头脑风暴 (Brainstorming)：想法会定案于 DESIGN.md 文件中。
• 许愿 (Wishing)：单一任务通过 /wish 指令处理，该指令会在独立的工作树 (worktree) 中建立变更、执行仓库自身的检查，并开启一个 pull request。
• 执行 (Working)：较大的任务会被拆解为 WISH.md 文件中的执行群组，并由受限的 worker 依依赖顺序执行。
• 审查 (Reviewing)：每个阶段都由独立的审查代理把关，该代理必须在工作继续前给出裁决（例如：SHIP, FIX-FIRST）。

任务状态会追踪于本地 SQLite 数据库 (.genie/genie.db) 中，并可通过 CLI 以看板形式检视。

适用对象

使用 AI 代码代理并希望拥有专业软件工程流程（包括设计审查、独立验证与基于 git 的上下文）的开发者，而非仅仅是原始代码生成。

特色亮点

• 独立审查关卡：确保由独立的代理执行审查，避免自我批准。
• 基于 Git 的上下文：设计与计划以 markdown 形式存储于仓库中，使其成为任何代理的真理来源。
• 工作树隔离：任务在各自的工作树中建立与测试，避免污染本地环境。
• 整合技能目录：随附 18 种专业技能（例如 research, docs-audit, council）与 12 种已保存的工作流程。
• 代理无关性：适用于不同的代理工具，如 Claude Code 与 Codex。