Handday Auto Bug Fix

全自动 Bug 诊断与修复 Skill —— 支持 Qoder 和 Workbuddy 环境，多 Agent 协作编排，从 Bug 采集到修复审查一站式完成。

简介

handday-auto-bug-fix 是一个面向 Qoder 和 Workbuddy 的高级 Skill，采用 多 Agent 协作模式，实现 Bug 的全自动处理：

• PM（主 Agent）：流程编排、任务分配、协调各 Agent、最终汇报
• 前端专家（frontend-bug-fixer subagent）：页面定位、接口追踪、前端问题分析与修复
• 后端专家（senior-java-expert subagent）：Java 代码定位、根因分析、修复实施
• 腾讯云日志专家（tencent-cloud-troubleshooter subagent）：生产环境 CLS 日志检索、APM 链路追踪、根因诊断（可选启用）
• 工单采集（handday-workorder 子 Skill）：自动从 handday OS 平台采集工单信息

核心功能

| 功能 | 说明 | |------|------| | 多来源 Bug 采集 | 支持工单（GD编号）、禅道 Bug 链接、用户文字/截图描述 | | 智能归属判定 | 自动判断前端 / 后端 / 接口联调问题，精准分派 | | 生产日志抓取（可选） | 当工单中存在 traceId 或明显异常信息时，自动决策是否通过腾讯云日志专家进行 CLS 日志检索（APM 链路追踪按需启用） | | 业务异常分析 | 当日志诊断确认为业务异常时，协调前后端专家定位业务逻辑，输出业务异常解释报告 | | 多 Agent 协作排查 | 前后端专家可多轮交互，直到根因明确 | | 自动修复实施 | 用户确认后自动执行代码修改 + 编译验证 | | 代码审查 | 修复后自动调用 code-review 进行代码审查 | | 环境自初始化 | 首次运行自动检查并安装所有依赖（subagent + 子 Skill） |

子 Skill 说明

本 Skill 集成了三个子 Skill，分别负责工单信息采集、TCCLI 环境配置和日志链路查询，既可被主流程自动调用，也支持独立使用。

1. handday-workorder — 工单信息采集

| 项目 | 说明 | |------|------| | 功能简介 | 通过浏览器自动化从 handday OS 平台自动采集工单的标题、描述、截图、报错信息等关键数据 | | 触发方式 | 主 Skill 中自动调用（Bug 采集环节）；独立使用：Qoder 中输入 /handday-workorder | | 适用场景 | 工单 Bug 自动信息采集；查看工单详情、订单信息、客户信息；平台数据查询与验证 | | 注意事项 | 依赖 Chrome DevTools MCP Server；需要 handday OS 平台登录权限 |

2. tccli-setup — TCCLI 安装配置引导

| 项目 | 说明 | |------|------| | 功能简介 | 引导用户安装、配置和认证腾讯云 CLI（TCCLI），支持浏览器授权登录、多账号 Profile 管理 | | 触发方式 | 主 Skill 中首次需要生产日志抓取时自动触发（可选）；独立使用：Qoder 中输入 /tccli-setup | | 适用场景 | TCCLI 首次安装与配置；认证过期后重新授权；多账号 Profile 配置管理 | | 注意事项 | TCCLI 未安装不影响主 Bug 修复流程；推荐使用 tccli auth login 浏览器授权，无需 SecretKey |

3. tccli-log-query — CLS 日志检索与 APM 链路查询

| 项目 | 说明 | |------|------| | 功能简介 | 通过 TCCLI 检索腾讯云 CLS 日志和 APM 链路数据，用于生产环境问题诊断 | | 触发方式 | 主 Skill 中检测到 traceId 或明显异常信息时自动决策启用；独立使用：Qoder 中输入 /tccli-log-query | | 适用场景 | traceId 链路追踪；生产异常日志检索；服务崩溃根因分析；APM 调用链查询与性能分析 | | 注意事项 | 必须先完成 TCCLI 安装认证；查询受日志主题权限限制；单次最多重试 5 次；仅支持只读查询，不会对生产环境产生写操作 |

工作流程

用户输入 Bug → 环境初始化 → 信息采集 → [可选]生产日志抓取 → 分派分析 → 协作排查 → 汇报方案 → 用户确认 → 修复实施 → 代码审查

目录结构

