Communitygithub.com

derio-net/super-fr

Claude Code 插件套件:超能力规划、开发容器 + 工作树隔离、从目标到 PR 的自主执行,以及面向 VibeKanban 运行器的阶段调度。

super-fr 是什么?

fr-goal 技能为 Claude Code 提供了一个从目标到 PR 的全自动化管道,最大化开发者自主性的同时减少切换成本。它通过隔离的工作空间(开发容器或工作树)启动,执行从头脑风暴、批量问答、设计规约编写、TDD 实现、多轮审查到最终单 PR 交付的完整流程。该技能支持跨仓库场景,能自动定位工作副本并分派独立代理;同时内置手动物理阶段后置策略,确保秘密、UI 操作和部署等人工环节不会阻塞自动化流程。技能强制每个审查回合修复所有发现的问题,并在遇到阻塞时停止运行并询问操作员,避免错误猜测被合入。

兼容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add derio-net/super-fr

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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。

相关技能