Claude Code 运行 Genie 规划执行循环

要解决的问题

在 Claude Code 里说一句「给项目加上搜索功能」，得到的往往是立刻动手改代码。想法没澄清、验收标准没对齐、做到一半才发现方向错了，只能回滚重来。Genie 把「先想清楚再动手」这件事变成一套可追踪的循环，让模糊需求先被拆解，再逐步落地。

它是怎么工作的

这个技能的核心是一个四阶段循环，生命周期以 Claude Code skills 的形式运行：

• Brainstorm（头脑风暴）：先把模糊需求摊开，讨论实现路径和取舍；
• Wish（心愿）：把讨论结果固化成明确、可验收的目标；
• Work（执行）：按计划逐步改代码、跑验证；
• Review（评审）：对照目标检查结果，决定是进入下一轮还是收尾。

每一轮循环都有两个持久化支撑：

• Markdown 计划：Genie 在仓库内创建 .genie 文档，记录这一轮想做什么、怎么做；
• 本地 SQLite 状态文件：跟踪循环进度，让中断后能接着上次继续。

因为是循环而非一次性任务，每一轮的计划文件都留在仓库里，改错了可以直接回看当时的决策依据。

适用边界与注意点

• 需要环境里有 Claude Code、Genie CLI、git 和 Bun 驱动的 Genie 运行时，缺一个都跑不起来；
• 仓库必须允许写入 .genie 目录和本地 SQLite 状态文件，纯只读仓库不适用；
• 运行前先用诊断命令确认安装状态，避免循环中途因环境问题失败；
• 它适合可分解、有明确完成标准的编码任务，不是给所有需求套流程的银弹；
• 计划文件和状态库都存放在本地，多仓库并行时需要分别配置。