[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72VZ70KBHR7M8HAEAYNVFER":3,"skill-same:01M72VZ70KBHR7M8HAEAYNVFER":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},"01M72VZ70KBHR7M8HAEAYNVFER","comet-tweak",null,"使用 Classic 预设流程完成单个 change 的轻量调整。在用户明确调用 \u002Fcomet-tweak、选择 tweak，或恢复 workflow: tweak 时使用。","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-tweak\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: comet-tweak\ndescription: '使用 Classic 预设流程完成单个 change 的轻量调整。在用户明确调用 \u002Fcomet-tweak、选择 tweak，或恢复 workflow: tweak 时使用。'\n---\n\n# Comet 预设路径：Tweak\n\n开始或恢复任务前，必须先读取并遵守 `comet-classic\u002Freference\u002Fclassic-layout.md`。本文件中的 OpenSpec CLI 调用必须通过适配器执行，文件路径必须基于该协议绑定的 `\u003Cclassic-*>` 逻辑根目录。\n\nTweak 为 Comet 五阶段流程提供一组预设配置。它通过 OpenSpec 完成需求与实施工作，复用 open、build、verify、archive 阶段，跳过 Superpowers brainstorming 和完整实施计划，不另建一套独立流程。\n\n适用于配置调整、文档或提示词优化等轻量改动，也适用于需要依据 spec（含 delta spec）实施、但不需要完整 `\u002Fcomet-classic` 深度设计的中等变更。Tweak 正常支持 delta spec，不能仅因为需要 delta spec 就要求升级流程。\n\n**适用条件**（必须全部满足）：\n\n1. 可以在**单个 OpenSpec change** 中完成\n2. 无需通过 Superpowers Design Doc 和完整实施计划，就能明确方案\n3. 不涉及跨模块、跨层级的架构协调\n4. 任务规模可预估（文件数和任务数仅作提示，不会自动要求升级，见 SDK 方法参考的预设范围复核）\n\n**不适用**：变更过程中如发现 SDK 方法参考的预设范围复核列出的变化，需要由用户决定是否改用完整 `\u002Fcomet-classic` 流程。\n\n首次进入阶段、交接给新 Agent 或上下文恢复后，读取并执行 [任务上下文与产物语言](..\u002Fcomet-classic\u002Freference\u002Fscripts.md#任务上下文与产物语言)，优先采用当前 continuation 或已领取 Action 的 `contextRequest`；同一阶段连续执行不重复获取。\n\n个人记忆只保存可复用用户信息，不写入任务摘要、进展、命令输出或测试结果。\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` 及已绑定的 change、工作区、phase 和 Run revision，按已知的 `data.runtimeFormat` 路由。只有冷恢复、外部状态变化或缺少这些信息时，才运行 `comet state next \u003Cchange-name> --json`。`sdk` 只按本节推进；SDK 方法参考的适用条件、OpenSpec apply 方法、升级判定和文件数授权规则仍适用，状态与证据通过本节命令提交。若 `nextAction.kind` 为 `reconcile`，运行 `comet state check \u003Cchange-name> \u003Cphase> --recover --json` 核对原 Action；结果未明时不重做实现、检查或归档。\n\n1. 新建时先按 [工作区选择](..\u002Fcomet-classic\u002Freference\u002Fworkspace.md) 确定隔离方式，运行 `comet classic workspace prepare \u003Cname> --isolation \u003Cselected-isolation> --json`，进入返回的 `projectRoot`，先按 [开始与产物](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#开始与产物) 创建 OpenSpec 基础目录，再运行 `comet state init \u003Cname> tweak --isolation \u003Cselected-isolation>`，随后运行 `comet state select \u003Cname>` 绑定 Hook 路由。按 SDK 方法参考的开始与产物章节创建 OpenSpec 产物，包括本次确需的 delta spec；运行 `comet guard \u003Cchange-name> open --json` 预览确认内容，保存返回的 `data.approvalHash`。向用户展示本次 Open 产物与范围，获得明确批准后，运行 `comet guard \u003Cchange-name> open --apply --approval-hash \u003CapprovalHash>`。产物变化后必须重新预览并确认，不复用旧哈希。只有 Run 进入 Build，Open 才完成。\n2. `tweak.build.execute` 待执行时，沿用本次 change、工作区和 Run，直接恢复 Build，不重新初始化或重跑 Open。按 SDK 方法参考的预设范围复核章节的 OpenSpec apply 方法读取指令与上下文，逐项实施并勾选同一 tasks.md。出现实质升级信号或文件数超限且无有效授权时，先运行 `comet state propose-escalation \u003Cchange-name> --reason \"\u003Creason>\"`；向用户展示当前原因和继续 tweak \u002F 升级 full 的影响，并保存返回的 `data.wait.proposalHash`。用户明确选择后运行 `comet state decide-escalation \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Ccontinue|upgrade>`。`continue` 仍须满足 SDK 方法参考的范围、风险与 ruling 要求；`upgrade` 在同一个 Run 和工作区进入 full Design，立即按入口加载 comet-design。恢复待决定 Wait 时复用原提案，不重新提案或替用户选。\n3. 所有任务完成、必要检查与审查完成且仍适合当前预设时，运行 `comet state complete-build \u003Cchange-name> --session \u003Cbuilder-execution-ref> --checks \u003Cchecks-json-file>` 提交实际结果。此处没有新的用户决定；Runtime 核对当前任务、配置、工作区和报告后进入 Verify。失败或结果未明时按返回的当前 Action 核对原任务，不重复执行。\n4. Run 进入 Verify 时，**立即执行：** 使用 Skill 工具加载 comet-verify 技能。禁止跳过此步骤。若有 delta spec，按 SDK 方法参考的完整验证方法覆盖其一致性，不调用旧 `state set verify_mode`。Run 进入 Archive 时，**立即执行：** 使用 Skill 工具加载 comet-archive 技能。禁止跳过此步骤。归档和交付仍须获得用户当前授权；当前成功结果显示 Run 完成后才能宣告完成；缺少完成状态时再读 `state next --json`。\n\n每次推进后，优先使用同次结果的 `agent.continuation` \u002F `data.nextAction`；状态仍有效且信息完整时，不重复 next、select 或 check。仅在冷恢复、外部状态变化或缺少必要信息时补读。`decision`、`evidence`、`reconcile` 先处理当前 Run 的等待或恢复；`action` 才执行对应步骤。\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 预设路径：Tweak\n\n开始或恢复任务前，必须先读取并遵守 `comet-classic\u002Freference\u002Fclassic-layout.md`。本文件中的 OpenSpec CLI 调用必须通过适配器执行，文件路径必须基于该协议绑定的 `\u003Cclassic-*>` 逻辑根目录。\n\nTweak 为 Comet 五阶段流程提供一组预设配置。它通过 OpenSpec 完成需求与实施工作，复用 open、build、verify、archive 阶段，跳过 Superpowers brainstorming 和完整实施计划，不另建一套独立流程。\n\n适用于配置调整、文档或提示词优化等轻量改动，也适用于需要依据 spec（含 delta spec）实施、但不需要完整 `\u002Fcomet-classic` 深度设计的中等变更。Tweak 正常支持 delta spec，不能仅因为需要 delta spec 就要求升级流程。\n\n**适用条件**（必须全部满足）：\n\n1. 可以在**单个 OpenSpec change** 中完成\n2. 无需通过 Superpowers Design Doc 和完整实施计划，就能明确方案\n3. 不涉及跨模块、跨层级的架构协调\n4. 任务规模可预估（文件数和任务数仅作提示，不会自动要求升级，见 SDK 方法参考的预设范围复核）\n\n**不适用**：变更过程中如发现 SDK 方法参考的预设范围复核列出的变化，需要由用户决定是否改用完整 `\u002Fcomet-classic` 流程。\n\n首次进入阶段、交接给新 Agent 或上下文恢复后，读取并执行 [任务上下文与产物语言](..\u002Fcomet-classic\u002Freference\u002Fscripts.md#任务上下文与产物语言)，优先采用当前 continuation 或已领取 Action 的 `contextRequest`；同一阶段连续执行不重复获取。\n\n个人记忆只保存可复用用户信息，不写入任务摘要、进展、命令输出或测试结果。\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` 及已绑定的 change、工作区、phase 和 Run revision，按已知的 `data.runtimeFormat` 路由。只有冷恢复、外部状态变化或缺少这些信息时，才运行 `comet state next \u003Cchange-name> --json`。`sdk` 只按本节推进；SDK 方法参考的适用条件、OpenSpec apply 方法、升级判定和文件数授权规则仍适用，状态与证据通过本节命令提交。若 `nextAction.kind` 为 `reconcile`，运行 `comet state check \u003Cchange-name> \u003Cphase> --recover --json` 核对原 Action；结果未明时不重做实现、检查或归档。\n\n1. 新建时先按 [工作区选择](..\u002Fcomet-classic\u002Freference\u002Fworkspace.md) 确定隔离方式，运行 `comet classic workspace prepare \u003Cname> --isolation \u003Cselected-isolation> --json`，进入返回的 `projectRoot`，先按 [开始与产物](..\u002Fcomet-classic\u002Freference\u002Fsdk-methods.md#开始与产物) 创建 OpenSpec 基础目录，再运行 `comet state init \u003Cname> tweak --isolation \u003Cselected-isolation>`，随后运行 `comet state select \u003Cname>` 绑定 Hook 路由。按 SDK 方法参考的开始与产物章节创建 OpenSpec 产物，包括本次确需的 delta spec；运行 `comet guard \u003Cchange-name> open --json` 预览确认内容，保存返回的 `data.approvalHash`。向用户展示本次 Open 产物与范围，获得明确批准后，运行 `comet guard \u003Cchange-name> open --apply --approval-hash \u003CapprovalHash>`。产物变化后必须重新预览并确认，不复用旧哈希。只有 Run 进入 Build，Open 才完成。\n2. `tweak.build.execute` 待执行时，沿用本次 change、工作区和 Run，直接恢复 Build，不重新初始化或重跑 Open。按 SDK 方法参考的预设范围复核章节的 OpenSpec apply 方法读取指令与上下文，逐项实施并勾选同一 tasks.md。出现实质升级信号或文件数超限且无有效授权时，先运行 `comet state propose-escalation \u003Cchange-name> --reason \"\u003Creason>\"`；向用户展示当前原因和继续 tweak \u002F 升级 full 的影响，并保存返回的 `data.wait.proposalHash`。用户明确选择后运行 `comet state decide-escalation \u003Cchange-name> --proposal-hash \u003CproposalHash> --choice \u003Ccontinue|upgrade>`。`continue` 仍须满足 SDK 方法参考的范围、风险与 ruling 要求；`upgrade` 在同一个 Run 和工作区进入 full Design，立即按入口加载 comet-design。恢复待决定 Wait 时复用原提案，不重新提案或替用户选。\n3. 所有任务完成、必要检查与审查完成且仍适合当前预设时，运行 `comet state complete-build \u003Cchange-name> --session \u003Cbuilder-execution-ref> --checks \u003Cchecks-json-file>` 提交实际结果。此处没有新的用户决定；Runtime 核对当前任务、配置、工作区和报告后进入 Verify。失败或结果未明时按返回的当前 Action 核对原任务，不重复执行。\n4. Run 进入 Verify 时，**立即执行：** 使用 Skill 工具加载 comet-verify 技能。禁止跳过此步骤。若有 delta spec，按 SDK 方法参考的完整验证方法覆盖其一致性，不调用旧 `state set verify_mode`。Run 进入 Archive 时，**立即执行：** 使用 Skill 工具加载 comet-archive 技能。禁止跳过此步骤。归档和交付仍须获得用户当前授权；当前成功结果显示 Run 完成后才能宣告完成；缺少完成状态时再读 `state next --json`。\n\n每次推进后，优先使用同次结果的 `agent.continuation` \u002F `data.nextAction`；状态仍有效且信息完整时，不重复 next、select 或 check。仅在冷恢复、外部状态变化或缺少必要信息时补读。`decision`、`evidence`、`reconcile` 先处理当前 Run 的等待或恢复；`action` 才执行对应步骤。\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-tweak",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-tweak",{"tool":38,"command":39},"bunx","bunx skills add rpamis\u002Fcomet --skill comet-tweak",{"tool":41,"command":42},"pnpm","pnpm dlx skills add rpamis\u002Fcomet --skill comet-tweak","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-tweak\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",198,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-tweak\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"reference\u002Fcompat.md",20237,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Fassets\u002Fskills-zh\u002Fcomet-tweak\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",[],[]]