关于 bug-reporting
面向真实项目缺陷上报工作的技能,帮助形成可执行、可评审和可跟进的缺陷记录。它强调按风险排序、标明假设与信息缺口,并避免编造复现细节。
主要功能
- 01按风险和业务影响排序
- 02记录标题、环境与前置条件
- 03整理复现步骤和实际结果
- 04补充预期结果、频率与影响范围
- 05明确假设和信息缺口
适用场景
- 01撰写可供研发复现的缺陷报告
- 02为缺陷评审整理影响与优先级
- 03信息不全时提交注明缺口的初稿
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ naodeng/ awesome-qa-skills --skill bug-reporting安装后在 Claude Code 中输入/bug-reporting确认已加载。
包含的文件
除 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.py详细介绍
原文在翻译后有更新,译文可能不是最新。
错误报告
中文版: 请参阅对应的中文版技能。
适用场景
- 需要在真实项目场景中获得错误报告方面的帮助。
- 需要可直接用于执行、审查或后续跟进的输出。
工作流
- 阅读并遵循渐进式披露中列出的主提示词(覆盖范围、结构、质量标准)。
- 只补充会影响结果的项目背景:范围、环境、限制、风险、依赖项、预期交付物。
- 如果输入不完整,先提供可用的初稿,并明确标注假设和信息缺口。
- 默认使用 Markdown;仅在用户提出要求时切换格式。
核心约束
- 按风险/业务影响确定优先级,不要一概而论。
- 将已确认事实与当前假设分开。
- 不要编造用户未提供的端点、字段、环境或根本原因。
- 确保输出可执行:包含具体场景、明确优先级和清晰的后续步骤。
渐进式披露
- 生成输出前,阅读并遵循
prompts/bug-reporting.md(最低覆盖要求、输出结构、质量标准)。 - 用户要求 Excel/CSV/JSON/Word 时:阅读
output-formats.md并遵循相应格式。 - 适用现成模板时:使用
output-templates/下的对应文件。 - 对于深入的框架/故障排查/架构说明:仅阅读
references/下的相关文件,不要加载整个目录。 - 对于格式转换或辅助检查:优先使用现有的
scripts/,不要重复造轮子。 - 对此技能进行评估/回归测试时:通过 skill-up 使用
evals/。
交付前检查清单
- 遵循了主提示词的输出结构
- 最低覆盖重点:标题、环境、前置条件、复现步骤、实际结果、预期结果、复现频率、影响范围等(详见主提示词)
- 覆盖了最低检查清单,或说明了遗漏项
- 高风险事项已明确标注优先级
- 未编造用户未提供的细节
- 已标注假设和信息缺口
常见问题
- 范围/背景缺失时,不要假装内容完整。
- 不要将所有事项视为同等重要。
- 不要遗漏假设和信息缺口。
- 不要罗列与当前工具链无关的通用理论。
评论
支持 Markdown