# Comet Any

根据目标调查 Skills，创作 Native 扩展、Classic 编排或独立应用的完整入口 Skill 与业务 Rule；确认后由 SDK 装配 Runtime、接入...

- Repository: https://github.com/rpamis/comet (3263 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rpamis/comet --skill comet-any -g -a claude-code -y`
Codex: `npx skills add rpamis/comet --skill comet-any -g -a codex -y`
Cursor: `npx skills add rpamis/comet --skill comet-any -g -a cursor -y`
Gemini CLI: `npx skills add rpamis/comet --skill comet-any -g -a gemini-cli -y`

## Description

根据目标调查 Skills，创作 Native 扩展、Classic 编排或独立应用的完整入口 Skill 与业务 Rule；确认后由 SDK 装配 Runtime、接入 Hook 并预览安装。不用于一般 Skill 的整理或评审。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Comet Any

根据用户目标调查真实 Skills，创作组合应用的正文、流程和业务实现。通过 `comet creator` 保存方案与进度，每完成一个阶段就读取当前动作，推进到完成、需要用户决定或外部能力阻塞。

Agent 编写入口 Skill、业务 Rule、执行端口与验证器；SDK 保留正文，追加执行协议和通用保护规则，并装配 Runtime。业务 Rule 描述业务约束，Runtime 与 Guard 控制动作、批准和写入权限。安装使用 SDK 正式分发。

## 开始或继续

1. 已知创作名称时运行 `comet creator status <name> --project <项目> --json`，再执行 `comet creator next <name> --project <项目> --json`。保留原名称与 Run；中断后先查询原 Action，不重复发起已完成工作。
2. 新创作先读取 `comet creator guide --project <项目> --json`。从用户描述确定目标与安装位置；只有无法调查且会改变结果的选择才询问用户。使用 `comet creator start <name> --project <项目> --goal <用户目标> --install-target <相对目录> --host codex|claude-code --json` 启动。
3. 首次领取或提交动作前，读取[创作动作与恢复](reference/sdk-creation.md)。使用返回的 Action、attempt、inputHash 和本次宿主会话标识；当前动作没有所需能力时明确阻塞，保留现场。

## 分析与方案

`analyze` 由宿主调查和创作。需要委派时，传递原目标、当前动作、工作范围和固定依赖。

1. 用 `comet creator candidates --project <项目> --json` 发现候选；读取候选的 `SKILL.md`、脚本和必要资源。检查实际输入、输出、授权、宿主能力、结束条件、失败与恢复；不按名称推测能力，不改第三方原文件。
2. 对方案中必须使用的 Skill：

   **立即执行：** 使用 Skill 工具加载 <skill-name> 技能。禁止跳过此步骤。

   技能加载后，依据实际内容填写适配契约与内容摘要；自行审批或发布的 Skill 须声明相应能力与副作用。

3. 选择用户需要的起点：Native 增加步骤、指导和审查；Classic 在 full、hotfix、tweak 的允许位置编排；独立流程声明顺序、分支、汇合、子流程和有界修复。将用户交互、共同理解确认和实施步骤纳入 Runtime。
4. 编写完整入口 Skill：frontmatter 的 name 等于应用 id，description 写清触发场景；正文说明输入、依赖 Skill 的调用、交互与审批、产物、验收、失败和恢复。业务 Rule 约束具体业务行为；详细材料按需放入 references，并写明读取条件。
5. 按参考中的 `documents` 结构回传正文，与流程和业务端口组成当前方案。逐阶段填写 `manifest.artifactContracts`：有必需文件时声明真实引用、内容条件和必要的业务验证器；没有强制文件时填写 `noArtifactsReason`。每个必需产物阶段提供 `artifactTests` 正常样例，业务验证器还需提供通过通用文件检查的异常样例。条件不明确时先澄清，不能用自报完成代替。具体结构见[创作动作与恢复](reference/sdk-creation.md)。缺少正文、实现、验证器、依赖或能力时补齐分析；已有方案则走 revise 后重新确认。

## 确认、验证与交付

The rest: https://github.com/rpamis/comet/blob/HEAD/assets/skills-zh/comet-any/SKILL.md