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. 首次领取或提交动作前，读取创作动作与恢复。使用返回的 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 正常样例，业务验证器还需提供通过通用文件检查的异常样例。条件不明确时先澄清，不能用自报完成代替。具体结构见创作动作与恢复。缺少正文、实现、验证器、依赖或能力时补齐分析；已有方案则走 revise 后重新确认。

确认、验证与交付