> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comet.rpamis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Comet SDK

> 把可恢复工作流、完整 Skill 应用和插件接入你已有的 Agent 平台。

Comet SDK 为 Skill 工作流保存执行记录、用户决定和验证证据，并提供中断后的恢复接口。你的平台继续负责模型请求、工具调用、Skill 加载和用户交互。

如果你希望 Agent 根据目标创建一套流程，从 [Comet Any](/zh/skill-creator/getting-started.md) 开始。需要在自己的产品中定义流程或接入 Agent 平台执行器时，使用本页的 SDK。

## 选择接入层

| 你要实现什么 | 使用哪个入口 |
| - | - |
| 定义步骤、审批、并行依赖和恢复 | Workflow Runtime |
| 将流程、入口 Skill、规则和固定依赖组成可安装的应用 | Workflow Application |
| 在 Native 或 Classic 中增加团队工作 | 原领域的应用工厂 |
| 提供记忆、知识、上下文或其他能力 | Plugin SDK |

Runtime 管理 Run、Action 和 Wait。Application 在其上固定真实 Skill、模块、产物契约和安装身份。Plugin SDK 管理插件注册、安装、启用状态和能力调用；Agent 平台决定何时把插件上下文交给 Agent。

## SDK 可以帮你做什么

| 你的使用场景 | SDK 的行为 | 使用指南 |
| - | - | - |
| 按顺序调用多个 Skill 或工具。 | 保存每个动作及实际结果，沿声明的转移推进。 | [执行 Skill 与工具](/zh/sdk/executors.md) |
| 同时准备初稿和来源，全部完成后汇总。 | 让独立动作就绪，用 `join` 等待所需结果。 | [分支、并行与合流](/zh/sdk/parallel.md) |
| 多个流程复用同一套核验步骤。 | 创建关联的子 Run，父流程等候子流程结果。 | [子工作流](/zh/sdk/subworkflows.md) |
| 发布前让用户查看草稿。 | 保存提案与等待，把决定绑定当前内容。 | [用户审批](/zh/sdk/approvals.md) |
| 等待测试报告或外部审核记录。 | 核对证据归属与真实摘要后继续。 | [等待与提交证据](/zh/sdk/evidence.md) |
| 格式正确的结果仍可能不合格。 | 分别检查输出结构、业务条件和真实文件。 | [输出验证](/zh/sdk/output-validation.md)、[产物验收](/zh/sdk/artifact-validation.md) |
| 应用关闭后继续昨天的任务。 | 持久化 Run，按原版本和原身份恢复。 | [持久化](/zh/sdk/persistence.md)、[未知结果恢复](/zh/sdk/recovery.md) |
| 按业务结果修订，最多循环两轮。 | 保存业务状态，按已声明路径选择下一步。 | [业务状态与循环](/zh/sdk/state.md) |
| 向团队交付可安装的流程。 | 固定入口、模块和依赖，预览并确认安装。 | [完整应用](/zh/sdk/applications.md)、[分发与升级](/zh/sdk/distribution.md) |
| 将团队 Skill 加入开发流程。 | 在 Native 或 Classic 的原验收条件内扩展。 | [组合工作流](/zh/sdk/composition.md) |
| 为 Agent 增加知识、记忆或其他能力。 | 管理插件生命周期与具名能力调用。 | [插件接入](/zh/sdk/plugins.md) |

首次接入建议先跑通 [第一个工作流](/zh/sdk/quickstart.md)，再将本地处理函数替换为已有 Agent 的调用。需要平台安装和完整 Skill 依赖时，再封装 Application；仅验证调度行为时可以先使用基础 Runtime。

## 安装与公开入口

需要 Node.js 22.16 及以上的 22.x 版本，或 Node.js 24 及以上版本。SDK 使用 ESM，并提供 TypeScript 声明。

```bash theme={null}
npm install @rpamis/comet@0.5.0
```

| 导入路径 | 用途 |
| - | - |
| `@rpamis/comet/runtime` | Workflow、执行器、Store、审批与恢复 |
| `@rpamis/comet/applications` | 应用加载、Skill 适配、产物检查、报告样板与分发 |
| `@rpamis/comet/applications/compiler` | 从确认方案装配应用及隔离产物验收 |
| `@rpamis/comet/applications/native` | Native 扩展工厂 |
| `@rpamis/comet/applications/classic` | Classic full、hotfix、tweak 组合工厂 |
| `@rpamis/comet/applications/creator` | 可恢复的创作流程和观测接口 |
| `@rpamis/comet/plugins` | 通用插件 Runtime、定义、存储和类型助手 |
| `@rpamis/comet/plugins/comet` | 包含个人记忆与项目知识的 Comet 插件集成 |

导入基础 Runtime 不会自动启动 Agent 或装配 Native、Classic、个人记忆、项目知识。按实际职责选择入口。

## 从这里继续

> **[第一个工作流](/zh/sdk/quickstart.md)**
>
> 跑通执行、用户审批与跨进程恢复。

> **[完整应用](/zh/sdk/applications.md)**
>
> 把入口、流程和固定依赖组成可运行的包。

> **[阶段产物验收](/zh/sdk/artifact-validation.md)**
>
> 声明必需文件、内容条件和业务验证器。

> **[插件接入](/zh/sdk/plugins.md)**
>
> 注册具名能力，尊重安装、禁用和作用域。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.