mcpField
S
spec-test-bug

spec-test-bug

github.com/zixun-github测试与质量65 次安装
代码仓库

关于 spec-test-bug

spec-test-bug 是用于 verification 阶段起草结构化缺陷报告的技能,面向需要将问题提交至 Jira、禅道、Linear 或 GitHub Issue 的团队。它生成可粘贴到外部系统的报告及回写片段,不在 Spec Pack 内创建缺陷文件。

主要功能

  1. 01按模板生成缺陷报告正文
  2. 02生成 report 回写片段
  3. 03要求关联 TC-* 用例
  4. 04检查复现步骤与环境信息
  5. 05要求证据脱敏并说明交付影响

适用场景

  1. 01整理可提交到外部缺陷系统的问题报告
  2. 02把外部缺陷编号与状态回写到 report
  3. 03核对缺陷是否关联测试用例及交付阻断项

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/zixun-github/aisdlc --skill spec-test-bug

安装后在 Claude Code 中输入/spec-test-bug确认已加载。

附带文件assets/bug_report_templates.md

详细介绍

来自项目 README

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 文件)

本技能输出两部分:

  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-*
  • 已提供证据或写明缺失原因
  • 已给出对交付的影响与是否阻断

评论

支持 Markdown