comet-any
根据目标调查 Skills,创作 Native 扩展、Classic 编排或独立应用的完整入口 Skill 与业务 Rule;确认后由 SDK 装配 Runtime、接入 Hook 并预览安装。不用于一般 Skill 的整理或评审。
- License 许可
- MIT
- 所属仓库
- rpamis/comet
- 最近更新
- 2026-11-15
- Stars
- ★ 3.3k
- Forks
- 314
01 前言 Front Matter
- name
- comet-any
- description
- 根据目标调查 Skills,创作 Native 扩展、Classic 编排或独立应用的完整入口 Skill 与业务 Rule;确认后由 SDK 装配 Runtime、接入 Hook 并预览安装。不用于一般 Skill 的整理或评审。
- disable-model-invocation
- true
02 资源文件 2
- 参考文档agents/openai.yaml186 B
- 参考文档reference/sdk-creation.md9.1 KB
03 SKILL.md 正文
Comet Any
根据用户目标调查真实 Skills,创作组合应用的正文、流程和业务实现。通过 comet creator 保存方案与进度,每完成一个阶段就读取当前动作,推进到完成、需要用户决定或外部能力阻塞。
Agent 编写入口 Skill、业务 Rule、执行端口与验证器;SDK 保留正文,追加执行协议和通用保护规则,并装配 Runtime。业务 Rule 描述业务约束,Runtime 与 Guard 控制动作、批准和写入权限。安装使用 SDK 正式分发。
开始或继续
- 已知创作名称时运行
comet creator status <name> --project <项目> --json,再执行comet creator next <name> --project <项目> --json。保留原名称与 Run;中断后先查询原 Action,不重复发起已完成工作。 - 新创作先读取
comet creator guide --project <项目> --json。从用户描述确定目标与安装位置;只有无法调查且会改变结果的选择才询问用户。使用comet creator start <name> --project <项目> --goal <用户目标> --install-target <相对目录> --host codex|claude-code --json启动。 - 首次领取或提交动作前,读取创作动作与恢复。使用返回的 Action、attempt、inputHash 和本次宿主会话标识;当前动作没有所需能力时明确阻塞,保留现场。
分析与方案
analyze 由宿主调查和创作。需要委派时,传递原目标、当前动作、工作范围和固定依赖。
-
用
comet creator candidates --project <项目> --json发现候选;读取候选的SKILL.md、脚本和必要资源。检查实际输入、输出、授权、宿主能力、结束条件、失败与恢复;不按名称推测能力,不改第三方原文件。 -
对方案中必须使用的 Skill:
立即执行: 使用 Skill 工具加载 <skill-name> 技能。禁止跳过此步骤。
技能加载后,依据实际内容填写适配契约与内容摘要;自行审批或发布的 Skill 须声明相应能力与副作用。
-
选择用户需要的起点:Native 增加步骤、指导和审查;Classic 在 full、hotfix、tweak 的允许位置编排;独立流程声明顺序、分支、汇合、子流程和有界修复。将用户交互、共同理解确认和实施步骤纳入 Runtime。
-
编写完整入口 Skill:frontmatter 的 name 等于应用 id,description 写清触发场景;正文说明输入、依赖 Skill 的调用、交互与审批、产物、验收、失败和恢复。业务 Rule 约束具体业务行为;详细材料按需放入 references,并写明读取条件。
-
按参考中的
documents结构回传正文,与流程和业务端口组成当前方案。逐阶段填写manifest.artifactContracts:有必需文件时声明真实引用、内容条件和必要的业务验证器;没有强制文件时填写noArtifactsReason。每个必需产物阶段提供artifactTests正常样例,业务验证器还需提供通过通用文件检查的异常样例。条件不明确时先澄清,不能用自报完成代替。具体结构见创作动作与恢复。缺少正文、实现、验证器、依赖或能力时补齐分析;已有方案则走 revise 后重新确认。
确认、验证与交付
next到达方案确认时,展示完整正文、内容摘要、实际步骤、Skill 绑定、产物、检查、失败路径与能力限制,并说明编译后可选择 Eval。- 用户明确确认当前方案后,提交当前
confirm-plan的用户决定。摘要只是方案标识;得到摘要不等于获得授权。拒绝则保留现场;修改方案走revise,受影响的确认与验证重新执行。 - 连续调用
next完成编译、实际加载和阶段产物验收。SDK 在隔离目录检查正常样例能完成,并自动构造缺文件、空文件、内容变化等反例,核对原 Action 未被推进。业务异常样例须被实际验证器拒绝。这些本地检查必须通过才可安装,跳过模型 Eval 不会跳过它们。失败时保留现场,修正方案或产物后沿原 Action 恢复。 - 到达
confirm-eval时,展示 Agent、模型、用例数、交互轮数和总时限,让用户选择 evaluate、skip 或 revise。evaluate 后调用next执行并保存报告;重试复用原用例,修订应用后优先沿用。失败或未完成时停在review-eval,展示报告与未覆盖路径,让用户选择 retry、revise 或明确 skip;跳过仍保留实际状态。 - 安装前展示导出目录、平台入口、固定依赖、Runtime、Rule/Hook 配置、冲突与 Eval 状态;预览不写安装目标。
install-target使用与平台入口分开的导出目录,例如.comet/creator/exports/<应用名>。只在用户明确批准当前预览后提交confirm-install,由 Creator 导出并正式安装。预览失败或安装中断时,按参考中的恢复步骤处理;目标、依赖、文件、配置或评估报告变化后重新确认。 - 交付包与入口位置、实际检查、Eval 报告、未执行项和限制。分别列出真实 Skill 加载、Rule 配置、Hook 执行、SDK Run 和业务断言的结果;配置安装成功不代表 Hook 已生效。
恢复边界
- 使用原 Run ID、当前 Action/Wait 和输入摘要继续,不复用陈旧请求。
- 未知执行先核对原实验、进程或产物;无法确认时保留现场并阻塞,不盲目重试。
- 凭据仅通过执行环境注入,不写入方案、源码、生成包、Run 或报告。
04 同仓库更多 Skills
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
verification-before-completion
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
using-git-worktrees
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes