← ClaudeAtlas

bensz-collect-bugslisted

当 Bensz 系列 skills 在真实用户环境中因 skill 设计缺陷而出现 bug,或用户明确说“我想 report bensz skills bugs”“帮我公开上报 bensz skills 的 bug”时使用。该 skill 负责把 bug 规范化记录到 `~/.bensz-skills/bugs/`,并在用户明确要求公开报告时通过本地 `gh` 轻量上传到 `huangwb8/bensz-bugs`,全程严禁修改用户本地 Claude Code/Codex 中已安装 skills 的源代码。
huangwb8/skills · ★ 37 · Data & Documents · score 86
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-