[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72VYN0B1WAB9SDW01F64Y24":3,"skill-same:01M72VYN0B1WAB9SDW01F64Y24":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M72VYN0B1WAB9SDW01F64Y24","comet-build",null,"制定计划、实施并验收 Classic 任务。在用户调用 \u002Fcomet-build，或 Classic Runtime 进入 Build、返回 Build 修复时使用。","rpamis\u002Fcomet","rpamis","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F153429891?v=4","01M72VXBR7EQYMM7KN8C19244V","01M72VXBRYC06QG0ZH0JBGV09V",3298,"MIT","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-build\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: comet-build\ndescription: '制定计划、实施并验收 Classic 任务。在用户调用 \u002Fcomet-build，或 Classic Runtime 进入 Build、返回 Build 修复时使用。'\n---\n\n# Comet 阶段 3：计划与构建（Build）\n\n首次进入阶段、交接给新 Agent 或上下文恢复后，读取并执行 [任务上下文与产物语言](..\u002Fcomet-classic\u002Freference\u002Fscripts.md#任务上下文与产物语言)，优先采用当前 continuation 或已领取 Action 的 `contextRequest`；同一阶段连续执行不重复获取。\n\n收到入口返回的 layout 后，首次接收阶段或绑定变化时执行[阶段共用入口](..\u002Fcomet-classic\u002Freference\u002Fscripts.md#阶段共用入口)，复用仍有效的 [layout](..\u002Fcomet-classic\u002Freference\u002Fclassic-layout.md)，无需先额外运行 root show；遇编辑判断时按共用入口加载编辑后续行协议。\n\n## SDK Run 路径\n\n先读取并执行[普通命令与检查](..\u002Fcomet\u002Freference\u002Fplatform-execution.md)。新旧 Run 均使用平台工具执行普通命令，在原 Run 提交实际检查报告；自动升级不恢复旧检查执行器。阶段准备、用户选择、任务完成和验收要求继续有效。\n\n首次进入当前 SDK 阶段、换 Agent 或恢复上下文时，读取[阶段入口与恢复](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#阶段入口与恢复)及该参考的当前阶段章节；本会话已有且仍有效时直接复用。下文按当前阶段执行；`nextAction.kind` 的恢复路由只适用于没有 continuation mode 的旧响应。\n\n优先复用当前有效结果中的 `agent.continuation` \u002F `data.nextAction` 与已绑定状态；只有冷恢复、外部状态变化或缺少必要信息时，才运行 `comet state next \u003Cchange-name> --json`。`data.runtimeFormat` 为 `sdk` 时，只按本节推进 Run；SDK 方法参考的执行策略选项、计划内容要求、实施与审查方法仍适用，状态和证据通过本节命令提交。`data.phase` 必须为 `build`。已有有效 layout 与当前配置时直接复用；缺少时运行 `comet state check \u003Cchange-name> build --json`；若 `nextAction.kind` 为 `reconcile`，运行 `comet state check \u003Cchange-name> build --recover --json` 核对原 Action 的结果，在结果明确前不重发外部工作。\n\n先核对有效配置中的 `workflow` 或当前 `nextAction.stepId`。`tweak.build.*` \u002F `workflow: tweak`：**立即执行：** 使用 Skill 工具加载 comet-tweak 技能。禁止跳过此步骤。`hotfix.build.*` \u002F `workflow: hotfix`：**立即执行：** 使用 Skill 工具加载 comet-hotfix 技能。禁止跳过此步骤。技能加载后，传入同一 change、工作区、phase、Run revision 和 continuation，从该预设的 SDK Build 步骤继续，不要求 full Design Doc 或完整计划，也不重跑 Open。旧 Run 的原始 Action 仍可能引用 `comet-build`，同样按此规则路由。已批准升级且当前步骤为 `full.build.*` 时，执行下列 full 路径。\n\n1. `full.build.configure` 待执行时，按 SDK 方法参考的 [Build 配置说明](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#build)展示值、含义及确认状态，只补真正缺失、无效或用户要求更改的执行方式、TDD 和审查决定。将已确认的 `build_mode`、`tdd_mode`、`review_mode`、`subagent_dispatch` 和需要时的 `direct_override` 写入仓库内的临时 JSON；用户已明确选择这份完整配置时，运行 `comet state propose-build \u003Cchange-name> --file \u003Cconfiguration-json> --confirmed` 一次保存提案与批准；尚未决定时运行 `comet state propose-build \u003Cchange-name> --file \u003Cconfiguration-json>`。仅在仍有待决定 Wait 时，从返回的 `data.wait.proposalHash` 保存 `\u003CproposalHash>`，向用户展示实际配置并按 decision-point.md 等待确认。确认或拒绝时运行 `comet state decide-build \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Capproved|rejected>`；拒绝后从新配置重新提案。恢复已有待决定 Wait 时复用原提案，不重复提问或新建配置 Action。保存批准后简短回显并继续，不再增加一次继续确认。\n2. `full.build.plan` 待执行时，按 SDK 方法参考的 Build 章节创建或核对计划。计划引用当前 Design Doc 和 tasks.md，以 `\u003C!-- comet-task-authority: \u003Cclassic-task-authority-ref> -->` 及 `\u003C!-- comet-task-ref:\u003Ctask-id> -->` 映射任务，不能另建 checkbox。运行 `comet state submit-plan \u003Cchange-name> --plan \u003Cplan-ref>` 提交计划及证据。只有用户明确要求写完计划暂停时加 `--pause`；恢复 `plan-ready` Wait 时，必须等用户明确继续，再用该 Wait 的当前哈希运行 `comet state continue-plan \u003Cchange-name> --proposal-hash \u003CproposalHash>`。计划或任务要求变化后不复用原批准。\n3. `full.build.execute` 待执行时，按 SDK 方法参考的 Build 章节的已选方法实施、做任务级或分段审查并运行相关检查。任务实际完成且审查合格后勾选同一 tasks.md；任务 ID、勾选和协调进度使用共享参考中的 `state tasks`、`state task-complete`、`state checkpoint`；这些命令不推进 SDK Run。SDK 不调用旧 `comet handoff --write`。核对计划、任务和工作区后运行 `comet state complete-build \u003Cchange-name> --session \u003Cbuilder-execution-ref> --checks \u003Cchecks-json-file>`，由 Run 进入 Verify。实现或计划与已接受证据不一致时先解决具体漂移，不绕过 SDK 校验。\n\n每次推进后，优先使用同次结果的 `agent.continuation` \u002F `data.nextAction`；状态仍有效且信息完整时，不重复 next、select 或 check。仅在冷恢复、外部状态变化或缺少必要信息时补读。只有 `action` 且指向下一阶段时才加载下一 Skill。`decision`、`evidence`、`reconcile` 均先完成当前 Run 的恢复或用户决定。\nSDK Build 使用真实的 `--session \u003Cbuilder-execution-ref>` 关联执行；已经携带时无需再次传入。\n\n## Compat 路径\n\n以下旧 Runtime 步骤仅用于 `runtimeFormat: compat`。必须读取 [Compat 操作](reference\u002Fcompat.md)，按其中当前阶段继续；SDK 不加载该参考。\n\n## 可选变更说明\n\nBuild 收尾和 Verify 展示结果前，先核对项目 `.comet\u002Fconfig.yaml` 的 `change_walkthrough`（默认开启；仅显式 `false` 关闭）。开启时读取并执行[变更说明](..\u002Fcomet\u002Freference\u002Fchange-walkthrough.md)，用共享模板生成或更新同一 `walkthrough.html` 并给出打开链接；关闭时跳过额外讲解、详细指引和渲染，保留原有摘要。Archive 只随现有材料保存已有页面并提供实际归档链接，不补生成、不新增确认、不为页面更新重跑代码检查。\n","# Comet 阶段 3：计划与构建（Build）\n\n首次进入阶段、交接给新 Agent 或上下文恢复后，读取并执行 [任务上下文与产物语言](..\u002Fcomet-classic\u002Freference\u002Fscripts.md#任务上下文与产物语言)，优先采用当前 continuation 或已领取 Action 的 `contextRequest`；同一阶段连续执行不重复获取。\n\n收到入口返回的 layout 后，首次接收阶段或绑定变化时执行[阶段共用入口](..\u002Fcomet-classic\u002Freference\u002Fscripts.md#阶段共用入口)，复用仍有效的 [layout](..\u002Fcomet-classic\u002Freference\u002Fclassic-layout.md)，无需先额外运行 root show；遇编辑判断时按共用入口加载编辑后续行协议。\n\n## SDK Run 路径\n\n先读取并执行[普通命令与检查](..\u002Fcomet\u002Freference\u002Fplatform-execution.md)。新旧 Run 均使用平台工具执行普通命令，在原 Run 提交实际检查报告；自动升级不恢复旧检查执行器。阶段准备、用户选择、任务完成和验收要求继续有效。\n\n首次进入当前 SDK 阶段、换 Agent 或恢复上下文时，读取[阶段入口与恢复](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#阶段入口与恢复)及该参考的当前阶段章节；本会话已有且仍有效时直接复用。下文按当前阶段执行；`nextAction.kind` 的恢复路由只适用于没有 continuation mode 的旧响应。\n\n优先复用当前有效结果中的 `agent.continuation` \u002F `data.nextAction` 与已绑定状态；只有冷恢复、外部状态变化或缺少必要信息时，才运行 `comet state next \u003Cchange-name> --json`。`data.runtimeFormat` 为 `sdk` 时，只按本节推进 Run；SDK 方法参考的执行策略选项、计划内容要求、实施与审查方法仍适用，状态和证据通过本节命令提交。`data.phase` 必须为 `build`。已有有效 layout 与当前配置时直接复用；缺少时运行 `comet state check \u003Cchange-name> build --json`；若 `nextAction.kind` 为 `reconcile`，运行 `comet state check \u003Cchange-name> build --recover --json` 核对原 Action 的结果，在结果明确前不重发外部工作。\n\n先核对有效配置中的 `workflow` 或当前 `nextAction.stepId`。`tweak.build.*` \u002F `workflow: tweak`：**立即执行：** 使用 Skill 工具加载 comet-tweak 技能。禁止跳过此步骤。`hotfix.build.*` \u002F `workflow: hotfix`：**立即执行：** 使用 Skill 工具加载 comet-hotfix 技能。禁止跳过此步骤。技能加载后，传入同一 change、工作区、phase、Run revision 和 continuation，从该预设的 SDK Build 步骤继续，不要求 full Design Doc 或完整计划，也不重跑 Open。旧 Run 的原始 Action 仍可能引用 `comet-build`，同样按此规则路由。已批准升级且当前步骤为 `full.build.*` 时，执行下列 full 路径。\n\n1. `full.build.configure` 待执行时，按 SDK 方法参考的 [Build 配置说明](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#build)展示值、含义及确认状态，只补真正缺失、无效或用户要求更改的执行方式、TDD 和审查决定。将已确认的 `build_mode`、`tdd_mode`、`review_mode`、`subagent_dispatch` 和需要时的 `direct_override` 写入仓库内的临时 JSON；用户已明确选择这份完整配置时，运行 `comet state propose-build \u003Cchange-name> --file \u003Cconfiguration-json> --confirmed` 一次保存提案与批准；尚未决定时运行 `comet state propose-build \u003Cchange-name> --file \u003Cconfiguration-json>`。仅在仍有待决定 Wait 时，从返回的 `data.wait.proposalHash` 保存 `\u003CproposalHash>`，向用户展示实际配置并按 decision-point.md 等待确认。确认或拒绝时运行 `comet state decide-build \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Capproved|rejected>`；拒绝后从新配置重新提案。恢复已有待决定 Wait 时复用原提案，不重复提问或新建配置 Action。保存批准后简短回显并继续，不再增加一次继续确认。\n2. `full.build.plan` 待执行时，按 SDK 方法参考的 Build 章节创建或核对计划。计划引用当前 Design Doc 和 tasks.md，以 `\u003C!-- comet-task-authority: \u003Cclassic-task-authority-ref> -->` 及 `\u003C!-- comet-task-ref:\u003Ctask-id> -->` 映射任务，不能另建 checkbox。运行 `comet state submit-plan \u003Cchange-name> --plan \u003Cplan-ref>` 提交计划及证据。只有用户明确要求写完计划暂停时加 `--pause`；恢复 `plan-ready` Wait 时，必须等用户明确继续，再用该 Wait 的当前哈希运行 `comet state continue-plan \u003Cchange-name> --proposal-hash \u003CproposalHash>`。计划或任务要求变化后不复用原批准。\n3. `full.build.execute` 待执行时，按 SDK 方法参考的 Build 章节的已选方法实施、做任务级或分段审查并运行相关检查。任务实际完成且审查合格后勾选同一 tasks.md；任务 ID、勾选和协调进度使用共享参考中的 `state tasks`、`state task-complete`、`state checkpoint`；这些命令不推进 SDK Run。SDK 不调用旧 `comet handoff --write`。核对计划、任务和工作区后运行 `comet state complete-build \u003Cchange-name> --session \u003Cbuilder-execution-ref> --checks \u003Cchecks-json-file>`，由 Run 进入 Verify。实现或计划与已接受证据不一致时先解决具体漂移，不绕过 SDK 校验。\n\n每次推进后，优先使用同次结果的 `agent.continuation` \u002F `data.nextAction`；状态仍有效且信息完整时，不重复 next、select 或 check。仅在冷恢复、外部状态变化或缺少必要信息时补读。只有 `action` 且指向下一阶段时才加载下一 Skill。`decision`、`evidence`、`reconcile` 均先完成当前 Run 的恢复或用户决定。\nSDK Build 使用真实的 `--session \u003Cbuilder-execution-ref>` 关联执行；已经携带时无需再次传入。\n\n## Compat 路径\n\n以下旧 Runtime 步骤仅用于 `runtimeFormat: compat`。必须读取 [Compat 操作](reference\u002Fcompat.md)，按其中当前阶段继续；SDK 不加载该参考。\n\n## 可选变更说明\n\nBuild 收尾和 Verify 展示结果前，先核对项目 `.comet\u002Fconfig.yaml` 的 `change_walkthrough`（默认开启；仅显式 `false` 关闭）。开启时读取并执行[变更说明](..\u002Fcomet\u002Freference\u002Fchange-walkthrough.md)，用共享模板生成或更新同一 `walkthrough.html` 并给出打开链接；关闭时跳过额外讲解、详细指引和渲染，保留原有摘要。Archive 只随现有材料保存已有页面并提供实际归档链接，不补生成、不新增确认、不为页面更新重跑代码检查。\n",{"name":5,"description":7},"master","9b2c15a8cbb321ae4e36d48849676e14d90eba24","assets\u002Fskills-zh\u002Fcomet-build",314,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet","https:\u002F\u002Fdocs.comet.rpamis.com","https:\u002F\u002Fgithub.com\u002Frpamis","More Efficient, Easier to Use, and Less Annoying","2026-11-15 00:26:58",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add rpamis\u002Fcomet --skill comet-build",{"tool":38,"command":39},"bunx","bunx skills add rpamis\u002Fcomet --skill comet-build",{"tool":41,"command":42},"pnpm","pnpm dlx skills add rpamis\u002Fcomet --skill comet-build","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-build\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",211,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-build\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"reference\u002Fcompat.md",20061,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-build\u002Freference\u002Fcompat.md",[57,64,71,78,85,92],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":18},"01M72W3K6F0C2FKZ8DHABM49R7","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":18},"01M72W3HCPQ3GVMACX61QJTD4B","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M72W3F8EVD3EK4NXJG40P84K","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","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M72W3CA9YM0Y6CSXXTNCV1CA","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","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fusing-git-worktrees\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":18},"01M72W3AEH0F548GTPRNYRR3H3","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":18},"01M72W38EN8NEKX1YN4W9G19Y2","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fsystematic-debugging\u002FSKILL.md",[],[]]