comet publish

comet publish 是普通用户发布 /comet-any 产物的入口。它负责 eval 证据就绪后的 review、approval、publish 和 distribute。创建、恢复和”下一步该做什么”由 comet creator 负责。预设的工作方式是：

/comet-any 创建、恢复和优化 Skill
comet eval 验证生成物
comet creator status / comet creator next 是普通用户查 readiness 和下一步要做什么的入口
comet publish 处理评审、人工批准、发布和分发

comet publish 是 comet bundle 后端的薄封装（thin facade）。每个 publish 子命令都委托给对应的 bundle 函数。普通用户用 publish，审计/排障时才直接用 bundle。

子命令

命令	用途	必需参数
`comet publish review <name>`	生成发布前评审摘要	`<name>`、`--platform`
`comet publish approve <name>`	批准当前 hash 的 candidate	`<name>`、`--reviewer`
`comet publish run <name>`	发布已批准 candidate	`<name>`、`--platform`
`comet publish distribute <name>`	分发已发布 candidate 到平台	`<name>`、`--platform`

所有子命令都支持 --json。

comet publish 没有 reject 子命令。approve 是用户唯一批准入口，内部会以固定结论 approved 记录本次评审。需要拒绝时用高级的 comet bundle review <name> —reject —reviewer <name>。

发布阶段按 review → approve → run → distribute 执行。状态机、readiness 结论与阻塞码的权威说明见发布和分发 Skill。

完整示例

# 查看完整 readiness 和阻塞项
comet creator status review-helper --project . --json

# 只想知道下一步该跑什么
comet creator next review-helper --project . --json

# 生成评审摘要
comet publish review review-helper --platform claude --json

# 人工批准
comet publish approve review-helper --reviewer alice --json

# 发布已批准 candidate
comet publish run review-helper --platform claude --json

# 分发预览（强制）
comet publish distribute review-helper --platform claude --scope project --preview --json

# 真实分发
comet publish distribute review-helper --platform claude --scope project --json

通用选项

选项	说明
`--project <dir>`	项目根目录（默认 `.`）
`--json`	输出结构化 JSON
`--platform <id>`	目标平台（可多次传）
`--scope <project\|global>`	分发范围
`--reviewer <name>`	评审人（`approve` 必需）
`--locale <locale>`	语言
`--overwrite`	覆盖已有发布候选（`run`）/ 已有分发（`distribute`）
`--preview`	分发预览
`--confirm-executables`	确认可执行披露
`--skip-capability <cap>`	跳过 optional 能力（可多次传）

只想知道下一步：comet creator next

comet creator status 给你完整的 readiness 结论和阻塞项。如果你只想知道现在该跑哪一条命令，用 comet creator next。它打印单个推荐下一步，不暴露任何后端 Bundle 命令：

comet creator next review-helper --project . --json

文本输出大致长这样：

Next step for review-helper
Status: draft
Current step: review
Action: request-review
Command: comet publish review review-helper --platform claude --json
Reason: Current draft hash is missing review approval
Requires confirmation: yes

--json 模式额外返回结构化字段：

字段	含义
`status` / `currentStep`	candidate 当前状态和所在阶段
`nextStep.action` / `nextStep.label`	推荐动作的类别和用户可读标签
`nextStep.command`	你应该直接跑的命令（已填好参数）
`nextStep.reason`	为什么推荐这一步
`nextStep.requiresUserConfirmation`	这一步是否需要你先确认（如批准、分发）
`preferenceDrift.changed`	项目 Skill 偏好在本次流程启动后是否发生了漂移

comet creator next 是给”被打断的 /comet-any 流程”恢复用的：它把后端 Bundle 的 next action 翻译成一条用户命令，所以你不需要去读内部状态。偏好漂移（preferenceDrift.changed）为真时，advisory 模式会警告，strict 模式默认阻塞。你需要决定是继续旧方案还是重新生成。

分发预览是强制的

执行真实分发前必须先跑 preview：

comet publish distribute review-helper --platform claude --scope project --preview --json

preview 会展示：

Install preview、planned files
unsupported capability
executable disclosures
No files were written

只有确认 preview 结果后，才可以移除 --preview 执行真实分发。

处理可执行披露和能力缺口

如果目标平台包含 hook 或脚本等可执行能力：

comet publish distribute review-helper --platform claude --scope project --confirm-executables --json

如果用户明确选择跳过 optional 能力：

comet publish distribute review-helper --platform claude --scope project --skip-capability <capability> --json

能力类型	缺口处理
required 能力缺口	取消该平台，不能跳过
optional 能力缺口	必须由用户显式选择 skip
Hook/脚本披露	必须由用户确认后才可分发

hooks/*.yaml 是 Comet portable hook descriptor，只在 comet publish distribute 编译到目标平台配置后生效。

下一步

发布和分发 Skill — readiness 状态链和门禁详解
comet creator — 创建状态、恢复和唯一的下一步
comet bundle — 高级 Bundle 后端
comet eval — 发布前证据入口

安装和健康检查

Skill、评估和发布（进阶）

核心脚本

子命令

完整示例

通用选项

只想知道下一步：comet creator next

分发预览是强制的

处理可执行披露和能力缺口

下一步

​子命令

​完整示例

​通用选项

​只想知道下一步：comet creator next

​分发预览是强制的

​处理可执行披露和能力缺口

​下一步

子命令

完整示例

通用选项

只想知道下一步：comet creator next

分发预览是强制的

处理可执行披露和能力缺口

下一步