handday-auto-bug-fix/
├── SKILL.md                              # 主 Skill 定义（流程编排逻辑）
├── README.md                             # 本文件
├── package.json                          # npm 包配置（@handday-neil/auto-bug-fix）
├── index.js                              # npm 安装核心逻辑
├── bin/
│   └── cli.js                            # CLI 入口（handday-auto-bug-fix 命令）
├── agents/                               # Subagent 模板（备份）
│   ├── manifest.json                     # 依赖清单 & 初始化状态
│   ├── frontend-bug-fixer.md             # 前端专家 subagent 配置
│   ├── senior-java-expert.md             # 后端专家 subagent 配置
│   └── tencent-cloud-troubleshooter.md   # 腾讯云日志专家 subagent 配置
└── skills/                               # 子 Skill 模板（备份）
    ├── handday-workorder/
    │   ├── SKILL.md                      # 工单查询 Skill 定义
    │   └── api-reference.md              # handday OS API 参考文档
    ├── tccli-setup/
    │   ├── SKILL.md                      # TCCLI 安装配置引导 Skill
    │   └── reference.md                  # TCCLI 详细参考文档
    └── tccli-log-query/
        ├── SKILL.md                      # TCCLI 日志检索与链路查询 Skill
        └── api-reference.md              # CLS/APM API 参考文档

前置条件

必需

• Qoder IDE（VS Code / JetBrains 插件）或 Workbuddy 环境
• Chrome DevTools MCP Server：工单采集需要通过浏览器自动化访问 handday OS 平台
• Node.js：用于运行 CodeGraph 代码检索工具

推荐

• CodeGraph（@colbymchenry/codegraph）：结构性代码检索，后端排查核心工具

  npm install -g @colbymchenry/codegraph

• TCCLI（腾讯云命令行工具）：生产日志抓取功能依赖，可选安装

  pip install tccli
  tccli auth login

  未安装 TCCLI 不影响主流程，仅无法使用可选的生产日志抓取功能。安装后使用 /tccli-setup 技能完成配置。

• 项目级 .qoder/rules/ 中配置 CodeGraph 使用规则

安装

本 Skill 同时支持 Qoder（~/.qoder/）和 Workbuddy（~/.workbuddy/）两种环境。npm 安装器默认同时安装到两个环境，也可通过 --target 参数指定单一目标。

方式一：npm 安装（推荐）

一键安装/升级（推荐，无需全局安装，始终拉取最新版）：

# 安装到所有支持的环境（Qoder + Workbuddy）
npx @handday-neil/auto-bug-fix@latest install

# 仅安装到 Qoder
npx @handday-neil/auto-bug-fix@latest install --target qoder

# 仅安装到 Workbuddy
npx @handday-neil/auto-bug-fix@latest install --target workbuddy

全局安装：

# 第一步：全局安装包
npm install -g @handday-neil/auto-bug-fix

# 第二步：执行安装命令（默认安装到所有环境）
handday-auto-bug-fix install

# 或指定单一目标
handday-auto-bug-fix install --target qoder
handday-auto-bug-fix install --target workbuddy

# macOS / Linux
npm install -g @handday-neil/auto-bug-fix
handday-auto-bug-fix install

方式二：直接复制

将整个 handday-auto-bug-fix 目录复制到目标环境的 Skills 目录：

Qoder 用户级安装（对所有项目生效）：

# Windows
Copy-Item -Recurse "handday-auto-bug-fix" "$env:USERPROFILE\.qoder\skills\handday-auto-bug-fix"

# macOS / Linux
cp -r handday-auto-bug-fix ~/.qoder/skills/handday-auto-bug-fix

Workbuddy 用户级安装（对所有项目生效）：

# Windows
Copy-Item -Recurse "handday-auto-bug-fix" "$env:USERPROFILE\.workbuddy\skills\handday-auto-bug-fix"

# macOS / Linux
cp -r handday-auto-bug-fix ~/.workbuddy/skills/handday-auto-bug-fix

Workbuddy 额外步骤：Workbuddy 环境下，还需将 agents/ 目录下的 .md 文件复制到 ~/.workbuddy/agents/，将 skills/ 下的子 skill 目录复制到 ~/.workbuddy/skills/。npm 安装器会自动完成这些操作，手动复制时需自行处理。完成后执行 /reload-plugins 生效。

项目级安装（仅对当前项目生效）：

# Windows - Qoder
Copy-Item -Recurse "handday-auto-bug-fix" ".qoder\skills\handday-auto-bug-fix"

# Windows - Workbuddy
Copy-Item -Recurse "handday-auto-bug-fix" ".workbuddy\skills\handday-auto-bug-fix"

