BugPack
AI-powered bug tracking and fixing toolkit. List, view, and fix bugs from BugPack.
Prerequisites
Start BugPack server first:
CODEBLOCK0
Skill 1: List Bugs
Query all tracked bugs with optional filtering.
Instructions
- 1. Call
GET http://localhost:3456/api/bugs to fetch all bugs.
- Optional:
?project_id=<id> to filter by project.
- 2. Each bug has:
id, title, description, status, priority, project_id, created_at. - Present results grouped by status (
pending / fixed / closed).
Example
CODEBLOCK1
Skill 2: View Bug Details
Fetch full bug context including screenshots, environment, and related files.
Instructions
- 1. Call
GET http://localhost:3456/api/bugs/:id for full details. - Response includes:
title, description, status, priority, pagePath, device, browser, relatedFiles, screenshots. - Use
relatedFiles to locate relevant source code. - Screenshots have
original_path and annotated_path.
Example
CODEBLOCK2
Skill 3: Fix Bug
Read bug context, locate code, apply fix, and update status.
Instructions
- 1. Get context: INLINECODE25
- Analyze: Read description and examine screenshots.
- Locate code: Use
relatedFiles or search by pagePath and description. - Apply fix: Edit source code following project conventions.
- Mark fixed:
PATCH http://localhost:3456/api/bugs/:id with INLINECODE30 - Add note (optional): Update description to document what was changed.
Example
CODEBLOCK3
BugPack
AI驱动的Bug追踪与修复工具包。从BugPack中列出、查看和修复Bug。
前置条件
首先启动BugPack服务器：
bash
npx bugpack-mcp
技能1：列出Bug
查询所有已追踪的Bug，支持可选过滤。
操作说明
- 1. 调用 GET http://localhost:3456/api/bugs 获取所有Bug。
- 可选：?project_id=
按项目过滤。
- 2. 每个Bug包含：id、title、description、status、priority、projectid、createdat。
- 按状态（pending / fixed / closed）分组展示结果。
示例
GET http://localhost:3456/api/bugs
技能2：查看Bug详情
获取完整的Bug上下文，包括截图、环境和相关文件。
操作说明
- 1. 调用 GET http://localhost:3456/api/bugs/:id 获取完整详情。
- 响应包含：title、description、status、priority、pagePath、device、browser、relatedFiles、screenshots。
- 使用 relatedFiles 定位相关源代码。
- 截图包含 originalpath 和 annotatedpath。
示例
GET http://localhost:3456/api/bugs/abc-123
技能3：修复Bug
读取Bug上下文，定位代码，应用修复并更新状态。
操作说明
- 1. 获取上下文：GET http://localhost:3456/api/bugs/:id
- 分析：阅读描述并检查截图。
- 定位代码：使用 relatedFiles 或通过 pagePath 和 description 搜索。
- 应用修复：按照项目规范编辑源代码。
- 标记已修复：PATCH http://localhost:3456/api/bugs/:id 并传入 { status: fixed }
- 添加备注（可选）：更新描述以记录修改内容。
示例
bash
获取Bug上下文
GET http://localhost:3456/api/bugs/abc-123
标记为已修复
PATCH http://localhost:3456/api/bugs/abc-123
Content-Type: application/json
{ status: fixed }
