fr-goal
一个操作员接触点,从目标到经过审查的 PR:头脑风暴上下文 → 一次批量问答 → 规约 → 审查 → fr-plan → 审查 → TDD 实现 → 审查 → 单一 PR。每个审查修复它发现的所有问题;操作员的自主指令将每个超能力批准暂停替换为审查-修复循环。当被阻塞时:停止,说明什么被阻塞以及你尝试了什么,然后询问 —— 一个错误的猜测被合入 PR 的成本比一次暂停运行更高。
在开始时声明:“我正在使用 fr-goal 自主运行这个目标。”
保持交互的部分
| 时刻 | 原因 |
|---|---|
| 批量问答(一次,在头脑风暴阶段) | 设计决策归操作员所有 —— 未回答 = 停止,绝不使用默认值 |
| 多项目仓库位置 | 访问问题 —— 仅当文件系统无法回答时 |
| 手动物理阶段 | 秘密、UI 操作、部署只能由人类完成 —— 参见放置策略 |
| PR 合并 | 代理从不自我合并 |
| 合并后测试计划 | 证明真实部署;需要操作员的环境 |
1. 头脑风暴与批量问答 —— 在隔离环境中
调用 fr-brainstorming(首先运行 fr isolation up;没有开发容器配置 → 暂停以进行 fr-init 访谈)。隔离优先于一切 —— 包括探索、测量、集群操作;操作员“从 X 开始”改变第一个工作项,但绝不改变第一个操作。探索,收集每个操作员拥有的决策,在一次 AskUserQuestion 调用中询问所有问题(最多 4 个问题,推荐排在第一)。仅当交付物需要部署(服务/机器人/基础设施)时才包含合并后测试计划问题,纯代码绝不包含。批量处理滞后者。**硬性门控:**未回答的调用是停止信号 —— 结束当前回合,重申未解决的问题并等待;绝不用默认值替代真实答案。
2. 规约 —— 然后审查它
编写 docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md,然后对照问答答案和代码库现实(它命名的文件/助手/服务是否存在?)审查它。修复每个发现。测试计划选定后 → 规约包含一个包含合并后步骤的 ## Test Plan。
3. 多项目检查
对于跨仓库规约(owner/repo:path 形式),本次会话拥有一个仓库的计划和 PR。对于每个其他仓库:自行定位其工作副本(同级目录、常用根目录);仅当未找到时才询问路径/克隆 —— 批量纳入问答。为每个仓库分派一个代理(isolation: "worktree"),附带规约引用和从第 4 步开始的管道。每个仓库一个计划,一个 PR。
4. 计划 —— fr-plan,然后审查它
调用 fr-plan,跳过逐节批准(规约已编码设计)。保持 v2 计划-即-文件夹、TDD 形状的步骤。审查:fr plan self-review 必须通过,并且阶段需对照规约回读(全部覆盖)。修复,实施。
5. 手动物理阶段 —— 默认后置
fr-plan 的代理纯度门控将手工工作收集到专用的 [manual] 阶段中。fr-goal 添加放置策略(中期的手动物理阶段会阻塞运行):
- **默认后置:**所有手工工作在最后一个阶段,没有代理阶段依赖它。PR 刻意未实现地送达,标记给操作员,操作员实现并推送到同一个 PR(
fr plan edit --complete-phase N --note)。 - **仅当代理工作确实依赖它时才前置。**完成计划 + 审查,打开一个包含规约 + 计划的 PR(手工指令本身就是交付物),暂停;仅在操作员发出继续指令时恢复。
- **多仓库:**建模跨仓库依赖 ——
depends_on仅限计划内,因此排序存在于规约和 PR 顺序中(一个仓库的秘密可能门控另一个仓库的阶段)。
6. 实现 —— fr-execute 本地模式,TDD,无子代理
第 1 步的隔离工作空间就是工作副本 —— 每个命令通过 fr isolation exec 执行。通过 fr-execute 在 LOCAL 模式下(计划目录 + 阶段)运行阶段,而不是分派模式(规约/计划不在 main 上,fr apply --yes 拒绝)。内联实现,而不是通过子代理(上下文需要问答 + 规约历史)。逐步 TDD;通过 fr plan edit 勾选步骤 / 完成阶段。绝不处理手动物理阶段。
实现层仅推送分支 —— 绝不打开 PR(内联,或委托的多仓库构建器)。在这里打开它会将交付(8)重新排序到审查(7)之前,让操作员在修复存在之前合并 —— 它们成为孤立状态合入已合并分支(#320,3 倍)。编排器打开一个草稿 PR 以便可见 —— 不可合并直到步骤 8,其“草稿”徽章意味着“尚不合并”。
7. 在里程碑处审查 —— 修复所有发现
在每个里程碑(已完成的阶段,或小型计划的完整实现)之后,调用 superpowers:requesting-code-review 审查规约 + 计划 + 代码。立即修复每个发现,附带测试;一个事实上错误的发现需要反驳理由(superpowers:receiving-code-review),绝不静默丢弃。保留发现列表。
8. 交付 —— 每个仓库一个 PR,所有工件都包含在内
首先验证(superpowers:verification-before-completion):完整测试套件输出,自我审查通过,步骤已勾选。PR 现在才可合并(在第 7 步的修复之后):在草稿上执行 gh pr ready —— 在此之前绝不说“ready to merge”。PR 正文:摘要 + 规约/计划路径;审查发现及其修复(以及任何被反驳的发现);后置的手动物理阶段标记为“未实现 —— 操作员推送到此 PR”;合并后测试计划原样,标记为“合并后 —— 操作员驱动”。停止;操作员合并。
9. 合并后收尾
当操作员报告合并时:首先验证修复已到达 main —— 运行 fr isolation verify-merge --branch <b>(squash/rebase/merge 安全;exit 1 = 未验证)。未验证 → 停止并恢复(cherry-pick / 新 PR)。然后推动合并后测试计划(如果存在,代理运行检查,操作员确认其无法触及的内容),确认阶段完成(fr status),fr archive <plan-dir>,通过维护 PR 提交,fr isolation down。