[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72VYJM81MJ1TP15SH8M4WHW":3,"skill-same:01M72VYJM81MJ1TP15SH8M4WHW":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},"01M72VYJM81MJ1TP15SH8M4WHW","comet-archive",null,"归档并交付 Classic change。在用户调用 \u002Fcomet-archive，或 Classic Runtime 进入 Archive、恢复交付时使用。","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-archive\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: comet-archive\ndescription: '归档并交付 Classic change。在用户调用 \u002Fcomet-archive，或 Classic Runtime 进入 Archive、恢复交付时使用。'\n---\n\n# Comet 阶段 5：归档（Archive）\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首次进入当前 SDK 阶段、换 Agent 或恢复上下文时，读取[阶段入口与恢复](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#阶段入口与恢复)及该参考的当前阶段章节；本会话已有且仍有效时直接复用。下文按当前阶段执行；`nextAction.kind` 的恢复路由只适用于没有 continuation mode 的旧响应。\n\n优先复用同一 change、工作区和 Run 的最新有效响应中的 `agent.continuation`、`data.nextAction`、phase、revision 和路径摘要。只有冷恢复、工作区或外部状态变化、响应版本已过期或缺少当前步骤必要信息时，才运行 `comet state next \u003Cchange-name> --json`；不要因加载下一 Skill 再读一次。后续写操作仍由 Runtime 校验当前版本与证据，不能用缓存跳过检查或批准。确认 `data.runtimeFormat: sdk`、phase 和 `nextAction.kind`，在已绑定的 `projectRoot` 执行；路径缺失或绑定发生变化时才运行 `comet classic workspace resolve \u003Cchange-name> --json`。SDK Run 的 Verify 收据必须仍有效；状态文件和验证报告存在并不表示已获归档授权。`reconcile` 时运行 `comet state check \u003Cchange-name> archive --recover --json` 核对原 Action 与磁盘、Git 证据，结果未明时不重做归档、提交、push 或 PR。\n\n1. 复用当前有效的状态、工作区和证据摘要；缺少时运行 `comet state check \u003Cchange-name> archive --json`。按 SDK 方法参考的 Archive 与 Git 交付章节 核对验证结论、当前绑定分支、归档影响和无关改动。需要推送或 PR 时，先确认 remote 和 PR base；多个可选目标不能猜测。用当前目标与效果摘要运行 `comet state propose-archive \u003Cchange-name> --summary \"\u003Cdelivery-summary>\"`，需要时附 `--remote \u003Cname>`、`--pr-base \u003Cbranch>`。保存返回的 `data.wait.proposalHash` 为 `\u003CproposalHash>`；恢复已有待决定 Wait 时复用它，不重复提案。\n2. 按 decision-point.md 展示当前提案和 SDK 方法参考的 Archive 与 Git 交付选项。已有明确授权覆盖当前归档影响和相同交付目标时沿用；否则等待用户选择。用 `comet state decide-archive \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Clocal|push|pr|reverify|later>` 提交当前选择：local 仅归档并提交，push 再推送，pr 推送并创建 PR，reverify 返回 Verify，later 保留当前工作并停止本次调用。目标或 Verify 证据改变时重新核对并取得新的决定；旧提案哈希不能继续使用。\n3. 只有 Run 记录了有效的 `local|push|pr` 决定，才直接运行 `comet guard \u003Cchange-name> archive --apply`。Guard 核对授权、分支和 Verify 收据，在同一 Run 中完成一次 OpenSpec 归档。中断后先看 `state next --json` 与 `--recover` 返回的 Action；已应用的归档不能再次发送。\n4. 按 SDK 方法参考的 Archive 与 Git 交付章节核对 dirty-worktree，显式暂存本 change 的实现、归档目录、主 spec 及 Design Doc\u002FPlan 标注，检查 staged diff，再创建唯一归档提交。SDK Guard 不代替 Agent 执行 Git；不调用旧 `state set branch_status`、`state delivery` 或 `archive-confirm`。选择 `push` 时推送已批准的 remote\u002F分支；选择 `pr` 时先推送再创建目标匹配的 PR。调用结果未知时先只读核对远端或 PR，不盲目重试。\n5. 使用真实提交 SHA 运行 `comet state complete-delivery \u003Cchange-name> --commit \u003Csha>`；PR 选择还需附 `--pr-url \u003Curl>`。该命令只核对归档提交及已批准的远端\u002FPR 结果并结束 Run，不执行提交、push 或建 PR。验证失败时保留原 Run 与选择，按返回的具体缺口恢复；只有同次结果表明 Run 已完成且 continuation 为 done，才宣告交付完成；结果未提供终态时才运行 `comet state next \u003Cchange-name> --json` 核对。\n\n## Compat 路径\n\n以下旧 Runtime 步骤仅用于 `runtimeFormat: compat`。必须读取 [Compat 操作](reference\u002Fcompat.md)，按其中当前阶段继续；SDK 不加载该参考。\n\n项目 `change_walkthrough` 默认开启，已有 `walkthrough.html` 随 change 材料归档，完成回复给出实际归档文件的打开链接；关闭时也保留已有页面。缺页不补生成、不阻塞归档，不为展示增加检查、阶段或确认。\n","# Comet 阶段 5：归档（Archive）\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首次进入当前 SDK 阶段、换 Agent 或恢复上下文时，读取[阶段入口与恢复](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#阶段入口与恢复)及该参考的当前阶段章节；本会话已有且仍有效时直接复用。下文按当前阶段执行；`nextAction.kind` 的恢复路由只适用于没有 continuation mode 的旧响应。\n\n优先复用同一 change、工作区和 Run 的最新有效响应中的 `agent.continuation`、`data.nextAction`、phase、revision 和路径摘要。只有冷恢复、工作区或外部状态变化、响应版本已过期或缺少当前步骤必要信息时，才运行 `comet state next \u003Cchange-name> --json`；不要因加载下一 Skill 再读一次。后续写操作仍由 Runtime 校验当前版本与证据，不能用缓存跳过检查或批准。确认 `data.runtimeFormat: sdk`、phase 和 `nextAction.kind`，在已绑定的 `projectRoot` 执行；路径缺失或绑定发生变化时才运行 `comet classic workspace resolve \u003Cchange-name> --json`。SDK Run 的 Verify 收据必须仍有效；状态文件和验证报告存在并不表示已获归档授权。`reconcile` 时运行 `comet state check \u003Cchange-name> archive --recover --json` 核对原 Action 与磁盘、Git 证据，结果未明时不重做归档、提交、push 或 PR。\n\n1. 复用当前有效的状态、工作区和证据摘要；缺少时运行 `comet state check \u003Cchange-name> archive --json`。按 SDK 方法参考的 Archive 与 Git 交付章节 核对验证结论、当前绑定分支、归档影响和无关改动。需要推送或 PR 时，先确认 remote 和 PR base；多个可选目标不能猜测。用当前目标与效果摘要运行 `comet state propose-archive \u003Cchange-name> --summary \"\u003Cdelivery-summary>\"`，需要时附 `--remote \u003Cname>`、`--pr-base \u003Cbranch>`。保存返回的 `data.wait.proposalHash` 为 `\u003CproposalHash>`；恢复已有待决定 Wait 时复用它，不重复提案。\n2. 按 decision-point.md 展示当前提案和 SDK 方法参考的 Archive 与 Git 交付选项。已有明确授权覆盖当前归档影响和相同交付目标时沿用；否则等待用户选择。用 `comet state decide-archive \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Clocal|push|pr|reverify|later>` 提交当前选择：local 仅归档并提交，push 再推送，pr 推送并创建 PR，reverify 返回 Verify，later 保留当前工作并停止本次调用。目标或 Verify 证据改变时重新核对并取得新的决定；旧提案哈希不能继续使用。\n3. 只有 Run 记录了有效的 `local|push|pr` 决定，才直接运行 `comet guard \u003Cchange-name> archive --apply`。Guard 核对授权、分支和 Verify 收据，在同一 Run 中完成一次 OpenSpec 归档。中断后先看 `state next --json` 与 `--recover` 返回的 Action；已应用的归档不能再次发送。\n4. 按 SDK 方法参考的 Archive 与 Git 交付章节核对 dirty-worktree，显式暂存本 change 的实现、归档目录、主 spec 及 Design Doc\u002FPlan 标注，检查 staged diff，再创建唯一归档提交。SDK Guard 不代替 Agent 执行 Git；不调用旧 `state set branch_status`、`state delivery` 或 `archive-confirm`。选择 `push` 时推送已批准的 remote\u002F分支；选择 `pr` 时先推送再创建目标匹配的 PR。调用结果未知时先只读核对远端或 PR，不盲目重试。\n5. 使用真实提交 SHA 运行 `comet state complete-delivery \u003Cchange-name> --commit \u003Csha>`；PR 选择还需附 `--pr-url \u003Curl>`。该命令只核对归档提交及已批准的远端\u002FPR 结果并结束 Run，不执行提交、push 或建 PR。验证失败时保留原 Run 与选择，按返回的具体缺口恢复；只有同次结果表明 Run 已完成且 continuation 为 done，才宣告交付完成；结果未提供终态时才运行 `comet state next \u003Cchange-name> --json` 核对。\n\n## Compat 路径\n\n以下旧 Runtime 步骤仅用于 `runtimeFormat: compat`。必须读取 [Compat 操作](reference\u002Fcompat.md)，按其中当前阶段继续；SDK 不加载该参考。\n\n项目 `change_walkthrough` 默认开启，已有 `walkthrough.html` 随 change 材料归档，完成回复给出实际归档文件的打开链接；关闭时也保留已有页面。缺页不补生成、不阻塞归档，不为展示增加检查、阶段或确认。\n",{"name":5,"description":7},"master","9b2c15a8cbb321ae4e36d48849676e14d90eba24","assets\u002Fskills-zh\u002Fcomet-archive",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-archive",{"tool":38,"command":39},"bunx","bunx skills add rpamis\u002Fcomet --skill comet-archive",{"tool":41,"command":42},"pnpm","pnpm dlx skills add rpamis\u002Fcomet --skill comet-archive","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-archive\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",199,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-archive\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"reference\u002Fcompat.md",16204,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-archive\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",[],[]]