[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72VYV0750NV0SGPAN5568QT":3,"skill-same:01M72VYV0750NV0SGPAN5568QT":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},"01M72VYV0750NV0SGPAN5568QT","comet-design",null,"完成 Classic 技术设计并请用户确认。在用户调用 \u002Fcomet-design，或 Classic Runtime 进入 Design 时使用。","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-design\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: comet-design\ndescription: '完成 Classic 技术设计并请用户确认。在用户调用 \u002Fcomet-design，或 Classic Runtime 进入 Design 时使用。'\n---\n\n# Comet 阶段 2：深度设计（Design）\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` 时，只执行本节的状态命令；设计探索、提问与正式文档要求见 SDK 方法参考的 Design 章节，状态操作使用本节命令。`data.phase` 必须为 `design`；已进入 Build 时交回当前阶段入口。`data.nextAction.kind` 为 `reconcile` 时，运行 `comet state check \u003Cchange-name> design --recover --json` 核对已领取 Action 的原结果，在结果明确前停止，不重新提案或重发工作。\n\n1. 待执行 Action 为 `full.design.handoff` 时，复用当前响应的 layout 与产物引用；缺少时才运行 `comet state check \u003Cchange-name> design --json`，直接读取当前 OpenSpec proposal、tasks、delta specs 和已有 design.md 中本次设计需要的内容。按 SDK 方法参考的 Design 章节形成候选技术方案；此时还没有 SDK handoff 包，不执行旧 `comet handoff ... --write`，也不把手写摘要当作 SDK handoff。持续保存 `brainstorm-summary.md`，未确认内容标为候选。\n2. 如候选方案需要 Spec Patch，先按 SDK 方法参考的设计确认规则向用户说明具体补丁并取得明确同意，再修改 delta spec。范围发生实质变化时重新澄清。待 OpenSpec 来源稳定后，执行 `comet state propose-design \u003Cchange-name> --proposal \"\u003Ccandidate-summary>\"`，其中摘要必须覆盖将请用户确认的方案、关键取舍、风险和 Spec Patch；保存返回的 `data.wait.proposalHash` 为 `\u003CproposalHash>`。此命令生成并记录可追溯的 handoff；优先使用提案结果中的 `data.configuration.handoffContext`，缺少时再运行 `comet state next \u003Cchange-name> --json`；读取 `data.configuration.handoffContext` 对应的 Markdown 包，核对它与候选方案及当前源文件一致。用户尚未决定时，恢复应复用这个 Wait，不重复运行 propose-design。\n3. 按 `comet-classic\u002Freference\u002Fdecision-point.md` 核对当前方案与已有授权。授权覆盖时记录依据并继续；需要新决定时，先按[变化说明](..\u002Fcomet-classic\u002Freference\u002Fdecision-point.md#需求变化后的重新确认)说明影响，展示当前方案并等待答复。使用当前提案哈希执行 `comet state decide-design \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Capproved|rejected>`：已有有效批准或委托授权覆盖当前方案时填 `approved`，用户要求调整时填 `rejected` 并重新提案；暂缓时保留 Wait。来源变化使旧哈希失效时核对差异，使用当前提案记录决定，不复用过期哈希。\n4. 已批准后，按 SDK 方法参考写入唯一 Design Doc，包含要求的 frontmatter；如恢复时 `nextAction.kind` 已为 `action` 且 stepId 为 `full.design.document`，直接从这一步继续。直接运行 `comet state complete-design \u003Cchange-name> --design-doc \u003Cdesign-doc-ref> --approval-hash \u003CproposalHash>`，由同一 Run 提交文档 Action 和证据。提交失败时保留原 Run 并按具体原因处理；实际状态文件由 Runtime 同步，Agent 不手动推进 phase。成功后按同次响应的 Build Action 与 continuation 路由；缺少续行信息时才运行 `comet state next \u003Cchange-name> --json`。\n\n## Compat 路径\n\n以下旧 Runtime 步骤仅用于 `runtimeFormat: compat`。必须读取 [Compat 操作](reference\u002Fcompat.md)，按其中当前阶段继续；SDK 不加载该参考。\n","# Comet 阶段 2：深度设计（Design）\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` 时，只执行本节的状态命令；设计探索、提问与正式文档要求见 SDK 方法参考的 Design 章节，状态操作使用本节命令。`data.phase` 必须为 `design`；已进入 Build 时交回当前阶段入口。`data.nextAction.kind` 为 `reconcile` 时，运行 `comet state check \u003Cchange-name> design --recover --json` 核对已领取 Action 的原结果，在结果明确前停止，不重新提案或重发工作。\n\n1. 待执行 Action 为 `full.design.handoff` 时，复用当前响应的 layout 与产物引用；缺少时才运行 `comet state check \u003Cchange-name> design --json`，直接读取当前 OpenSpec proposal、tasks、delta specs 和已有 design.md 中本次设计需要的内容。按 SDK 方法参考的 Design 章节形成候选技术方案；此时还没有 SDK handoff 包，不执行旧 `comet handoff ... --write`，也不把手写摘要当作 SDK handoff。持续保存 `brainstorm-summary.md`，未确认内容标为候选。\n2. 如候选方案需要 Spec Patch，先按 SDK 方法参考的设计确认规则向用户说明具体补丁并取得明确同意，再修改 delta spec。范围发生实质变化时重新澄清。待 OpenSpec 来源稳定后，执行 `comet state propose-design \u003Cchange-name> --proposal \"\u003Ccandidate-summary>\"`，其中摘要必须覆盖将请用户确认的方案、关键取舍、风险和 Spec Patch；保存返回的 `data.wait.proposalHash` 为 `\u003CproposalHash>`。此命令生成并记录可追溯的 handoff；优先使用提案结果中的 `data.configuration.handoffContext`，缺少时再运行 `comet state next \u003Cchange-name> --json`；读取 `data.configuration.handoffContext` 对应的 Markdown 包，核对它与候选方案及当前源文件一致。用户尚未决定时，恢复应复用这个 Wait，不重复运行 propose-design。\n3. 按 `comet-classic\u002Freference\u002Fdecision-point.md` 核对当前方案与已有授权。授权覆盖时记录依据并继续；需要新决定时，先按[变化说明](..\u002Fcomet-classic\u002Freference\u002Fdecision-point.md#需求变化后的重新确认)说明影响，展示当前方案并等待答复。使用当前提案哈希执行 `comet state decide-design \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Capproved|rejected>`：已有有效批准或委托授权覆盖当前方案时填 `approved`，用户要求调整时填 `rejected` 并重新提案；暂缓时保留 Wait。来源变化使旧哈希失效时核对差异，使用当前提案记录决定，不复用过期哈希。\n4. 已批准后，按 SDK 方法参考写入唯一 Design Doc，包含要求的 frontmatter；如恢复时 `nextAction.kind` 已为 `action` 且 stepId 为 `full.design.document`，直接从这一步继续。直接运行 `comet state complete-design \u003Cchange-name> --design-doc \u003Cdesign-doc-ref> --approval-hash \u003CproposalHash>`，由同一 Run 提交文档 Action 和证据。提交失败时保留原 Run 并按具体原因处理；实际状态文件由 Runtime 同步，Agent 不手动推进 phase。成功后按同次响应的 Build Action 与 continuation 路由；缺少续行信息时才运行 `comet state next \u003Cchange-name> --json`。\n\n## Compat 路径\n\n以下旧 Runtime 步骤仅用于 `runtimeFormat: compat`。必须读取 [Compat 操作](reference\u002Fcompat.md)，按其中当前阶段继续；SDK 不加载该参考。\n",{"name":5,"description":7},"master","9b2c15a8cbb321ae4e36d48849676e14d90eba24","assets\u002Fskills-zh\u002Fcomet-design",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-design",{"tool":38,"command":39},"bunx","bunx skills add rpamis\u002Fcomet --skill comet-design",{"tool":41,"command":42},"pnpm","pnpm dlx skills add rpamis\u002Fcomet --skill comet-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-design\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-design\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"reference\u002Fcompat.md",13264,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-design\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",[],[]]