
Comet Open
Use when Comet 需要创建新的 OpenSpec change,或 active change 缺少...
Install
npx skills add rpamis/comet --skill comet-open -g -a claude-code -y- Repository
- rpamis/comet3.3k
- Category
- Design
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 1,461 tokens
- Runs scripts
- No, instructions only
What it does
Use when Comet 需要创建新的 OpenSpec change,或 active change 缺少 proposal/design/tasks/.comet.yaml 初始化产物。
Comet 阶段 1:开启(Open)
前置条件
- 无活跃 change,或用户希望创建新 change
步骤
0. 输出语言约束
传递给 OpenSpec 的所有提问和产物要求都必须包含输出语言约束:使用触发本次工作流的用户请求语言。恢复已有 change 且产物已有明确主语言时,除非用户明确要求切换,否则保持该语言。
1. 探索想法与需求澄清
立即执行: 使用 Skill 工具加载 openspec-explore 技能。禁止跳过此步骤。
技能加载后,按其指引探索问题空间,但不得把一次问答视为足够澄清。必须围绕下列内容继续提问、对齐并形成澄清摘要:
- 目标:用户真正要解决的问题和期望结果
- 非目标:本次明确不做的内容
- 范围边界:涉及/不涉及的模块、用户、平台或数据
- 关键未知项:仍不确定的假设、风险或依赖
- 验收场景草案:至少覆盖核心成功场景和关键边界场景
澄清摘要必须包含:目标、非目标、范围边界、关键未知项、验收场景草案。
1a. PRD 拆分预检(阻塞点)
当用户输入是大型 PRD、路线图、完整产品方案,或澄清摘要显示包含多个独立能力、模块、用户路径或里程碑时,必须在创建 OpenSpec artifacts 前评估是否需要拆分为多个 change。
拆分预检必须基于已澄清的信息,输出候选拆分清单。每个候选拆分项必须包含:
- 建议 change 名称
- 目标与范围边界
- 明确非目标
- 依赖关系或推荐执行顺序
- 对应的核心验收场景
满足任一条件时,应推荐拆分:
- PRD 包含多个可独立设计、构建、验证、归档的 capability
- 涉及多个模块或用户路径,且其中一部分可独立交付
- 存在明显分阶段里程碑
- 预计会产生多个 delta spec 或超过 3 个大任务
- 任一部分失败或延期不应阻塞其他部分进入后续阶段
如推荐拆分,必须按 comet/reference/decision-point.md 的协议暂停并等待用户选择。
用户选择必须包含:
- 「创建多个 OpenSpec changes」, 按候选拆分逐个创建独立 change
- 「保持为一个 change」, 继续单 change 流程,并在 proposal/design/tasks 中记录不拆分原因
- 「调整拆分方案后继续」, 用户说明调整方向后,重新输出候选拆分清单并再次确认
每个被接受的拆分项都必须通过 /comet-open 创建独立 change,不得直接调用 /opsx:new。/comet-open 负责同时创建 OpenSpec artifacts 和 .comet.yaml,确保每个 change 都进入 Comet 状态机。
不得在用户完成 PRD 拆分选择前创建 proposal.md、design.md 或 tasks.md。若用户选择创建多个 change,当前 /comet-open 调用只负责完成拆分确认与调度,随后按用户确认的顺序分别进入每个拆分项的 /comet-open。
批量拆分模式下,进入每个拆分项的 /comet-open 时必须明确标注「已确认拆分项」并携带该拆分项的目标、范围、非目标和验收场景。已确认拆分项默认跳过 PRD 拆分预检,除非该拆分项本身仍明显包含多个独立 capability。
批量拆分模式下,单个拆分项完成 open 阶段后不得自动流转到 /comet-design。拆分完毕后必须暂停询问用户开始哪一个 change;用户选择后,只推进该 change 进入 /comet-design,其他 change 保持 active,稍后通过 /comet 恢复。
最小断点恢复规则:不新增专用批量状态文件。若批量拆分过程中断,恢复时先检查已创建的 active changes;已存在且包含 .comet.yaml 的拆分项不得重复创建,未创建的拆分项按用户已确认的拆分清单继续通过 /comet-open 创建。若对话中已确认的拆分清单不可恢复,必须重新向用户确认拆分清单后再继续。
1b. 需求澄清完成确认(阻塞点)
创建 OpenSpec artifacts 前,必须按 comet/reference/decision-point.md 的协议暂停并等待用户确认需求澄清完成。
暂停时必须展示澄清摘要:目标、非目标、范围边界、关键未知项、验收场景草案。


