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.
buffer_platform/.trae/skills/comet/reference/auto-transition.md

28 lines
1.3 KiB

# 自动衔接下一阶段协议
规范路径:`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>` 块。