mcpField
C
comet-design

comet-design

github.com/rpamis开发3.2k858 次安装今天更新
代码仓库

关于 comet-design

Comet Phase 2: Design 是供 Agent 执行 Comet 设计阶段的技能，涵盖候选方案拟定、提案审阅与批准，以及 SDK 工作流中的设计文档完成。

主要功能

  1. 01设计阶段指引
  2. 02拟定候选设计
  3. 03确认 Spec Patch
  4. 04提案与审批流程
  5. 05完成设计文档

适用场景

  1. 01制定变更设计
  2. 02确认所需的 Spec Patch
  3. 03审阅并批准设计提案

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rpamis/comet --skill comet-design

安装后在 Claude Code 中输入/comet-design确认已加载。

附带文件agents/openai.yamlreference/compat.md

详细介绍

Comet 第 2 阶段：设计

首次进入某个阶段、移交给新的 Agent 或恢复上下文时，请阅读并遵循 任务上下文与制品语言。优先使用当前继续执行或已认领 Action 的 contextRequest；在同一阶段连续工作期间，不要反复检索。

入口返回布局后，使用 comet-classic/reference/classic-layout.md 解析每个逻辑根目录。如果此协议已在上下文中，请重复使用。所有 OpenSpec CLI 调用都通过适配器执行，文件路径使用绑定的 <classic-*> 根目录；不要先额外运行一次 root show。

SDK 运行路径

首次进入当前 SDK 阶段、移交给新的 Agent 或恢复上下文时，请阅读阶段进入与恢复以及该参考文档中当前阶段的章节。如果本次会话中已有可用且仍然有效的内容，请复用。继续执行以下阶段；基于 nextAction.kind 的恢复路由仅适用于没有延续模式的旧响应。

复用同一变更、工作区和 Run 的最新有效响应：agent.continuation、data.nextAction、阶段、修订版本和路径摘要。仅在冷启动恢复、工作区或外部状态发生变更、响应版本过时，或缺少当前步骤所需信息时，才运行 comet state next <change-name> --json；加载下一个 Skill 并不是再次查询的理由。运行时仍会在写入时验证当前版本和证据；缓存的上下文不能绕过检查或审批。对于 data.runtimeFormat: sdk，请使用本节进行状态变更；探索、提问和正式文档要求请使用 SDK 执行方法中的 Design 章节。data.phase 必须为 design。如果已开始 Build，请返回其入口。对于 nextAction.kind: reconcile，请运行 comet state check <change-name> design --recover --json，并在提出建议或重新派发前确认所声称的 Action 的原始结果。

  1. 在 full.design.handoff 阶段，复用当前响应中的布局和参考资料；仅在缺失时运行 comet state check <change-name> design --json。阅读当前的 OpenSpec 提案、任务、增量规范以及相关的现有 design.md。按照 SDK 执行方法中的 Design 章节制定候选方案，并及时更新 brainstorm-summary.md，将未经批准的内容标记为候选方案。目前还没有 SDK 移交包；不要调用旧版 comet handoff ... --write，也不要用手写摘要替代。
  2. 如需 Spec Patch，请先按照 SDK 执行方法中的 Design 确认规则说明并取得明确同意，再编辑增量规范。若范围发生实质性变化，请重新澄清。源文件稳定后，运行 comet state propose-design <change-name> --proposal "<candidate-summary>"；摘要必须涵盖拟议设计、权衡、风险和 Spec Patch。将 data.wait.proposalHash 保存为 <proposalHash>。此操作会创建可追溯的移交。使用提案响应中的 data.configuration.handoffContext；仅在缺失时查询 comet state next <change-name> --json，并核对 Markdown 移交包与候选方案及源文件一致。恢复时复用现有的待处理 Wait。
  3. 按照 SDK 执行方法中的 Design 确认规则呈现设计，并请用户批准、要求修改或暂缓。只有在用户明确批准或拒绝时，才提交 comet state decide-design <change-name> --proposal-hash <proposalHash> --choice <approved|rejected>。被拒绝后请修改并重新提出；暂缓时保留 Wait 不变。如果源文件或移交内容发生偏移，导致批准失效，请先调查，不要应用旧决策。
  4. 获得批准后，填写符合要求的 frontmatter，写入唯一的 Design Doc。如果恢复信息已指向 full.design.document，请从此处继续。直接运行 comet state complete-design <change-name> --design-doc <design-doc-ref> --approval-hash <proposalHash>。失败时保留 Run，并处理具体原因。运行时会同步实际状态文件；Agent 不要手动推进阶段。根据同一条成功响应中的 Build Action 和延续信息进行路由；仅在缺少延续信息时运行 comet state next <change-name> --json。

兼容路径

其余原始 Runtime 步骤仅适用于 runtimeFormat: compat。请阅读兼容操作，并继续当前阶段。SDK 不会加载该参考文档。

评论

支持 Markdown