使用 Classic 预设流程修复局部缺陷。在用户明确调用 /comet-hotfix、选择 hotfix,或恢复 workflow: hotfix 时使用。
79%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./assets/skills-zh/comet-hotfix/SKILL.md开始或恢复任务前,必须先读取并遵守 comet-classic/reference/classic-layout.md。本文件中的 OpenSpec CLI 调用必须通过适配器执行,文件路径必须基于该协议绑定的 <classic-*> 逻辑根目录。
快速缺陷修复流程:open → build → 根因消除检查 → verify → archive。跳过 brainstorming 和完整实施计划,适用于修复已有行为、不需要设计新功能的场景。
适用条件(必须全部满足):
不适用:修复过程中如发现 SDK 方法参考的预设范围复核列出的变化,需要由用户决定是否改用完整 /comet-classic 流程。
首次进入阶段、交接给新 Agent 或上下文恢复后,读取并执行 任务上下文与产物语言,优先采用当前 continuation 或已领取 Action 的 contextRequest;同一阶段连续执行不重复获取。
个人记忆只保存可复用用户信息,不写入任务摘要、进展、命令输出或测试结果。
先读取并执行普通命令与检查。新旧 Run 均使用平台工具执行普通命令,在原 Run 提交实际检查报告;自动升级不恢复旧检查执行器。阶段准备、用户选择、任务完成和验收要求继续有效。
首次进入当前 SDK 阶段、换 Agent 或恢复上下文时,读取阶段入口与恢复及该参考的当前阶段章节;本会话已有且仍有效时直接复用。下文按当前阶段执行;nextAction.kind 的恢复路由只适用于没有 continuation mode 的旧响应。
开始或恢复时,优先复用当前有效结果中的 agent.continuation / data.nextAction 及已绑定的 change、工作区、phase 和 Run revision,按已知的 data.runtimeFormat 路由。只有冷恢复、外部状态变化或缺少这些信息时,才运行 comet state next <change-name> --json。sdk 只按本节推进;SDK 方法参考的适用条件、复现与根因消除方法、升级判定和文件数授权规则仍适用,状态与证据通过本节命令提交。若 nextAction.kind 为 reconcile,运行 comet state check <change-name> <phase> --recover --json 核对原 Action;结果未明时不重做实现、检查或归档。
comet classic workspace prepare <name> --isolation <selected-isolation> --json,进入返回的 projectRoot,先按 开始与产物 创建 OpenSpec 基础目录,再运行 comet state init <name> hotfix --isolation <selected-isolation>,随后运行 comet state select <name> 绑定 Hook 路由。按 SDK 方法参考的开始与产物章节创建精简版 OpenSpec 产物;运行 comet guard <change-name> open --json 预览确认内容,保存返回的 data.approvalHash。向用户展示本次 Open 产物与范围,获得明确批准后,运行 comet guard <change-name> open --apply --approval-hash <approvalHash>。产物变化后必须重新预览并确认,不复用旧哈希。只有 Run 进入 Build,Open 才完成;状态文件是 change 下的 comet-state.yaml,历史 change 沿用原文件名。hotfix.build.execute 待执行时,沿用本次 change、工作区和 Run,直接恢复 Build,不重新初始化或重跑 Open。按 SDK 方法参考的预设范围复核章节 先复现缺陷、保存失败证据、完成任务并核对根因。出现实质升级信号或文件数超限且无有效授权时,先运行 comet state propose-escalation <change-name> --reason "<reason>";向用户展示当前原因和继续 hotfix / 升级 full 的影响,并保存返回的 data.wait.proposalHash。用户明确选择后运行 comet state decide-escalation <change-name> --proposal-hash <proposalHash> --choice <continue|upgrade>。continue 仍须满足 SDK 方法参考的范围、风险与 ruling 要求;upgrade 在同一个 Run 和工作区进入 full Design,立即按入口加载 comet-design。恢复待决定 Wait 时复用原提案,不重新提案或替用户选。comet state complete-build <change-name> --session <builder-execution-ref> --checks <checks-json-file> 提交实际结果。此处没有新的用户决定;Runtime 核对当前任务、配置、工作区和报告后进入 Verify。失败或结果未明时按返回的当前 Action 核对原任务,不重复执行。state next --json。每次推进后,优先使用同次结果的 agent.continuation / data.nextAction;状态仍有效且信息完整时,不重复 next、select 或 check。仅在冷恢复、外部状态变化或缺少必要信息时补读。decision、evidence、reconcile 先处理当前 Run 的等待或恢复;action 才执行对应步骤。
SDK Build 使用真实的 --session <builder-execution-ref> 关联执行;已经携带时无需再次传入。
以下旧 Runtime 步骤仅用于 runtimeFormat: compat。必须读取 Compat 操作,按其中当前阶段继续;SDK 不加载该参考。
Build 收尾和 Verify 展示结果前,先核对项目 .comet/config.yaml 的 change_walkthrough(默认开启;仅显式 false 关闭)。开启时读取并执行变更说明,用共享模板生成或更新同一 walkthrough.html 并给出打开链接;关闭时跳过额外讲解、详细指引和渲染,保留原有摘要。Archive 只随现有材料保存已有页面并提供实际归档链接,不补生成、不新增确认、不为页面更新重跑代码检查。
rpamis/comet
d31d310
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.