Skip to main content
在 Agent 中调用 /comet-any 开始创建。流程会提示需要确认的方案、评估、发布和分发步骤。
/comet-any(Skill Creator)用于创建、优化和组合可复用 Skill。本页按使用顺序说明从目标描述到分发的操作。
组合任意 Skill 仍是实验性功能。后续版本可能对流程、命令接口、生成物结构和发布门禁做大幅重构,也可能移除或替换部分能力。建议先在非关键项目中试用,并在升级 Comet 前查看 changelog。

适用场景

  • 将团队重复执行的流程整理为可复用 Skill。
  • 在 Classic 五阶段基础上增加、替换或关闭环节。
  • 为已有 Skill 补充评估、发布和分发产物。

你需要先准备什么

  1. 已安装 Comet。运行 comet doctor 确认 CLI 正常。如果还没装,见 安装与更新。
  2. 一个支持 Skill 的 Agent 平台,例如 Claude Code、Codex、Cursor 等。/comet-any 是在这些平台里调用的 Skill,不是独立的终端命令。
  3. (可选) 项目级偏好文件。第一次使用时 /comet-any 会自动扫描平台并推荐默认偏好,你可以跳过这步。想提前配置,见可选:准备偏好文件。
/comet-any 是 用户唯一需要记住的入口。需要看恢复状态时用 comet creator。进入发布后再用 comet publish。日常使用不需要直接跑 comet bundle。

创建主线

调用 /comet-any 开始。流程中断后,运行 comet creator next <name> 查看建议动作。运行 comet creator status <name> 查看 readiness、blocker 和证据。

小鱼沿着 /comet-any、eval 证据、creator next/status 和 publish/distribute 路线推进 Skill 卡片

/comet-any 负责创建 Skill,comet eval 给证据,comet creator next/status 把中断流程翻译成下一条用户命令


第一步:调用 /comet-any 并描述目标

在 Agent 平台里输入:
然后描述你想创建的 Skill。描述越具体,生成的 Skill 质量越高。一个好的描述至少包含:做什么、分几步、给谁复用。例如:

第二步:选择起点

/comet-any 会让你从三种起点里选一个。这是 Skill Creator 的第一层选择,决定了整个生成方式: 不管选哪种起点,/comet-any 最终都会把目标编译成同一种 Workflow Contract(由 Workflow Node、Skill Binding、Required Skill Call、Output Schema、Guardrail、Handoff 组成)。详见Skill Creator 概览。
选择基于 Comet 现有 Skill 的五阶段定制时,/comet 被视为受保护边界:control 节点(open/execute/verify/archive)不能被替换实现,你只能对节点增加 Required Skill Call、增强(augment)、关闭(仅可选节点)。

第三步:确认组合方案(Skill Creator 确认页)

/comet-any 会读取项目里的真实 Skill,把目标编译成 Workflow Contract,生成一个组合方案,然后暂停等你确认。这一页叫”Skill Creator 方案确认页”,是整个流程的关键检查点。它会展示:
  • 你在做什么类型的 Skill(Skill Creator 意图)、目标是什么
  • 保留哪些节点、新增哪些 Required Skill Call、替换哪些节点实现、关闭哪些可选节点
  • 不能做什么(例如替换 control 节点会被拒绝)
  • 每个节点的职责、实现 Skill、必须调用的 Skill、Output Schema
  • Workflow Contract 类型(comet-five-phase-overlay / workflow-kernel)和 Output Schemas 列表
  • 是否有缺失或歧义候选需要你处理
  • scripts / hooks 会带来什么可执行披露
  • 将生成哪些文件
你需要做三选一:
  1. 确认生成 — 按方案写入 draft,继续生成。
  2. 修改方案 — 调整目标、偏好或候选后重新生成方案。
  3. 取消 — 不写任何状态。
候选缺失或存在多个来源时,/comet-any 会暂停并请求选择,不会自动忽略或决定来源。

第四步:评估

确认后,/comet-any 生成 Skill 包。发布前必须生成与当前草稿 hash 匹配的评估证据:
打开 CLI 打印的 Report path,确认评估通过。详细的环境准备和报告解读见评估任意 Skill。
前提:运行 comet eval 需要本机有 uv、Python 3.11+、Docker,并设置了 ANTHROPIC_API_KEY(或 ANTHROPIC_AUTH_TOKEN)。完整的准备工作见评估快速上手 · 你要准备什么。

第五步:发布和分发

评估通过后,检查发布 readiness 并发布:
分发到平台前会先强制跑预览,确认后才会真正写入:
完整的发布状态链和门禁见发布和分发 Skill。
/comet-any 也会主动推进这些步骤并在每一步询问你确认。上面这些命令是可选的手工路径,用于排障或自动化。

完整流程一图看懂

可选:准备偏好文件

第一次使用时 /comet-any 会扫描平台 Skill 并推荐默认偏好,你也可以直接创建偏好文件,告诉它优先复用哪些 Skill。保存到 .comet/skill-preferences.yaml:
完整字段含义见Skill 偏好与真实来源。

常见问题

/comet 用来完成一个项目变更。/comet-any 用来创建、优化或整理可复用 Skill。做功能、修 bug 或修改项目代码时使用 /comet。将流程整理成可复用 Skill,或在 /comet 五阶段基础上增加团队规则时,使用 /comet-any。
普通使用不要求理解这些术语。方案确认页会列出每一步的行为、调用的 Skill,以及新增或关闭的内容。要做深度定制或审查生成物时,再看Skill Creator 概览。
直接对 Agent 说”继续上次的 Skill 创建”。/comet-any 会先尝试恢复现有创作状态,展示名称、状态、下一步和阻塞原因,让你选择继续哪一个。详见创建 Skill 的完整流程 · 恢复中断流程。
不会。/comet-any 发布后会询问你是否分发,并先展示预览。只有你确认后才会真正写入平台。预览是强制步骤,不能跳过。
可以全程使用 /comet-any,并在流程要求时确认。页面中的命令用于排障和自动化集成。

进阶内容

基础路径到这里就结束了。如果你需要更深入地理解 Skill Creator,看这些页面:
最后修改于 2026年9月4日