SKILL.md
Spec 缺陷报告（Vx：Bug Report Drafting）
本技能用于在 verification 阶段生成 结构化缺陷报告正文（面向 Jira/禅道/Linear/GitHub Issue 等外部系统），并确保缺陷信息可以回流到 Spec Pack 的 report-*.md（作为交付阻断与风险证据）。
重要边界：
- 禁止在 Spec Pack 内新增verification/bugs/**或任何 bug 文件/目录。
- 本技能的输出主要是“对话输出”，用于粘贴到外部缺陷系统；外部缺陷创建后，需把编号/链接等信息回写到report-*.md的“缺陷清单”。
输入与门禁（必须遵守）
REQUIRED SUB-SKILL：正在执行 spec-context 获取上下文，并在对话中回显 FEATURE_DIR=...（允许 (reuse)）。
- 先定位再回写：若需要把缺陷编号/链接回写到
report-*.md，必须先通过spec-context获取FEATURE_DIR；失败即停止，禁止猜路径。 - 必读项目级 memory：
project/memory/product.md、project/memory/tech.md、project/memory/glossary.md；缺失必须写CONTEXT GAP。 - 最小事实输入（用户需提供，或从上下文提取）：
- 现象描述（实际 vs 期望） - 复现步骤（可由他人复现） - 环境信息（OS/浏览器/设备/环境/版本或构建） - 影响评估（用户影响/频率/业务影响/数据影响/安全影响） - 证据（截图/录屏/日志/网络请求摘要；可为空但需说明原因） - 关联用例编号：至少 1 条 TC-*（来自 verification/usecase.md）
输出（对话输出，不落盘 bug 文件）
本技能输出两部分：
- 缺陷报告正文（Markdown）：按模板生成，可直接粘贴到外部缺陷系统。
- Report 回写片段（Markdown）：用于粘贴到
{FEATURE_DIR}/verification/report-{date}-{version}.md的“缺陷清单 / 阻断项”区，字段包含：
- 外部缺陷编号 + 链接 + 状态 + 严重程度/优先级 - 关联 TC-* - 是否阻断交付（与 test-plan.md 的 Exit Criteria 对齐）
模板来源（强制使用）：
assets/bugreporttemplates.md
执行要点（强制）
- 标题必须具体：
[模块/能力] 在 [条件/操作] 下出现 [错误]（避免“有 bug/不行了”）。 - 复现步骤必须可执行：每一步都应具体，避免“点击按钮然后报错”。
- 环境必须可追溯：至少包含 OS、浏览器/设备、环境（Dev/Staging/Prod）与版本/构建。
- 敏感信息处理：日志/截图必须脱敏；安全类问题避免给出可直接利用的攻击代码。
- 与用例绑定：缺陷必须关联到至少一个
TC-*，否则会导致report无法可追溯。
DoD 自检
- 标题具体且可检索
- 复现步骤可由第三方复现
- 期望 vs 实际清晰
- 环境信息完整且可追溯
- 已给出 Severity / Priority
- 已关联
TC-* - 已提供证据或写明缺失原因
- 已给出对交付的影响与是否阻断