| name | issue-reporting |
| description | 向本仓提交 issue / 发起讨论时用。规定一份好问题反馈的 SOP——软件/版本、报错信息、初步分析、相关资料,并去除本地隐私(用户名/token 等替换)。凡要创建 issue、反馈 bug、发起讨论,先读本 skill 再动手。 |
issue-reporting —— 提交问题的 SOP
目标:一份能被直接复现和分诊的问题反馈,不来回追问。适用于 bug 反馈、行为疑问、
新功能提案的初始 issue。开发流程见 dev-process。
必备要素(缺一不可)
- 环境:OS + 架构;mcpp / 工具链版本;mbun 构建版本(
mcpp run -- --version);
相关依赖版本(如某 npm 包)。
- 复现:最小复现步骤 + 确切命令 + 输入(附最小脚本/仓库更佳)。
- 报错信息:完整 stderr / backtrace。崩溃/hang 经沙箱抓,见
mbun-runtime-debugging(tools/integration/safe-test.sh)。
- 初步分析:你或 agent 的判断——可疑的 API、源码位置、与预期的差异。
- 相关资料:上游 bun/node 的对照行为、相关 issue/PR、文档链接。
去隐私(提交前必做)
- 绝对路径里的用户名 / 主机名替换为占位符:
/home/<user>/…、<host>。
- 删除 token / 密钥 / 密码 / 私有邮箱 / 内网地址。
- 环境变量、日志片段同样清洗。
分诊
- issue 打类型标签(
特性|feature / 缺陷|bug / …);开放认领的加
待认领|available。标签体系见 hagent/labels.md。
模板骨架(可复制)
### 环境
- OS/架构:
- mcpp/工具链:
- mbun 版本(mcpp run -- --version):
- 依赖版本:
### 复现步骤
1.
命令:
输入/脚本:
### 期望 vs 实际
期望:
实际:
### 报错信息
<完整 stderr / backtrace,已去隐私>
### 初步分析
- 可疑 API / 源码位置:
### 相关资料
- 上游对照 / issue / 文档:
禁止
- ❌ 只说「跑不了」而无版本 / 命令 / 报错。
- ❌ 贴含用户名 / token / 内网地址的原始日志。
- ❌ 在 issue 里堆无关的完整日志——只贴相关片段。