Comet Open

This handles the initialization phase of Comet's OpenSpec workflow when you need to start a new change or set up a missing one. It walks through requirement clarification, creates the change structure with proposal, design, and tasks documents, and initializes the state machine. The workflow enforces several blocking checkpoints where you must confirm the clarified requirements, approve the change name, and review generated artifacts before proceeding. It also includes logic to detect when a large PRD should be split into multiple independent changes. The whole thing is designed to prevent you from skipping exploration or auto-generating names, which makes it deliberate but thorough. If you're working in a codebase that uses Comet's phase-gated workflow, this is your entry point.

skills.sh installs: 860
GitHub stars: 3.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add rpamis/comet --skill comet-open --agent claude-code

Installs into .claude/skills of the current project.

Files

Comet 阶段 1：开启（Open）

首次进入阶段、交接给新 Agent 或上下文恢复后，读取并执行任务上下文与产物语言，优先采用当前 continuation 或已领取 Action 的 contextRequest；同一阶段连续执行不重复获取。

开始或恢复任务前，必须先读取并遵守 comet-classic/reference/classic-layout.md。本文件中的 OpenSpec CLI 调用必须通过适配器执行，文件路径必须基于该协议绑定的 <classic-*> 逻辑根目录。

前置条件

无活跃 change，或用户希望创建新 change

步骤

0. 设置输出语言

向 OpenSpec 传递提问和文档生成要求时，都必须明确指定 Comet 配置的产物语言，使用 en、zh-CN 这类规范化 ID。change 尚未初始化时，依次读取项目 .comet/config.yaml 和全局 ~/.comet/config.yaml 的 classic.language；初始化后，复用当前有效响应中的 configuration.language；缺少时才使用 comet state get <name> language 读取。没有配置语言时，才采用当前用户请求的语言。生成的 proposal.md、design.md、tasks.md 必须以该语言为主。

0a. 当前 change 绑定

响应已有 agent.continuation.mode 时，先按 comet-classic/reference/auto-transition.md 处理；wait 按 auto-transition.md 区分手动衔接和原任务等待，不能因兼容字段 nextAction.kind: reconcile 再做恢复查询。使用当前响应的命令与输入；Skill 工作实际完成后才使用 completion 提交。下文依据 nextAction.kind 的恢复规则仅用于没有 mode 的旧响应。

恢复已有 change 时，复用同一工作区和 Run 的最新有效 continuation 与归属；冷恢复、外部状态变化或信息缺失时才运行 comet state next <name> --json，再按 data.runtimeFormat 处理：

SKILL.md on GitHub