spec-test-bug
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/bug_report_templates.md
执行要点(强制)
- 标题必须具体:
[模块/能力] 在 [条件/操作] 下出现 [错误](避免“有 bug/不行了”)。 - 复现步骤必须可执行:每一步都应具体,避免“点击按钮然后报错”。
- 环境必须可追溯:至少包含 OS、浏览器/设备、环境(Dev/Staging/Prod)与版本/构建。
- 敏感信息处理:日志/截图必须脱敏;安全类问题避免给出可直接利用的攻击代码。
- 与用例绑定:缺陷必须关联到至少一个
TC-*,否则会导致report无法可追溯。
DoD 自检
- 标题具体且可检索
- 复现步骤可由第三方复现
- 期望 vs 实际清晰
- 环境信息完整且可追溯
- 已给出 Severity / Priority
- 已关联
TC-* - 已提供证据或写明缺失原因
- 已给出对交付的影响与是否阻断
More from zixun-github/aisdlc
spec-product-prd
Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R2,将 requirements/solution.md 转写为可交付、可验收、可测试的 requirements/prd.md,且需要避免猜路径、在缺少 solution.md 时仍继续生成、或用“待确认问题/Open Questions”替代验证清单。
126spec-product-prototype
Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R3(原型生成),基于 requirements/prd.md 产出 requirements/prototype.md(任务流+页面结构+ASCII线框+AC映射+走查脚本),并避免缺少上下文/缺少 PRD 仍继续生成、用 Open Questions 代替验证清单、或用非 ASCII 方式导致原型不可追溯与不可评审。
121subagent-driven-development
Use when executing implementation plans with independent tasks in the current session
109spec-product-demo
Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R4(基于 requirements/prototype.md 生成可交互 Demo 工程),并需要避免跳过 spec-context、在缺少 prototype.md 或缺少可运行 Demo 工程根目录时仍继续、或自创页面/目录导致不可追溯与无法回流闭环。
109spec-receiving-code-review
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
108using-aisdlc
Use when 需要在 sdlc-dev 仓库执行 AI SDLC(Spec Pack)流程、选择/串联需求侧(raw/solution/prd/prototype/demo)与实现侧(plan/execute/finishing)技能,并用门禁避免上下文漂移、写错目录或在压力下跳过关键步骤。
107