SuperAPI AI 工具集

filing-bug-reports

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:根据对话上下文生成自包含的 bug 报告 Markdown 文件,供接收方开发者复现、调查和修复问题,报告本身不预设根因或解决方案。

主要能力:从对话历史重建用户操作、实际结果与预期结果;以编程方式收集环境信息(工作区根目录、操作系统、架构、MCP 工具、相关源文件等);在 Simulink MCP 工具可用时收集 SATK 版本、MATLAB 版本、工具箱状态、连接器状态与 MCP 配置;复现并缩小为最小复现步骤;按模板填写报告。

使用方式:输出文件为 issues/BUG-<NNN>-<slug>.md,编号取下一个可用值,slug 由标题转为 kebab-case;若 issues/ 目录不存在则创建;每个文件只记录一个 bug。报告标题格式为 [Area] — Action — Unexpected result。仅向用户询问无法自行确定的信息,如预期行为、严重程度或会话外上下文。

适用场景:用户要求提交、撰写或记录 bug;需要将缺陷移交给其他开发者调查;需要留下可复现的异常行为记录。

限制:不用于用户想立即自行调试修复,或需要设计/代码评审(应改用 code-review 技能)。报告正文不得陈述根因或提出修复方案,假设只能放在 Notes 并标注为推测;错误信息与日志须逐字复制;不得包含密钥、令牌、密码或 PII,需以 <REDACTED> 脱敏。技能状态词汇(Registered、Described、Name-only、Invoked、Unregistered SATK skill)用于记录可观察状态,不读取磁盘上的 SKILL.md 来验证描述是否存在。若为布局问题且 satk 状态正常,需先征得用户同意再共享匿名化布局信息,且不读取该文件内容,而是直接将其追加到最终报告。具体模板结构见 assets/bug-report-template.md。