robzilla1738/supergoal

解决的问题

Supergoal 消除了使用 AI 代码代理时所需的“保姆式”监督。用户不再需要为计划的每一个步骤向代理下达提示，Supergoal 会自动化整个生命周期：从深度规划、代码库侦察、自主执行到最终审计。它只需要两次人工交互：一次是批准计划，另一次是粘贴执行命令。

运作方式

Supergoal 主要在两个阶段运作：规划和执行。

1. 规划 (/supergoal)： 该工具对任务进行深度分析，包含检测环境（全新项目 vs. 现有项目）、扫描代码库、识别风险，并将工作分解为适应性数量的阶段。它将详细规格（ROADMAP、STATE 和特定阶段的文件）写入 .supergoal/ 下的命名空间目录，并对计划进行自我审查。验证通过后，它会向用户提供单个 /goal 命令。
2. 执行 (/goal)： 当用户粘贴命令后，代理会进入自主循环。它会从磁盘读取阶段规格、执行工作并验证结果。它包含一个“三次失败”自我修复机制：首先自动重试，然后尝试进行针对性的修复规格，最后如果仍然卡住，则交由人工处理。
3. 最终审计： 所有阶段完成后，该工具会根据原始的 ROADMAP 和初始基准提交来重新验证整个项目，确保所有交付项都存在且没有引入回归错误。

适用对象

使用 Claude Code 或 Codex CLI 的开发者，希望在不手动逐步提示的情况下，自动化复杂的多步骤功能构建或重构。

特色亮点

• 自主执行： 将人工操作减少到一次批准和一次粘贴。
• 深度规划： 包含代码库侦察、风险评估和适应性阶段分解。
• 自我修复： 内置三次失败恢复机制（自动重试 $\rightarrow$ 修复规格 $\rightarrow$ 人工接手）。
• 严格审计： 根据原始 ROADMAP 和工作树的基准参考进行最终验证。
• 记忆整合： 自动将特定项目的学习内容读写至记忆目录，以改善未来的执行。