vibe-continue

SKILL.md

/vibe-continue - Resume Current Flow

/vibe-continue 的目标是恢复当前目录承载的 flow 所对应任务的上下文,但恢复顺序必须是“共享事实优先,本地 handoff 补充”,而不是反过来。

核心原则:

  • 先读共享真源,再读 .agent/context/task.md
  • .agent/context/task.md 是 handoff,不是共享真源。
  • handoff 的维护义务以 docs/standards/handoff-governance-standard.md 为准;发现与现场不一致时必须修正。
  • 不在 continue 阶段发明不存在的 Shell 修复动作。

Announce at start: "我正在使用 /vibe-continue 技能来恢复当前 flow 的任务上下文。"

Truth Sources

以下语义以标准为准:

  • docs/standards/skill-standard.md
  • docs/standards/command-standard.md
  • docs/standards/shell-capability-design.md
  • docs/standards/git-workflow-standard.md
  • docs/standards/handoff-governance-standard.md
  • docs/standards/glossary.md

特别约束:

  • flow 不等于 worktreebranchworkflow。见 docs/standards/glossary.md
  • .agent/context/task.md 的读取、写入与修正义务以 docs/standards/handoff-governance-standard.md 为准。

Command Boundary

  • /vibe-continue 负责解释当前现场并给出继续建议。
  • Shell 命令只用于读取共享真源和当前现场的确定性事实。
  • git / gh 可用于补充 branch、dirty、PR 等现场事实。
  • 如果需要某个环境修正动作,必须使用仓库中真实存在且已文档化的入口;不要发明未验证的修复命令。

Restore Order

/vibe-continue 默认按以下顺序恢复:

  1. 当前 git 现场(git branch --show-currentgit status --short、必要时 gh pr view
  2. $(git rev-parse --git-common-dir)/vibe/registry.json
  3. $(git rev-parse --git-common-dir)/vibe/tasks/<task-id>/task.json
  4. $(git rev-parse --git-common-dir)/vibe/worktrees.json(如果存在,只作兼容期辅助线索)
  5. .agent/context/task.md(如果存在)

必要时再补充:

  • 当前 branch
  • git status --short
  • 当前 PR / review 事实

Workflow

Step 1: 识别当前目录承载的 flow 对应 task

优先从 git 现场、共享 registry.json 与 task detail 识别:

  • 当前 task
  • next_step
  • plan_path
  • 当前 runtime 绑定事实
  • primary_issue_ref(若存在,它就是 task issue 的显式落点)

worktrees.json 若存在,只能作为兼容期 hint,不能先于 registry.json 抢占当前 task 识别权。

如果共享真源中无法识别当前 task,不要把 task.md 直接抬升成替代真源;它只能作为本地 handoff 线索。

Step 2: 读取本地 handoff

如果 .agent/context/task.md 存在,则把它作为以下信息的补充来源:

  • 本轮已完成
  • 当前判断
  • blockers
  • 关键文件

若其内容与当前真源或现场不一致,必须在退出前修正 handoff,不能直接沿用旧判断。

如果它缺失,不阻断 continue;只说明当前缺少本地 handoff。

Step 3: 交叉核对当前现场

用确定性事实补全当前视图,例如:

  • 当前 branch
  • dirty / clean
  • 当前 PR 状态

continue 阶段可以报告不一致,但不要把查询命令说成“自动对齐”,也不要调用未验证的隐式修复动作。

Step 4: 给出继续建议

建议优先级如下:

  1. 如果 plan_path 存在,优先建议按计划继续。
  2. 如果只有 next_step,则建议按当前 task 的下一步继续。
  3. 如果只有本地 task.md handoff,则把它明确标注为本地补充线索,而不是共享事实。

Suggested Output

📋 Session Resume

📁 Current Scene
  • worktree: <worktree>
  • branch: <branch>
  • state: dirty|clean

📌 Current Task
  • task: <task-id>
  • next step: <next-step>
  • plan: <plan-path|none>

📝 Local Handoff
  • task.md: present|missing
  • blockers: <summary>

💡 Suggested Action
  • continue with <plan-path|next-step>

Design Decisions

  1. continue 先恢复共享事实,再读取本地 handoff。
  2. task.md 的作用是补充解释,不是代替真源。
  3. continue 报告现场差异,但不发明未验证的自动修复动作。
Weekly Installs
2
First Seen
3 days ago
Installed on
mcpjam2
claude-code2
replit2
junie2
windsurf2
zencoder2