# macOS / Linux - Qoder
cp -r handday-auto-bug-fix .qoder/skills/handday-auto-bug-fix

# macOS / Linux - Workbuddy
cp -r handday-auto-bug-fix .workbuddy/skills/handday-auto-bug-fix

方式三：Git Clone

# Qoder 用户级
cd ~/.qoder/skills
git clone <本仓库地址> handday-auto-bug-fix

# Workbuddy 用户级
cd ~/.workbuddy/skills
git clone <本仓库地址> handday-auto-bug-fix

# Qoder 项目级
cd .qoder/skills
git clone <本仓库地址> handday-auto-bug-fix

# Workbuddy 项目级
cd .workbuddy/skills
git clone <本仓库地址> handday-auto-bug-fix

安装后验证

安装完成后，输入以下触发词验证 Skill 是否被识别：

bug、报错、异常、fix、修复、错误、问题排查、堆栈、500、NPE、接口报错、工单bug、禅道bug

Skill 首次运行时会自动执行 Step 0 环境初始化：

1. 读取 agents/manifest.json 获取依赖清单
2. 检查 frontend-bug-fixer、senior-java-expert、tencent-cloud-troubleshooter 三个 subagent 是否已存在（同时检查 Qoder 和 Workbuddy 路径），缺失则自动创建
3. 检查 handday-workorder、tccli-setup、tccli-log-query 三个子 Skill 是否已存在（同时检查 Qoder 和 Workbuddy 路径），缺失则自动从备份安装
4. code-review 为内置 Skill，无需安装

Workbuddy 注意：安装到 Workbuddy 后需执行 /reload-plugins 命令使新配置生效，无需重启。

TCCLI 工具说明：tccli-setup 和 tccli-log-query 安装的是技能配置文件，TCCLI 命令行工具本身的安装和认证配置在运行时由 tencent-cloud-troubleshooter 检查。TCCLI 未安装不阻塞主流程，仅影响可选的生产日志抓取步骤。

使用方式

基本用法

在 Qoder 对话中直接描述 Bug 即可触发：

# 通过工单号
帮我看看 GD2026052314140082 这个工单

# 通过禅道链接
这个 bug 修一下：https://<禅道地址>/bug-view-12345.html

# 通过文字描述
出单的时候报 NPE 了，堆栈如下：...

# 通过截图
[粘贴错误截图] 这个问题帮我排查一下

触发关键词

Skill 会在检测到以下关键词时自动激活：

bug · 报错 · 异常 · fix · 修复 · 错误 · 问题排查 · 堆栈 · 500 · NPE · 接口报错 · 工单bug · 禅道bug

依赖说明

| 依赖 | 类型 | 用途 | 安装方式 | |------|------|------|---------| | frontend-bug-fixer | Subagent | 前端问题排查与修复 | 自动从 agents/ 模板创建 | | senior-java-expert | Subagent | 后端 Java 代码排查与修复 | 自动从 agents/ 模板创建 | | tencent-cloud-troubleshooter | Subagent | 生产环境日志检索与 APM 链路追踪（可选启用） | 自动从 agents/ 模板创建 | | handday-workorder | 子 Skill | 工单信息采集（浏览器自动化） | 自动从 skills/ 备份安装 | | tccli-setup | 子 Skill | TCCLI 安装与配置引导 | 自动从 skills/ 备份安装 | | tccli-log-query | 子 Skill | CLS 日志检索与 APM 链路查询 | 自动从 skills/ 备份安装 | | code-review | 内置 Skill | 修复后代码审查 | Qoder 自带，无需安装 |

依赖的安装状态记录在 agents/manifest.json 的 initStatus 字段中，已安装的依赖不会重复安装。

项目适配

本 Skill 当前针对 handday 项目进行了深度定制：

• 后端代码目录：e:\workspace\handday-all（多模块微服务）
• 前端代码目录：E:\workspace\handday-web（Vue 前端项目）
• 技术栈：Spring Boot + Java 8 + Spring Cloud + Nacos + MyBatis
• 代码检索：CodeGraph（68 万+ 节点索引）
• 工单平台：地址配置于 skill 目录下的 .env 文件（WORKORDER_BASE_URL），安装器会随包复制，缺失时 agent 会主动询问

如需在其他项目中使用，需修改 SKILL.md 中的：

1. 前端项目约束（目录路径、分支策略）
2. CodeGraph 配置（项目路径、索引范围）
3. senior-java-expert.md 中的项目技术与结构认知

License

MIT