Comet BuildSAFE

Comet: agent skill harness for turning ideas into evaluated workflows

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: comet-build
description: '制定计划、实施并验收 Classic 任务。在用户调用 /comet-build,或 Classic Runtime 进入 Build、返回 Build 修复时使用。'
---

# Comet 阶段 3:计划与构建(Build)

收到入口返回的 layout 后,按 `comet-classic/reference/classic-layout.md` 确定各逻辑根对应的目录。当前上下文已有这份协议时,无需重复加载。本文件中的 OpenSpec CLI 调用均通过适配器执行,文件路径均基于已绑定的 `<classic-*>` 根目录,无需先额外运行 root show。

## 前置条件

- Design Doc 已创建(阶段 2 完成)
- 活跃 change 存在

## 步骤

### 0. 入口状态验证(Entry Check)

按 `comet-classic/reference/scripts.md` 使用正式支持的 `comet` CLI,执行以下入口验证。从任意入口恢复任务时,先按 `comet-classic/reference/context-recovery.md` 检查恢复状态:

```bash
comet state select <change-name>
comet state check <name> build --json
```

本轮 Design/Guard 已成功返回 Build 状态信息时,直接使用其中的 `data.configuration`、`configurationReadiness`、`artifactRefs` 和任务信息,并按 `agent.continuation` 继续,不重复 select/check。恢复任务、工作区变化或外部状态变化时,才执行上述入口验证。配置写入成功后,使用返回的结果,不逐字段重复调用 get;验证失败时处理 `data.issues`。

若上述 `select` / `check` 输出 `BLOCKED` 或分支绑定 `ERROR`,且原因是 `bound_branch` 与当前分支不一致,立即按 `comet-classic/reference/decision-point.md` 暂停,让用户单选:切回绑定分支后重新运行入口验证,或在用户明确确认当前分支应接管该 change 后运行 `comet state rebind <change-name>` 并重新入口验证。不得自行切换分支,不得自行换绑。

**恢复**:根据入口返回的 phase、任务 ID 和 plan 的 `base-ref`,核对现有实现与审查记录,再从尚未完成的实施或审查步骤继续。任务未勾选不等于尚未实现。派发任务前先核对检查点,不重复已有提交,也不假定外部操作可以安全重试。

### 1. 先确认执行策略

读取入口返回的 configuration、`configurationReadiness`、taskState 和 nextAction。`configurationReadiness.missingFields` 与 `invalidFields` 均为空时,沿用已确认配置,不重新列成待选择问题;只有缺失或无效字段才补问对应决定。已有计划和审查记录仍然有效时直接继续,不重新询问或生成。工作区必须已在 Open 阶段准备并绑定;缺少 isolation 或目录不匹配时停止,回到 workspace resolve 返回的 projectRoot 恢复任务,不能在 Build 新建或切换工作区。

**写计划前必须确认执行策略**。`configurationReadiness` 只列出尚未确定或组合无效的字段;配置已经有效时不重复询问。配置缺失或用户明确要求更改时,按 `comet-classic/reference/decision-point.md` 在同一轮提问中收集执行方式、TDD 和审查模式,但只询问 `missingFields` 和 `invalidFields` 中列出的决定,不按模型名称自动选择:

| build_mode                    | 行为                                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `autonomous`                  | 用户明确选择后,Agent 自行制定计划;可以串行实施,也可以将范围明确的一组任务委派给子代理,不强制加载外部规划或执行 Skill |
| `subagent-driven-development` | 加载同名 Superpowers Skill;主会话负责协调,实现代理(implementer)负责实施,并遵守 Comet 的任务派发与审查规则           |
| `executing-plans`             | 加载同名 Superpowers Skill,由主会话按计划顺序实施                                                                       |

Agent 具备较强的自主规划能力、任务较长且需要灵活安排时,可推荐 autonomous;希望遵循固定的委派方法时,推荐 subagent-driven-development;希望按固定顺序执行计划时,推荐 executing-plans。推荐不能代替用户确认,也不自动替换已有 change 的执行策略。

