| name | goal-loop |
| description | Goal-Loop methodology for multi-step agent work: strategy exploration, GOAL/GOALS/REPORT files, sub-goal state machine, iteration budgets, rollback, and decision logs. Use when the user asks for Goal-Loop, Goal Kit, GOAL.md, GOALS.md, REPORT.md, .hermes planning, multi-phase delivery with checkpoints, or structured goal decomposition before execution. |
Goal-Loop 方法论（改进版）
基于 Vincent Logic 原版 + Chris Hayduk 实践经验 + Goal Kit 状态机优化。
改进要点： 策略探索层 · 实验/决策日志 · 回溯机制 · 迭代预算 · 子目标状态表 · 变更版本管理（Changelog）
Announce at start: "I'm using the goal-loop skill to set up GOAL/GOALS/REPORT."
Default output directory: .hermes/ (override if user specifies another path)
Related skills:
brainstorming — before Goal-Loop when requirements are fuzzywriting-plans — after GOALS confirmed, for code-level implementation plansexecuting-plans / subagent-driven-development — during execution phaseverification-before-completion — before marking sub-goals complete
When to Use
Use Goal-Loop when all apply:
- Task spans multiple sessions or sub-agents
- Success criteria must be verifiable (tests, metrics, artifacts)
- User wants explicit scope boundaries (allowed / forbidden)
- Risk of wrong approach → need strategy comparison before coding
Do NOT use for single-file fixes, one-shot questions, or tasks with no acceptance criteria.
State Machine (子目标)
| 状态 | 含义 | 允许动作 |
|---|
未开始 | 尚未开工 | 排期、依赖检查 |
进行中 | 当前迭代 | 实现、实验、更新 REPORT |
阻塞 | 外部依赖或未决决策 | 记录阻塞，停止该子目标，等用户确认 |
已完成 | 完成标准已验证 | 只读；变更需 Changelog + 用户确认 |
需回溯 | 触发回溯条件 | 报告影响范围，暂停执行，修订 GOALS/GOAL |
Transitions:
未开始 → 进行中：开始该子目标当前迭代进行中 → 已完成：完成标准 全部 可验证通过进行中 → 阻塞：缺信息 / 环境 / 权限进行中 → 需回溯：命中该子目标或全局「回溯条件」需回溯 → 进行中：用户确认修订后的 GOALS/GOAL
Mandatory Workflow (5 phases)
Phase 1 — 对齐总目标
向用户确认（缺项则 AskQuestion）：
- 最终要完成什么（一句话）
- 交付物清单
- 完成标准（可验证）
- 允许修改范围 / 禁止事项
- 验收方式
Do not write files until Phase 1 answers exist.
Phase 2 — 生成 GOAL.md
- 探索 2–3 种候选策略（S1/S2/S3），每项含：概述 · 优势 · 劣势
- 选定策略 + 理由
- 写入
GOAL.md（模板见 templates.md）
- 用户确认 GOAL.md 后再进入 Phase 3
Phase 3 — 拆解 GOALS.md
- 按选定策略拆分子目标 G1, G2, …（执行顺序 + 依赖）
- 每个子目标必须含：回溯条件 · 迭代/资源预算
- 标注可并行子目标
- 写入
GOALS.md
- 用户确认 GOALS.md 后再进入 Phase 4
Phase 4 — 生成 REPORT.md 模板
- 初始化子目标状态总览（全部
未开始，进度 0%，迭代 0）
- 空：已完成 / 阻塞 / 风险 / 决策实验 / 下一步 / 待确认
- 用户确认三文件齐全 后开始执行（Phase 5）
Phase 5 — 执行循环
每轮结束 必须 更新 REPORT.md：
- 更新子目标状态表（状态 · 进度 · 迭代次数 · 备注）
- 追加「已完成事项」（日期 + 产出路径）
- 更新「当前进度」一段话
- 记录「决策与实验」（防重复踩坑）
- 更新「下一步计划」
During execution:
| 事件 | 动作 |
|---|
| 子目标迭代 +1 | 更新状态表迭代次数；检查是否超预算 |
| 迭代超限 | 停止该子目标，REPORT 阻塞节报告，等用户确认 |
| 触发回溯条件 | 状态 → 需回溯，说明影响 G?，暂停直到用户确认修订 |
| 完成标准满足 | 状态 → 已完成，附验证证据（命令输出 / 文件路径） |
| GOAL/GOALS 变更 | 写 Changelog（日期 · 内容 · 原因），用户确认后生效 |
File Templates
Use verbatim structure from templates.md — do not omit sections.
Quick paths:
| 文件 | 路径 |
|---|
| 总目标 | .hermes/GOAL.md |
| 子目标 | .hermes/GOALS.md |
| 进度 | .hermes/REPORT.md |
REPORT Update Checklist (每轮)
- [ ] 子目标状态总览已更新
- [ ] 本轮完成事项已追加（含日期）
- [ ] 决策/实验记录已追加（如有）
- [ ] 阻塞/风险已更新
- [ ] 下一步计划明确且可执行
- [ ] 待确认问题列出建议选项
- [ ] Changelog 已更新（如有 GOAL/GOALS 变更）
Integration with Code Work
| Goal-Loop 阶段 | 代码库动作 |
|---|
| GOAL 策略 S? 选定 | 决定并行 vs 串行、测试优先 vs 功能优先 |
| G? 执行中 | 对应 writing-plans 或 scoped tasks |
| 完成标准含 CI | 运行 ci:check 等，证据写入 REPORT |
| 验收 | GOAL「验收方式」中的命令 + git push 等 |
Anti-Patterns
- ❌ 跳过策略探索直接写 GOALS
- ❌ 未确认 GOAL/GOALS 就开始改代码
- ❌ 超迭代预算仍 silent continue
- ❌ 标记「已完成」无验证证据
- ❌ 改 GOAL/GOALS 不写 Changelog
- ❌ REPORT 只更新勾选不更新状态表
Example
见 examples.md（Ontology 覆盖率冲刺 .hermes/ 实例）。
