bensz-collect-bugs

# 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-...