메뉴
拿到 bug ID、ZenTao bug URL（zenpms.dtstack.cn/zentao/bug-view-NNN.html）、缺陷描述或修复说明，产出聚焦修复路径、可直接执行的单条 hotfix 回归用例（archive.md）。仅发送 bug-view-NNN URL 或 bug ID 即可直接触发，无需附带文字说明。要基于失败证据写通用 bug 报告请转至 defect-analyze；依完整 PRD 产用例请转至 case-draft。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
收到异常堆栈/控制台报错/HTTP 失败、带合并冲突标记的文本，或代码 diff/分支对，做根因分诊、冲突解决或静态缺陷扫描。已登记的 ZenTao bug URL/ID 改用 case-hotfix。
把需求用例目录路径/目录名（features/【v...】）、MD 用例、PRD、Lanhu、Playwright 脚本或运行失败结果，转为或修复为可真实跑通的 UI 自动化。仅发送一个需求功能目录路径或目录名即可直接触发（目录→自动化；用例产物文件→case-edit）。仅手动操作浏览器、仅写非 UI 用例请转至 case-draft；仅做静态扫描请转至 defect-analyze。
拿到既有用例产物文件(.xmind/.csv/archive.md)路径，编辑、同步、归档、标准化或在 Archive·XMind·CSV 间转换，语义不变是底线。依 PRD/需求源产新用例改用 case-draft；只给需求功能目录路径/目录名改用 playwright-automation。
依 Lanhu/Axure 链接(lanhuapp.com，含 axure/产品设计 URL)、Markdown PRD、设计稿、截图、fixture 或功能描述等需求源，生成、扩写或复核 QA 测试用例，产出 archive.md + cases.xmind。仅发送一条 Lanhu/Axure 链接即可直接触发，无需附带文字说明。仅做 Archive/XMind/CSV 格式转换请转至 case-edit；基于已有用例做自动化请转至 playwright-automation；单条 bug 记录（bug ID / ZenTao bug URL bug-view-NNN）请转至 case-hotfix。
出现数据源/数据库/服务器连通性报错(如 JDBC No route to host、连接超时或被拒)，SSH 登录只读排查并修复，并记录凭据与排查知识。纯前端运行时报错且无需 SSH 登录改用 defect-analyze；只查改业务知识改用 knowledge-curate。
查询、记录或维护项目业务知识、规则、术语、模块事实，或问「XX 是什么」(项目业务概念)，统一记录于 _shared/knowledge/。触发短语如「记一下这个规则」「XX 术语什么意思」「更新模块知识」。只问源码实现细节，或需要编写用例、扫描 diff、做 UI 自动化，请转至对应 case-*/defect-analyze/playwright-automation。
| name | case-hotfix |
| description | 拿到 bug ID、ZenTao bug URL（zenpms.dtstack.cn/zentao/bug-view-NNN.html）、缺陷描述或修复说明，产出聚焦修复路径、可直接执行的单条 hotfix 回归用例（archive.md）。仅发送 bug-view-NNN URL 或 bug ID 即可直接触发，无需附带文字说明。要基于失败证据写通用 bug 报告请转至 defect-analyze；依完整 PRD 产用例请转至 case-draft。 |
| argument-hint | <ZenTao bug URL | bug-view-NNN | bug ID> |
| user-invocable | true |
| model | sonnet |
| effort | medium |
以 bug 记录为输入，产出一条聚焦修复路径、可直接执行的 hotfix 回归用例；范围只锁定这次修复，不外延成完整功能用例集。
以下场景不属本 skill 范围，请转至对应 skill：
bun run .claude/plugins/zentao/fetch.ts --bug-id <id> --output <hotfix>/.temp（cookie 优先、失效自动登录）抓取 bug 证据；从返回 JSON 的 fields/sections/history 定位修复路径与受影响页面、字段。references/hotfix-archive-format.md（目录、frontmatter keywords、前置条件 SQL、Spark 边界等全部细则）；涉及表单、规则配置、菜单路径或多子项步骤时，同步读 .claude/prompt/_shared/case-format-sample.md 头注释，继承 case-draft 的步骤可读性规则。.claude/prompt/_shared/case-qa.md 自审，且人工检查步骤是否像正式用例一样明确、可读、可逐项执行。| 文件 | 何时读 | 作用 |
|---|---|---|
| references/hotfix-archive-format.md | 写或复核 archive 前 | 目录/frontmatter/keywords/前置条件 SQL/Spark 全分区等可执行格式 |
| .claude/prompt/_shared/case-format-sample.md | 写含表单/规则配置/多子项步骤的 archive 前 | 继承 case-draft 内容质量规则：步骤单页面、子项换行、预期编号、表单字段逐项列出 |
| .claude/prompt/_shared/case-qa.md | 交付前自审（共享引用） | Archive 字段一致性、标题、前置条件可执行性、表单逐字匹配 |
pending_items，不得外延到无证据支撑的模块、数据源或版本。archive.md（含前置条件与步骤表），不得只给缺陷分析、原因说明或自然语言总结。- 列表项并用 <br> 分行；多条预期用 1) 2) N) 分行，确保 QA 可逐项执行和核对。source_refs.json 的 user.feedback@N。zentao_url；目录命名 hotfix_{fix_branch_or_bug_id}-{short-title}；keywords 六段式、前置条件 SQL/Spark 写法等细则严格按 references/hotfix-archive-format.md，此处不再赘述。kata archive-gen validate --input <hotfix-dir>/archive.md 校验结构与 frontmatter，修复所有 violation 后再做人工自审。hotfix archive 落在 _shared/archive/issues/，位于 features/ 之外，kata cases lint 扫不到，故用 archive-gen validate。SourceRef 泄漏校验 archive-gen validate 不覆盖，需人工 grep 确认 source_refs.json 之外正文无结构化证据（SourceRefs、bug.record@N）。source_refs.json 中标明来源和未验证边界，不得当作本次真实探测结果。archive.md 只保留人类可读的用例内容，不含任何 SourceRef 引用。source_refs.json。.temp/，不写入仓库根 workspace/.temp，也不写入 .kata。