comet-any

Comet Any - Skill Creator

/comet-any 是 Comet 的 Skill 创建向导。用户只需要描述想要的工作流；本 Skill 负责读取真实 Skill、提出方案、等待确认、生成可验证的 Comet-native Skill Bundle，并通过内部 CLI 完成 eval、review、publish readiness 和安装预览。

普通用户第一层只看到三种起点：

• 基于 /comet-classic 的五阶段定制：覆盖 open / design / build / verify / archive 五阶段的 Skill 编排，但不修改 /comet-classic 永久入口本身。
• 创建全新 workflow Skill：从目标和候选 Skills 生成新的 workflow-kernel。
• 整理已有 Skill：读取已有 Skill，补齐 Workflow Node、Skill Binding、Output Schema、Guardrail、Handoff、eval 和 readiness。

后端 Bundle、Factory、composition 仍是内部审计词；不要把它们作为普通用户的第一屏概念。

核心模型

所有路径都必须编译到同一种 Workflow Contract：

• Workflow Node：流程中的可恢复节点，例如 open、design、plan、execute、subagent-execute、review、verify、archive。
• Node Responsibility：该 Node 在 Agent workflow 中承担的职责，用来解释它为什么存在、需要产出什么、能否替换。
• Skill Binding：某个 Node 的实现 Skill 或辅助 Skill。
• Required Skill Call：要求 Node 内必须调用某个 Skill，不替换 Node implementation。例如 execute 和 subagent-execute 必须调用 elementui，review 必须调用 whitebox-code-standard。
• Output Schema：Node 必须产出的文件、状态或 evidence。Output Schema 必须挂到具体 Workflow Node 才算生效；只定义在 workflow.outputSchemas 里不会触发 guard、eval 或 readiness。脚本、eval、readiness 只依赖挂到 Node 的 Output Schema，不依赖 Skill 名称。
• Guardrail：阻断或放行 Node 推进的检查。
• Handoff：子代理或跨 Node 交接时必须带回的 evidence。
• workflow-protocol.json：生成包的唯一运行事实源，kind 为 comet-five-phase-overlay 或 workflow-kernel。

受保护边界

comet-five-phase-overlay 保留 Comet Classic 五阶段主流程和 .comet.yaml 状态语义。普通模式下：

• comet-five-phase-overlay 的主状态只来自 Classic layout resolver 绑定的 <classic-change-dir>/.comet.yaml；没有 active change 或多个 active changes 时必须阻塞并请用户选择。
• 不得创建 .comet/runs/<workflow>/state.json 作为 Comet overlay 主状态。Bundle 草稿、eval evidence 和 publish readiness 可以有自己的证据文件，但不能替代 .comet.yaml。
• control Node 不允许 override：open、execute、verify、archive。
• producer Node 可以 override：design、plan，但必须满足对应 Output Schema。
• handoff 和 guardrail Node 可以 require / augment。
• 用户坚持替换 control Node 时，改走高级 workflow-kernel，并要求重新声明 state、Output Schema 和 Guardrail。
• 所有 Node 都必须用 responsibility 说明职责，不使用内部坐标作为用户理解流程的方式。