Comet AI 辅助研发框架使用

安装

npm install -g @rpamis/comet

本质是安装了一系列依赖工具（comet、openspec）与Skill（comet、superpowers）。能够自动发现原装的主流AI辅助研发工具。

实际使用时，在 AI 辅助研发内部以 Skill 方式调用 comet 主入口 /comet

在示例后端服务上试验

已识别问题：k8s client、配置对象等存在一处来源、多点创建的问题。需要对项目进行单例整改：消除已有重复创建问题、统一现有与新增单例资源生命周期

测试工具为 Claude Code，测试模型为 deepseek-v4-pro/flash（分别用于 Agent 任务与编码任务）

需求分析与方案设计

为了测试需求分析能力，写了简单的 prompt：

/comet 对当前项目进行单例归一 ，消除重复创建，统一资源生命周期

/comet-open 调用 /openspec-explore 探索项目结构并识别问题。

同时 comet 本身也对 openspec 的任务进行了跟踪。

openspec 通过向用户提问进行需求澄清

澄清完成后，多次调用 openspec 命令生成了 proposal.md、design.md。随后根据工作项拆分生成了多个子 spec.md，并输出总体 task.md。

在 openspec 生成设计后，comet 调用 /comet-build 整合所有涉及信息，随后调用 /superpowers:brainstorming 进行详细设计并输出到 superpowers doc 路径

中断恢复

设计完成后，comet 原计划进入 /comet-build 阶段。此时尝试手动中断任务，在新会话中调用 /comet 要求继续任务。通过执行一系列命令，读取特定状态文件，comet 成功还原了上下文并从中断的位置重新开始。

构建

详细设计文档完成并确认后，进入 /comet-build 阶段

调用 superpowers /writing-plans 编写计划，并写入文件

从设计阶段过渡到编码阶段时，提供断点，此时提示用户可以切换模型。针对编码类任务，切换到性价比模型时常见AI编码经济化操作，这里尝试改为 deepseek-v4-flash，验证在具体设计规约是否能弥补模型能力的差距。

Comet 为开发端提供了四大维度，通过用户问答形式确认。确认后正式进入了编码阶段

根据 plan 依次完成了所有任务，每个任务都进行了编码 -> 验证 -> 提交 commit 的流程，这里省略。

编码全部完成后，调用 /comet-verify 进入验证阶段，实际上进一步调用了 /superpowers:verification-before-completion & /openspec-verify-change

执行结果

Comet 工作流分析

Comet 核心主由 Skill 和工具脚本两部分组成，同时依赖一系列第三方插件

类型	功能	实例
Skill	面向Agent的决策指导层，包括核心决策逻辑、工作流指导与参考文档	/comet, /comet-open, /comet-design, /comet-build, etc.
工具脚本	状态做管理、阶段过渡门卫、自动化工具、校验诊断	state, guard, archive, yaml-validate, etc.
第三方工具	实际的设计、规划、实现、验证能力	openspec, superpowers, CodeGraph

OpenSpec为规范驱动的开发流程（SDD）提供规划与需求管理的框架，包含需求定义、Spec生命周期等能力。Superpowers则以测试驱动开发（TDD）为核心，注重开发流程与质量控制框架。两者工作流体系相互独立，单独使用其中一种，均无法覆盖从需求分析到实现的完整软件研发工作流程。comet 可以作为中介，通过提供五流程状态机将两者结合，串联为完整的研发流程：

阶段	职责	实现
Open	任务创建与Spec生成	OpenSpec
Design	详细设计	Superpowers
Build	实施计划	Superpowers
Verify	验证结果	OpenSpec + Superpowers
Archive	设计归档	OpenSpec

# 摘自Readme
/comet-open  -->  /comet-design  -->  /comet-build  -->  /comet-verify  -->  /comet-archive
(OpenSpec)         (Superpowers)       (Superpowers)       (Both)           (OpenSpec)

此外 comet 也提供了 /comet-hotfix、/comet-tweak 轻量化流程，以应对简单 bugfix 和规格刷新任务。

在任务执行过程中，comet 主要通过维护一系列结构化的文件。包括全局任务配置、任务状态、spec/design关联等信息，Agent 在任务过程中通过调用 comet state 脚本来刷新这些状态。在阶段过渡时，Agent 则会调用 comet guard 脚本，根据当前环节执行不同的门禁检查，全部通过后方可进入下一阶段。

参考价值

通过显式、结构化的文件状态机来管理作业流程中的每个节点，使状态信息的本地持久化管理高效、可追溯。
引入工作流专用脚本，以程序方式提供关节节点的状态校验，可靠性更高
充分使用业界辅助研发能力框架提供的最佳实践

yangxt65535