bensz-collect-bugslisted
Install: claude install-skill huangwb8/skills
# Bensz Collect Bugs
用于“先本地留痕,再按需公开上报”的 bug 管理 skill。
## 只处理哪类问题
只处理这类 bug:
- 由于 **skill 设计缺陷** 导致 skill 无法完美工作
- 典型表现包括:流程漏判、输入契约不完整、环境假设错误、脚本/模板设计不健壮、输出规范不一致
不要把下列情况记为本 skill 的 bug:
- 用户数据本身有误
- 第三方服务临时不可用
- 用户主动修改了 skill 源码引入的问题
- 纯粹属于模型偶发发挥波动、但 skill 设计本身没有明显缺陷的情况
## 硬规则
- **严禁**直接修改用户本地 Claude Code / Codex 已安装 skills 的源代码来“顺手修 bug”
- 本地记录目录固定为 `~/.bensz-skills/bugs/`
- 本地每个 bug 目录固定结构为 `{skill_name}/{reporter}/{bug_hash}/`
- 每个 bug 目录必须包含:
- `bug-context.json`
- `BUG_REPORT.md`
- 用户明确要求“report bensz skills bugs”之前,只做本地记录,不做公开上传
- 公开上传时必须走用户本机的 `gh` 能力;如果 `gh` 未登录,先协助用户完成 `gh auth login`
- 上传阶段**不要 pull / clone 整个 `bensz-bugs` 仓库**;直接用 `gh api` 按文件路径创建内容
- 写入 `BUG_REPORT.md` 与 `bug-context.json` 时,**严禁**保留用户隐私、财产或其他私密信息,尤其是密钥、密码、身份信息、电话、邮箱、银行卡号与私密路径
- 本地记录阶段也必须执行最小化采集:默认不收集本地用户名、主机名、当前工作目录等高风险个人标识
- 公开上传前必须对本地专属信息做脱敏;公开仓库中不得泄露本地用户名、主机名、工作目录、绝对路径等隐私字段
## 标准工作流
### 阶段一:判断是否属于“skill 设计缺陷”
至少回答清楚:
1. 出问题的 skill 是哪个
2. 它原本应该怎样工作
3. 实际发生了什么
4. 为什么这是 skill 设计缺陷,而不是用户输入问题或外部服务抖动
如果判断不足以支持“设计缺陷”结论,不要强行记录。
### 阶段二:本地记录 bug
优先运行确定性脚本:
```bash
python3 bensz-collect-bugs/scripts/collect_bug.py \
--skill-name "<skill_name>" \
--skill-author "Bensz Conan" \
--bug-summary "<一句话概括 bug>" \
--expected-behavior "<预期行为>" \
--actual-behavior "<实际行为>" \
--reproduction-step "<步骤1>" \
--reproduction-step "<步骤2>" \
--evidence "<关键报错或关键现象>"
```
可选补充:
- `--workaround`
- `--severity`
- `--device-type`
- `--agent-runtime`
- `--skill-source-path`
- `--skill-source-