/comet；它按项目配置选择 Native 或 Classic。进入经典 Spec 模式后，也不需要深入理解 Skill 的底层机制。
Skill 存放在哪里
理解 Skill 的关键，是知道它们安装到哪个目录、由谁发现：
不同来源的 Skill 由不同机制发现；项目 Skill 可以覆盖内置，但不会在失败时静默回退
平台 Skill和项目 Skill的区别：平台 Skill（
comet init 装到 .claude/skills/ 等）由 AI
平台直接发现并变成斜杠命令；项目 Skill（comet skill add 装到
.comet/skills/）是 Comet Engine 自己的 Skill 池，不直接暴露给平台，而是由 Engine
在运行时按名称解析。项目 Skill 是什么
项目 Skill 是安装到 项目内.comet/skills/<name>/ 目录的 Skill 包。它们和平台 Skill 不是一回事：
- 位置：
.comet/skills/<name>/，和.comet/config.yaml同级，属于项目本身（可以提交到 Git）。 - 谁发现：Comet Engine 的
resolveSkill，发现顺序是 explicit（显式路径）→ project（项目 Skill）→ builtin（内置 Skill）。项目 Skill 优先于内置 Skill。 - 不直接进平台：它们不会自动变成
.claude/skills/里的斜杠命令，而是由 Engine 在/comet-classic调用时按名称解析。
为什么要用项目 Skill
怎么安装项目 Skill
./my-skill 目录校验、计算 hash 后复制到 .comet/skills/<metadata.name>/。已存在时需要 --overwrite。安装拒绝符号链接，保证 Skill 包内容是真实的。
Skill 创作工具链
除了add，comet skill 还提供一整套本地 Skill 工具：
经典模式用到的 Skill
经典 Spec 模式的五阶段流程由这些内置 Skill 驱动（comet init 安装到平台目录）：
这些 Skill 随 Comet 包分发，Classic 初始化会安装到平台目录。正常只需调用
/comet；配置选择 Classic 后，内部 /comet-classic 会检测状态并调用对应阶段 Skill。
用 /comet-any 创建可复用 Skill
/comet-any（Skill Creator）是普通用户创建或优化 Skill 的主入口。你只需要描述想创建的工作流，它会：
- 读取项目级偏好
.comet/skill-preferences.yaml。 - 用
find-skill解析真实本地 Skill 内容——不靠名字推测能力。 - 展示 Skill Creator 确认页，列出每个 Skill 的来源、hash、角色和调用顺序，等你确认。
- 确认后生成稳定组合 Skill Bundle（含 skills/scripts/rules/hooks/references），而不是单个
SKILL.md。 - 内部走 CLI 后端做校验、生成 install-candidate、可选安装。
.comet/skill-preferences.yaml 支持 prefer/require/advisory 三类条目，确认后会计算 preferenceHash 绑定到产物。
普通用户不需要理解 Bundle、Factory、组合、Phase Recipe
这些内部概念——它们只存在于实现和审计证据里。用户视角只有三个起点：
定制 /comet-classic、创建新 Skill、
升级已有 Skill。
Engine：进阶内容
如果你用/comet-any 创建可复用 Skill，或用 comet skill 做本地调试和 Engine Run，你需要理解 Skill Engine——Comet 的确定性运行时。Engine 涉及 Skill 包结构、pending action/resume 循环、不可变快照、guardrails 和 runtime checks。
经典 /comet-classic 用户不需要理解 Engine就能使用五阶段工作流。想深入了解时，看Skill 与 Engine（进阶）——完整的 Engine 机制详解，位于组合任意 Skill tab。
下一步
- 工作流概念 —
/comet-classic如何串联五阶段 - 状态与配置 —
.comet.yaml字段和配置 - Skill 与 Engine（进阶） — 深入理解 Engine 运行时