bensz-collect-bugs

# Bensz Collect Bugs ## 目标 这是一个用于 Bensz Agent Skill 与基础设施设计缺陷留痕和按需上报的 Agent Skill。当 Bensz Agent Skill 在真实用户环境中因设计缺陷而出现 bug，或用户明确说“我想 report bensz skills bugs”“帮我公开上报 bensz skills 的 bug”时使用。该 Skill 负责把 bug 规范化记录到 `~/.bensz-skills/bugs/`，并在用户明确要求公开报告时通过本地 `gh` 轻量上传到 `huangwb8/bensz-bugs`，全程严禁修改用户本地 Claude Code/Codex 中已安装 Skills 的源代码。 用于“先本地留痕，再按需公开上报”的 bug 管理 skill。 ## 流程 ### 输入 #### 输入契约 ##### 本地记录时必需信息 - `skill_name` - `skill_author` - `bug_summary` - `expected_behavior` - `actual_behavior` ##### 强烈建议补充 - `reproduction_steps` - `evidence` - `workaround` - `agent_runtime` - `skill_source_path` ### 执行步骤 #### 只处理哪类问题 只处理这类 bug： - 由于 **Bensz Agent Skill 或 Bensz 基础设施的设计缺陷** 导致其无法按契约工作 - 典型表现包括：流程漏判、输入契约不完整、环境假设错误、脚本/模板设计不健壮、输出规范不一致 不要把下列情况记为本 skill 的 bug： - 用户数据本身有误 - 第三方服务临时不可用 - 用户主动修改了 skill 源码引入的问题 - 纯粹属于模型偶发发挥波动、但 skill 设计本身没有明显缺陷的情况 #### 标准工作流 ##### 阶段一：判断是否属于“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-repo` - `--...