qa-bug-reporting
Skill31 starsChanged 48 days agoMITView on GitHub
当发现了一个 Bug 需要提交、自己提的 Bug 被开发打回来了、或者团队 Bug 质量参差不齐需要统一规范时使用此技能。一个高质量的 Bug 报告应该让开发看一遍就能复现并定位,不需要来回追问。包含清晰的复现步骤(从环境准备到操作序列到预期/实际结果)、根因推测、影响范围评估和必要附件。 ⚠️ 本技能示例可能调用外部抓包/日志工具,请在受控环境执行。 触发场景:提Bug、写Bug报告、Bug描述、报告格式、复现步骤、加附件、开发打回Bug报告需要改进时。 Use when the user asks about: writing a bug report an engineer can reproduce without asking follow-up questions, or fixing reports that got rejected.
In this repository50 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- qa-agent-testingSkill
- qa-ai-blindspot-compensationSkill
- qa-ai-context-engineeringSkill
- qa-ai-output-critiqueSkill
- qa-ai-prompt-strategySkill
- qa-api-testingSkill
- qa-boundary-deep-diveSkill
- qa-bug-lifecycleSkill
- qa-bug-root-cause-analysisSkill
- qa-ci-cd-testingSkill
- qa-code-review-for-testSkill
- qa-combination-strategySkill
- qa-critical-thinkingSkill
- qa-domain-modelingSkill
- qa-execution-observationSkill
- qa-expert-reviewSkill
- qa-exploratory-testingSkill
- qa-heuristic-checklistSkill
- qa-input-validationSkill
- qa-mobile-testingSkill
- qa-output-validationSkill
- qa-quality-metricsSkill
- qa-question-frameworkSkill
- qa-regression-testingSkill
- qa-release-risk-governanceSkill
- qa-req-deconstructionSkill
- qa-requirement-reviewSkill
- qa-retrospectiveSkill
- qa-risk-intuitionSkill
- qa-scenario-treeSkill
- qa-shift-leftSkill
- qa-shift-rightSkill
- qa-specialized-testingSkill
- qa-stakeholder-communicationSkill
- qa-state-transitionSkill
- qa-team-coachingSkill
- qa-tech-debt-managementSkill
- qa-tech-selectionSkill
- qa-testability-advocacySkill
- qa-test-automation-archSkill
- qa-test-case-designSkill
- qa-test-data-engineeringSkill
- qa-test-env-dataSkill
- qa-test-estimationSkill
- qa-test-leadershipSkill
- qa-test-reportingSkill
- qa-test-skillsSkill
- qa-test-strategy-designSkill
The file
Files
⚠️ 本技能单独使用效果有限,建议配合完整技能集(12 步工作流)使用。安装:npx skills add Kokxi/qa-test-skills
⚠️ 安全警告:本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证;测试前应脱敏/掩码处理。 本技能仅在 workspace/ 输出评估文件,不持久化、不外传、不跨会话复用。
Bug报告艺术
核心原则
好的Bug报告不只是"描述问题",而是帮开发缩小排查范围。
加载时机
| 什么时候读 | 读哪个 |
| 写缺陷报告时,取七段式结构与各段写法 | references/bug-report-structure.md |
Bug报告黄金结构的完整内容已下沉至references/bug-report-structure.md,避免每次触发都占用上下文。
Bug报告模板
📌 本节与 qa-bug-lifecycle「缺陷报告模板」为同一概念的两个版本。本技能模板侧重执行(含前置条件、影响评估),lifecycle 模板侧重管理(含状态、优先级字段)。修改字段时请同步更新两个模板。
# Bug报告
## 基本信息
- Bug标题:[功能模块] + [具体现象] + [触发条件]
- 严重程度:P0/P1/P2/P3
- Bug类型:功能/性能/安全/UI/兼容性
- 发现版本:[版本号]
- 环境信息:[浏览器/系统/设备]
## 前置条件
1. [条件1]
2. [条件2]
3. [条件3]
## 复现步骤
1. [步骤1]
2. [步骤2]
3. [步骤3]
4. 观察[现象]
## 预期结果
[应该发生什么]
## 实际结果
[实际发生了什么]
## 附件
- 截图:[截图描述]
- 日志:[日志内容]
- 网络:[请求/响应]
## 根因推测(可选)
[可能是...因为...建议检查...]
## 影响评估
- 影响功能:[功能]
- 影响用户:[用户范围]
- 影响程度:[严重/一般/轻微]
- 修复优先级:[P0-P3]输出示例
用户发现登录功能报错 → 使用Bug报告结构生成:
- 标题:[登录] 输入正确密码后提示"密码错误"(Chrome浏览器)
- 前置条件:已注册用户testuser001,Chrome 120.0
- 复现步骤和预期vs实际结果
用户需要提交支付Bug → 自动组装Bug报告7个结构部分,生成标准格式的Bug报告
开发打回Bug报告说"无法复现" → 触发本技能补充复现步骤细节和环境信息
检查清单
Bug报告完成后检查:
- 标题是否清晰(是什么+在哪+条件下)?
- 前置条件是否完整?
- 复现步骤是否可操作?
- 预期vs实际是否明确?
- 附件是否充分?
- 根因推测是否合理?
- 影响评估是否准确?
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

