Skip to main content
comet guard 是稳定的阶段检查命令。它会检查当前 phase 需要的文件、字段和验证证据。

​
基本形式

不带 --apply 时只检查。带 --apply 时，检查通过后会委托状态脚本推进 phase。

​
常见检查

  • open: proposal、design、tasks 和 delta spec 是否完整。
  • design: Design Doc 是否存在。
  • build: build_mode、isolation、tdd_mode、review_mode 等是否满足约束，并运行自动探测到的项目构建检查。
  • verify: 验证报告和验证结果是否可用。
  • archive: 是否已通过验证并完成最终确认。

​
构建检查

build 阶段不再读取 build_command 或 verify_command 配置字段。guard 会根据项目文件自动探测构建方式，例如 package.json 中的 npm run build、Maven 或 Cargo。 如果 change 的 .comet.yaml 里仍然保留 build_command / verify_command，guard 会把它们当作未知字段拒绝。需要固定团队级验证命令时，建议放在项目自己的脚本体系里。无法自动推断入口时，真实运行命令后使用 comet state record-check 记录证据；guard 会验证记录，而不是要求跳过检查。
guard 失败时不要硬改状态绕过。先修复缺失证据或回到对应阶段。
安装包仍包含 comet-guard.mjs 兼容 launcher，但普通使用和 Agent 指令应优先采用 comet guard。
最后修改于 2026年7月12日