| 配置          | 选项与约束                                                                                                                                                          |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tdd_mode`    | `tdd`:先确认测试因待实现的行为而失败(RED),再实施并使测试通过(GREEN);`direct`:不强制逐任务 RED/GREEN,但仍需相关测试和缺陷回归结果                           |
| `review_mode` | `off`:低风险任务不自动审查;`standard`:审查有风险的任务,并在 Verify 完成唯一一次最终集成审查;`thorough`:按已选执行方式逐任务或分段独立审查,并完成最终集成审查 |

full 流程采用 autonomous 时,必须选择 standard 或 thorough,不能用实现者自评代替独立审查。已有执行策略仍遵循原有 review_mode 规则。TDD 默认推荐 tdd,审查默认推荐 standard;hotfix/tweak 的 direct 预设保持不变。

用户完成所有选择后,在一次原子操作中写入配置。例如,用户明确选择自主执行、TDD 和 standard 审查时:

```bash
comet state set <name> build_mode autonomous subagent_dispatch null tdd_mode tdd review_mode standard --json
```

将示例替换为用户的实际选择。选择 subagent-driven-development 时,同时写入 `subagent_dispatch confirmed`;其他方式写入 null。保留 isolation、bound_branch 和已有暂停状态。写入失败时停止,不加载执行 Skill。用户尚未决定或要求暂停时停止,不写入不完整的配置。

`direct` 不是 autonomous 的别名:full 只有用户明确要求且记录 `direct_override true` 才允许 direct;不能借自主策略跳过设计、计划、配置、验证或独立审查。

### 2. 创建或恢复计划

任务是否完成,以 `tasks.md` 为准。需要读取各项任务的正文或 ID 时,才运行 `comet state tasks <name> --json`;缺少 ID 时运行 `comet state tasks <name> --assign-ids --json`。保留已有 ID,并更新受影响的 handoff 和计划中的任务映射。

恢复任务、同步旧计划中的勾选框或补记完成状态时,按 context-recovery.md 处理。任务未勾选不等于尚未实施:已经实现且检查、审查充分的任务可以补勾;其余任务只补未完成的工作。task-complete 会自动同步有 comet-task ID 映射的旧计划;需要单独同步时,使用 `comet state sync-plan <name>`。planSync 返回 mapping-required 时,只补任务映射,不重做实现。

已有有效计划时沿用。否则使用 configuration.language,在 `<classic-superpowers-root>/plans/<YYYY-MM-DD>-<change-name>.md` 创建计划:

- autonomous:由当前 Agent 直接编写和自检,不加载 writing-plans。
- 其他计划执行策略:使用 `writing-plans` Skill,只采用其编写和自检方法;技能失败则停止。传入已确认的配置、design_doc、tasks.md、固定计划路径和当前 `git rev-parse HEAD`。完成后返回 Comet Build,不再次选择执行策略,也不自动进入外部 Skill 的后续流程。

计划深度按风险调整:范围明确、方法成熟且易回退的任务简要记录;存在真实技术取舍、组件依赖、权限、迁移、并发、兼容性或不可逆操作时,补充方案理由、依赖、回退和验证。每个任务仍对应一个可独立验收的结果,列明 task ID、范围、依赖、约束,以及验收命令或场景;不按预计分钟数、文件数量或 RED/GREEN 步骤拆分任务。计划引用已有设计和需求,不预先写出完整实现;只有必须提前审查的接口或高风险算法,才提供必要的代码片段。

新计划不创建第二套 checkbox,写入 `<!-- comet-task-authority: <classic-task-authority-ref> -->`(取自 `data.artifactRefs.tasks` 的仓库相对引用),以 `<!-- comet-task-ref:<task-id> -->` 关联每个任务。计划新增实际任务必须先纳入 tasks.md 并分配 ID;范围变化按 Step 4 处理。

计划文件头:

```yaml
---
change: <change-name>
design-doc: <recorded-design-doc-path>
base-ref: <git rev-parse HEAD before implementation>
---
```

保留旧计划 base-ref,不在恢复时替换为当前 HEAD。`<plan-ref>` 沿用 `data.artifactRefs.plan`,新计划使用 `data.artifactRefs.plansRoot` 与已选文件名组成的仓库相对引用;绝对路径仅用于写文件。确认文件存在后记录:

```bash
comet state set <name> plan "<plan-ref>" --json
```

计划完成后,默认按已确认的策略继续,不再追加配置确认。用户明确要求切换模型,或要求写完计划后暂停时,写入 `comet state set <name> build_pause plan-ready` 并停止。恢复已有 plan-ready 暂停时,只有用户明确要求继续,才清除暂停状态。沿用仍然有效的计划和配置;旧 change 缺少配置时补做 Step 1,不重写计划。

### 3. 执行与验收

执行前使用本轮入口配置和 continuation;配置、需求或工作区变化后刷新入口。按风险执行相关检查,不在每个小修改后重复全量验证;外部 Skill 只执行当前计划和确认配置,不新建 Worktree、重新选择隔离、追加最终审查或调用 finishing-a-development-branch;完成任务返回 Comet Build。

- autonomous:Agent 在计划范围内自行组织实施。需要委派时,先读取 `comet-classic/reference/subagent-dispatch.md`,将范围明确的一组任务作为工作包交给子代理,通过 Runtime 保存协调记录,并安排独立审查者(reviewer);不强制加载外部执行 Skill。
- executing-plans:使用 Skill 工具加载 Superpowers `executing-plans`,传入入口 configuration.language,按计划顺序执行;加载失败则停止。
- sub

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.

[![ModelsAtlas audit: Comet Build](https://modelsatlas.com/skills/rpamis/comet-build/badge.svg)](https://modelsatlas.com/skills/rpamis/comet-build/)

Not your listing, or something out of date? Claim or update your listing.