comet creator

comet creator 是 /comet-any 的命令行配套入口。它专门处理三件事：恢复流程、读取发布就绪状态（readiness）、以及给出单一下一步命令。日常主线仍建议从 /comet-any 开始。只有在流程中断、需要排障，或要把某一步接入自动化时，再直接使用 comet creator。

它和 publish 的区别

命令	负责什么	什么时候用
`comet creator`	创建、恢复、候选解析、方案确认、生成和 authoring lane	`/comet-any` 流程还没进入发布，或你要查下一步
`comet publish`	review、approve、publish、distribute	eval 证据就绪后，准备发布和分发
`comet bundle`	高级后端	审计、排障、平台编译调试

推荐主线是：

/comet-any 创建 -> comet eval 验证 -> comet creator status/next -> comet publish（评审/批准/发布/分发）

发布阶段的命令细节见 comet publish；状态机、readiness 结论与阻塞码的权威说明见发布和分发 Skill。

子命令

命令	用途	必需参数
`comet creator list`	列出可恢复的 Skill Creator candidate	-
`comet creator status <name>`	查看 readiness、blocker、warning 和 evidence	`<name>`
`comet creator next <name>`	打印单个推荐下一步	`<name>`
`comet creator guide`	查看首次使用向导、偏好和可恢复流程摘要	-
`comet creator candidates`	发现可用于组合的 Skill 候选	-
`comet creator propose <name>`	预览 Skill Creator 方案，不写状态	`<name>`、`--file`
`comet creator init <name>`	用确认后的 plan 初始化或更新状态	`<name>`、`--file`
`comet creator resolve <name>`	解决缺失或歧义候选	`<name>`、`--candidate`
`comet creator authoring-plan <name>`	查看生成 Skill 的创作 lane 计划	`<name>`
`comet creator authoring-record <name>`	记录某个创作 lane 的输出	`<name>`、`--lane`、`--file`
`comet creator generate <name>`	从已确认 metadata 生成 Skill 包	`<name>`

所有子命令都支持 --project <dir> 和 --json。

常用恢复命令

# 列出可恢复流程
comet creator list --project . --json

# 查看完整状态、readiness 和证据
comet creator status review-helper --project . --json

# 只看下一步该做什么
comet creator next review-helper --project . --json

comet creator next 的文本输出会包含当前状态、所在阶段、推荐动作、推荐命令、原因，以及这一步是否需要用户确认。

Next step for review-helper
Status: draft
Current step: needs-eval
Action: Run repository eval for the generated Skill
Command: comet eval ./generated-skill/comet/eval.yaml --quick --html
Reason: Current draft hash is missing passing eval evidence
Requires confirmation: yes

方案和生成命令

这些命令默认由 /comet-any 在流程内自动调用。手工执行主要用于两类场景：一是自动化流水线需要显式控制步骤，二是你在排查候选解析或生成状态异常。

# 首次使用向导
comet creator guide --project . --json

# 发现候选 Skill
comet creator candidates --project . --json

# 预览组合方案，不写状态
comet creator propose review-helper --file ./plan.json --json

# 用户确认方案后写入状态
comet creator init review-helper --file ./plan.json --confirmed-proposal --json

# 解决歧义候选
comet creator resolve review-helper --candidate review-flow --source ./skills/review-flow --json

# 忽略缺失候选，需要写明原因
comet creator resolve review-helper --candidate optional-helper --ignore-missing --reason "not needed for this workflow" --json

# 生成 Skill 包
comet creator generate review-helper --json

不要绕过方案确认页直接生成。/comet-any 必须先展示 Skill Creator 方案确认页，等你确认后才写入 draft。

authoring lane 命令

生成的 Skill 不是薄模板。/comet-any 会用 authoring lane 写入口正文、节点指导、脚本契约、参考文件和评审证据。

# 查看 quick 或 full 创作计划
comet creator authoring-plan review-helper --depth quick --json
comet creator authoring-plan review-helper --depth full --json

# 记录某个 lane 的输出
comet creator authoring-record review-helper --lane skill-core --file ./lane-output.json --json

如果生成物里还保留 AUTHORING PENDING 标记，发布就绪检查会出现 [authoring] 阻塞项（blocker）。你需要完成对应 lane，并记录输出后再继续 eval 和发布。阻塞码的完整含义与恢复建议见发布和分发 Skill · 阻塞码。

下一步

快速上手：组合任意 Skill — 从 /comet-any 跑完整主线
创建 Skill 的完整流程 — 理解每个阶段
comet publish — eval 后的 review、approve、publish 和 distribute
发布和分发 Skill — 状态机、readiness 与阻塞码的权威说明
comet bundle — 高级后端参考

安装和健康检查

Skill、评估和发布（进阶）

核心脚本

它和 publish 的区别

子命令

常用恢复命令

方案和生成命令

authoring lane 命令

下一步

​它和 publish 的区别

​子命令

​常用恢复命令

​方案和生成命令

​authoring lane 命令

​下一步

它和 publish 的区别

子命令

常用恢复命令

方案和生成命令

authoring lane 命令

下一步