You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# 自动衔接下一阶段协议
规范路径:`comet/reference/auto-transition.md`
本协议由所有 comet 子 skill 共享,定义阶段守卫推进后的自动衔接规则。
## 术语区分
「阶段守卫推进」由 guard `--apply` 完成,更新 `.comet.yaml` 的 `phase` 字段——这一步**始终发生**,与 `auto_transition` 无关。本协议的「自动衔接」只决定**是否自动调用下一个 skill**,由 `auto_transition` 控制。
## 执行方式
退出条件满足且阶段守卫推进 phase 后,运行:
```bash
" $COMET_BASH " " $COMET_STATE " next <change-name>
```
脚本根据 `phase` 、`workflow`、`auto_transition` 输出确定性的下一步:
- `NEXT: auto` → 调用 `SKILL` 指向的 skill 进入下一阶段
- `NEXT: manual` → 不要调用下一 skill, 按 `HINT` 提示用户手动运行 `/<SKILL>`
- `NEXT: done` → 流程已完成,无需继续
## preset 路由
`workflow: hotfix` 时,`phase: build` 返回 `comet-hotfix` ; `workflow: tweak` 时返回 `comet-tweak` 。其余 phase( `verify`、`archive`)按标准 skill 名称返回(`comet-verify`、`comet-archive`),不受 workflow 类型影响。preset skill 内部的"连续执行模式"可能覆盖 `auto_transition` 行为——详见对应 preset 的 `<IMPORTANT>` 块。