跳转到主要内容
Comet 的可靠性来自一组 shell scripts。它们把 workflow control 从 AI prompt text 中移出，放进可测试、可复用的工具中。这些 scripts 可在 macOS、Linux 和 Windows（Git Bash）上运行。

​
Scripts 列表

Script用途
comet-env.shScript discovery helper：导出 bundled script paths（COMET_GUARD、COMET_STATE、COMET_HANDOFF、COMET_ARCHIVE、COMET_YAML_VALIDATE）
comet-guard.shPhase transition guard：验证 exit conditions，--apply 自动更新 .comet.yaml
comet-handoff.shDesign handoff：从 OpenSpec artifacts 生成带 SHA256 tracing 的 deterministic context packages
comet-archive.shOne-command archive：验证 state、同步 specs、移动到 archive、更新 status
comet-yaml-validate.shSchema validator：验证 .comet.yaml structure 和 field values
comet-state.shUnified state management：init/set/get/check/scale

​
在 Session 中加载 Scripts

始终通过 comet-env.sh 定位 scripts，不要硬编码 paths。Script locations 会因平台、install scope 和 OS 而异。在 session 开始时 source 一次 comet-env.sh，会把所有 script paths 导出为 environment variables。 
COMET_ENV="${COMET_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" "$HOME/.gemini" -path '*/comet/scripts/comet-env.sh' -type f -print -quit 2>/dev/null)}"
if [ -z "$COMET_ENV" ]; then
  echo "ERROR: comet-env.sh not found. Ensure the comet skill is installed." >&2
  return 1
fi
. "$COMET_ENV"
source comet-env.sh 后，session 中会提供以下 environment variables：
Variable指向
$COMET_GUARDcomet-guard.sh
$COMET_STATEcomet-state.sh
$COMET_HANDOFFcomet-handoff.sh
$COMET_ARCHIVEcomet-archive.sh
$COMET_YAML_VALIDATEcomet-yaml-validate.sh
继续前，也应该验证所有 variables 都已填充： 
if [ -z "$COMET_GUARD" ] || [ -z "$COMET_STATE" ] || [ -z "$COMET_HANDOFF" ] || [ -z "$COMET_ARCHIVE" ]; then
  echo "ERROR: Comet scripts not found. Ensure the comet skill is installed." >&2
  echo "Expected path pattern: */comet/scripts/comet-*.sh under project or platform skill directories" >&2
  return 1
fi

​
跨平台说明

Comet 通过 COMET_BASH 解析可用的 bash executable。comet-env.sh 会在测试候选 executables 后自动导出该变量，包括 Windows 上的 Git Bash paths。Windows WSL launcher（System32/bash.exe）会被明确排除。 始终按以下方式调用 scripts： 
"$COMET_BASH" "$COMET_GUARD" <args>
"$COMET_BASH" "$COMET_STATE" <args>
使用 "$COMET_BASH" 而不是直接调用 scripts，可确保 Windows Git Bash 在所有支持平台上都被正确处理。

​
Script pages

comet-guard.sh

Phase transition guard：在推进 workflow 前验证 exit conditions

comet-state.sh

Unified state management：读取和写入 .comet.yaml 的唯一接口

comet-handoff.sh

Design context handoff：从 OpenSpec artifacts 生成带 SHA256 trace 的 context packages

comet-archive.sh

Automated archive：同步 delta specs、标注文档并关闭 change