About bug-reporting
A skill for bug reporting in real projects, helping produce actionable records for review and follow-up. It prioritizes by risk, makes assumptions and missing information explicit, and avoids inventing reproduction details.
Key features
- 01Prioritize by risk and business impact
- 02Record title, environment, and preconditions
- 03Organize reproduction steps and actual results
- 04Include expected result, frequency, and impact
- 05State assumptions and information gaps
Use cases
- 01Write bug reports developers can reproduce
- 02Prepare impact and priority for defect review
- 03Draft a report that identifies missing details
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ naodeng/ awesome-qa-skills --skill bug-reportingAfter installing, type/bug-reportingin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
output-formats.mdquick-start.mdREADME.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamledge-incomplete-input.yamledge-risk-priority.yamlreview-expected-source-missing.yamlreview-frequency-and-priority.yamlexamples/bug-report-templates/README.mdtemplate-standard.mdoutput-templates/template-csv.csvtemplate-excel.tsvtemplate-json.jsontemplate-markdown.mdtemplate-word.mdtemplate-xmind.mdprompts/bug-reporting.mdreferences/local/CONTRIBUTING.mdFAQ.mdscripts/batch_convert_templates.pyconvert_formats.pyconvert_output_formats.pyconvert_to_csv.pyconvert_to_excel.pyconvert_to_json.pyconvert_to_markdown.pyconvert_to_word.pyconvert_to_xmind.pyDetails
From the project README缺陷上报(中文版)
英文版: 见对应英文技能。
何时使用
- 需要在真实项目里处理 bug reporting 相关任务。
- 需要一份可以直接用于执行、评审或跟进的结果。
执行流程
- 阅读并遵循「按需加载」中的主提示词(覆盖清单、输出结构、质量要求)。
- 只补充真正影响结果的项目上下文:范围、环境、限制、风险、依赖、期望产出。
- 信息不全时先给可用初版,并显式标出假设与信息缺口。
- 默认 Markdown;用户指定其他格式时再切换。
核心约束
- 按风险/业务影响排优先级,不要平均摊铺。
- 把「已确认事实」和「当前假设」分开写。
- 不要编造用户未提供的接口、字段、环境或根因细节。
- 结果必须可执行:场景具体、有优先级、能指导下一步。
按需加载
- 产出前必须阅读并遵循
prompts/bug-reporting.md(最低覆盖清单、输出结构、质量要求)。 - 需要 Excel/CSV/JSON/Word 等格式时:读
output-formats.md,并按用户格式要求输出。 - 需要套用现成模板时:读
output-templates/中匹配的模板,不要自创冲突结构。 - 用户要示例或对标现有资产时:读
examples/中相关样例。 - 需要框架规范、排障、报告 schema 等深资料时:只读
references/里与当前问题相关的文件,不要整目录通读。 - 需要格式转换或辅助校验时:优先使用
scripts/中已有脚本,而不是重写一遍。 - 需要评测/回归本 skill 时:使用
evals/,并用 skill-up 校验与运行。 - 用户只要最短上手路径时:读
quick-start.md。
交付前自检
- 已遵循主提示词的输出结构
- 最低覆盖关注:标题、环境、前置条件、复现步骤、实际结果、预期结果、复现频率、影响范围…(细节以主提示词为准)
- 已覆盖最低清单,或标明为何省略
- 高风险项有明确优先级
- 未编造用户未提供的细节
- 假设与信息缺口已标明
常见误区
- 范围和上下文都不清楚时,不要假装已经完整可用。
- 不要把所有项写成同等重要。
- 不要跳过假设与信息缺口。
- 不要输出大段与当前工具链无关的空泛理论。
Comments
Markdown supported