bugbatch-prepare
Skill2 starsChanged 5 months agoMITView on GitHub
将 bug2csv 导出的腾讯文档 bug CSV 整理成要修复的业务项目 issues/<版本>/bug_batch.csv,并为每个可执行 bug 生成复现场景、验收标准、状态和 issues/<版本>/tasks/<bug_id>-TASK.md 草案。适用于用户要从原始 bug 表准备一批 ready/needs_info 的 bug,供后续 bugfix-worktree 逐个领取修复。
In this repository12 other files it gives its agents.
- bug2csvSkill
- bugfix-comment-contextSkill
- bugfix-doneSkill
- bugfix-worktreeSkill
- debug-tag-addSkill
- debug-tag-clearSkill
- feature-doneSkill
- feature-prepareSkill
- feature-worktreeSkill
- plan-csv-executeSkill
- planSkill
- plan-to-issues-csvSkill
The file
Files
Bugbatch Prepare
目的
把 $bug2csv 下载下来的原始 bug 表,整理成可执行的本地 bug 批次。
输出目录放在要修复的业务项目根目录,而不是放在全局 skill 项目或临时调度项目里:
issues/<版本>/
例如业务项目是 /path/to/business-project,则输出到:
/path/to/business-project/issues/<版本>/
推荐结构:
issues/<版本>/
bug_batch.csv
source.csv
tasks/
BUG-001-TASK.md
BUG-002-TASK.md这个 skill 只做准备,不创建 worktree,不改业务代码。后续修复交给 $bugfix-worktree BUG-xxx。
输入
需要:
- 原始 CSV 路径,通常来自
$bug2csv - 版本名,例如
2026-06-25、v6.2.0-bugs、android-2026-06-25 - 可选:业务仓库路径,例如
/path/to/repo
如果用户没给版本名,用当前日期或从文件名推断一个短版本名。
输出 CSV 字段
生成或更新:
bug_id原始行号标题问题描述人工确认描述复现场景验收标准状态branchworktree_pathbase_repotarget_branchai_verify_planai_verify_cmdai_verify_resultai_verify_evidenceapk_pathinstall_devicehuman_verify_resulthuman_verify_notecommittask_fileblocked_reason备注
保留原始 CSV 中有价值的列,例如状态、模块、严重程度、处理描述等。不要覆盖用户手工修改过的 人工确认描述、复现场景、验收标准。
准备规则
- 复制原始 CSV 到
issues/<版本>/source.csv,作为快照。 - 为每条真实 bug 生成稳定
bug_id,例如BUG-003。不要给空行生成任务。 标题从问题描述压缩得到,保持短。人工确认描述:- 如果原 CSV 已有人工确认列,优先使用。
- 如果没有,用原始问题描述填入,并在
备注标记“待人工确认”。
复现场景和验收标准:- AI 先根据人工确认描述生成草案。
- 不确定的设备、角色、连接方式不要写死成事实;在 TASK 中列为“待确认”。
- 状态:
- 信息足够开始修:
ready - 缺关键事实、会导致修复靠猜:
needs_info - 仅草稿未确认:
draft
- 信息足够开始修:
- 为每个非空 bug 创建
issues/<版本>/tasks/<bug_id>-TASK.md。
ready 判断
一条 bug 至少要能回答:
- 问题是什么?
- 在什么场景触发?
- 修好后看到什么结果算通过?
能回答就可以 ready。不要求设备信息一开始完美。
如果是文案、资源、静态 UI 类 bug,通常可以直接 ready。
如果是投屏、声音、闪退、账号、权限、会员权益等动态 bug,缺少关键角色或连接方式时标记 needs_info。
TASK 文件模板
# <bug_id> <标题>
## 目标问题
原始描述:
人工确认描述:
## 复现场景
## 验收标准
## 待确认
- 无
## 修复方案选择
- 选择方案:
- 为什么选择:
- 放弃方案:
## 修改记录
## 修改文件
## AI 自证验证
- 验证计划:
- 测试/脚本:
- 命令:
- 结果:
- 证据:
## APK 安装
- APK:
- 设备:
- 安装结果:
## 用户人工验证
- 结果:
- 备注:
## 阻塞/风险
## 下一步完成回复
报告:
issues/<版本>/bug_batch.csv路径- 原始快照
source.csv路径 - 生成的 bug 数量
ready / needs_info / draft数量- 需要用户优先补充的
needs_infobug_id
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

