skills/zixun-github/aisdlc/spec-test-bug

spec-test-bug

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;失败即停止,禁止猜路径。
  • 必读项目级 memoryproject/memory/product.mdproject/memory/tech.mdproject/memory/glossary.md;缺失必须写 CONTEXT GAP
  • 最小事实输入(用户需提供,或从上下文提取):
    • 现象描述(实际 vs 期望)
    • 复现步骤(可由他人复现)
    • 环境信息(OS/浏览器/设备/环境/版本或构建)
    • 影响评估(用户影响/频率/业务影响/数据影响/安全影响)
    • 证据(截图/录屏/日志/网络请求摘要;可为空但需说明原因)
    • 关联用例编号:至少 1 条 TC-*(来自 verification/usecase.md

输出(对话输出,不落盘 bug 文件)

本技能输出两部分:

  1. 缺陷报告正文(Markdown):按模板生成,可直接粘贴到外部缺陷系统。
  2. Report 回写片段(Markdown):用于粘贴到 {FEATURE_DIR}/verification/report-{date}-{version}.md 的“缺陷清单 / 阻断项”区,字段包含:
    • 外部缺陷编号 + 链接 + 状态 + 严重程度/优先级
    • 关联 TC-*
    • 是否阻断交付(与 test-plan.md 的 Exit Criteria 对齐)

模板来源(强制使用):

  • assets/bug_report_templates.md

执行要点(强制)

  • 标题必须具体[模块/能力] 在 [条件/操作] 下出现 [错误](避免“有 bug/不行了”)。
  • 复现步骤必须可执行:每一步都应具体,避免“点击按钮然后报错”。
  • 环境必须可追溯:至少包含 OS、浏览器/设备、环境(Dev/Staging/Prod)与版本/构建。
  • 敏感信息处理:日志/截图必须脱敏;安全类问题避免给出可直接利用的攻击代码。
  • 与用例绑定:缺陷必须关联到至少一个 TC-*,否则会导致 report 无法可追溯。

DoD 自检

  • 标题具体且可检索
  • 复现步骤可由第三方复现
  • 期望 vs 实际清晰
  • 环境信息完整且可追溯
  • 已给出 Severity / Priority
  • 已关联 TC-*
  • 已提供证据或写明缺失原因
  • 已给出对交付的影响与是否阻断
Weekly Installs
35
GitHub Stars
1
First Seen
11 days ago
Installed on
claude-code34
cursor34
gemini-cli7
github-copilot7
codex7
kimi-cli7