SuperAPI AI 工具集

write

通用与其它

查看项目

更新于 10-16 00:24

技能介绍

用途:该技能把非正式的缺陷描述整理为五字段结构化 bug 报告,便于下一步会话或人工直接处理,避免复现步骤模糊、严重程度缺失、无修复位置等问题。属于缺陷捕获阶段,位于录入工单追踪系统之前。

主要能力:输出 title、steps to reproduce、expected vs actual、severity(含理由)、suggested fix location 五个字段。只读,不修改代码,不默认提交工单。无法从来源支撑的字段使用“(unknown — needs reporter confirmation)”占位,而非编造。

使用方式:触发条件包括用户描述缺陷、请求撰写缺陷报告、陈述行为不符、或要求从非正式上下文生成结构化报告。跳过条件:需要调查诊断、修复已在进行、功能请求(非缺陷)、通用杂务任务。流程为:跳过条件检查 → 写下前先做快速广度调查(按符号 Grep/Glob、查看文件最近提交、检查输出目录是否已有同类报告)→ 针对性单问题问答 → 输出报告 → 交接建议。

修饰标志:默认按需调查与问答;--quick 在符号无歧义时跳过调查、最多一轮问答;--full 始终调查、最多三轮问答;--no-survey 信任描述,仅在字段会被凭空编造时才提问;--file 将报告写入文件而非仅输出 stdout。

输出:默认输出 Markdown 到 stdout。--file 模式写入带 frontmatter(type: bug-report)的文件,输出目录依次解析为 user_config.output_dir、${CLAUDE_PLUGIN_DATA}/bug-reports/<project-slug>/,否则回退到 ${CLAUDE_PROJECT_DIR}/.bug-reports/。文件名由标题生成 kebab-case 短 slug 并前置 ISO 基础 UTC 时间戳(无冒号),例如 20260502T143000Z-bug-pricefor-discount-math.md。

严重程度规则:low/medium/high/critical 各配一行理由,按影响范围×阻塞程度×数据完整性衡量,而非报告者情绪。若追踪系统使用优先级标签,提交时映射到对应标签。

限制:不写代码、不开 PR;不编造复现步骤;不默认提交工单;不进行深度调查;不会自动修正用户描述中的拼写;不进行广泛探索或研究。若无缺陷,应输出简短的“No bug confirmed”摘要而非报告。模板、示例、frontmatter 及无缺陷形式见 context/template.md。命名、区域、优先级标签、追踪系统选择等由使用方项目自身的 CLAUDE.md/rules 约定,本技能读取而非强加。