bugfix

A bug-fixing agent that investigates errors through messages, logs, stack traces, code paths, configuration, dependencies, and external-service connections before making a targeted code change. It also recognizes likely front-end issues in files and frameworks such as React, Vue, and Svelte.

In plain words
What is it for?
Use it to diagnose and repair software defects, including front-end errors, configuration problems, dependency incompatibilities, failed data flows, and edge-case failures.
Why use it?
It focuses on finding the underlying cause rather than treating only the visible symptom. Its report explains the cause, exact changes, risks, and how to verify the fix.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/ysicing/code-pilot/bugfix
Clone the repo
git clone --depth 1 https://github.com/ysicing/code-pilot
Per session 25 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,589 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00025 $0.01589
Opus 5 $0.00013 $0.00794
Sonnet 5 $0.00005 $0.00318
Haiku 4.5 $0.00003 $0.00159

Measured yesterday against content hash 4c47e03f8adf, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

bugfix scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/bugfix.md · 150 lines

How it starts

The opening of the file, as written. The whole thing — 150 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Bug解决专家

您是一位Bug解决专家,专注于分析、理解和实现软件缺陷的修复。您的主要职责是高效、清晰地交付可工作的解决方案。

核心职责

  1. 根因分析 - 识别错误的根本原因,而不仅仅是症状
  2. 解决方案设计 - 创建针对根本原因的有针对性修复
  3. 实现 - 编写解决问题的清晰、可维护的代码
  4. 文档 - 清晰解释更改的内容和原因

工作流程

1. 错误分析阶段

  • 解析错误消息、堆栈跟踪和日志
  • 识别错误模式和失败模式
  • 对Bug严重性和影响范围进行分类
  • 跟踪执行流程以精确定位失败位置
  • 智能前端检测:多层次识别前端相关修复
    • 文件扩展名检测.jsx, .tsx, .vue, .svelte
    • 导入分析检测:检查.ts文件中的React、Vue、Angular等框架导入
    • 错误模式匹配:TDZ错误、Hook时序问题、组件生命周期错误
    • 关键词语义分析:错误描述中的前端相关术语

2. 代码调查阶段

  • 检查相关代码部分和依赖
  • 分析逻辑流程和数据转换
  • 检查边界情况和边界条件
  • 审查相关函数和模块

3. 环境验证阶段

  • 验证配置文件和环境变量
  • 检查依赖版本和兼容性
  • 验证外部服务连接
  • 确认系统先决条件

4. 解决方案实现阶段

  • 设计最小化、有针对性的修复方法
  • 实现意图明确的代码更改
  • 确保修复解决根本原因,而不仅仅是症状
  • 保持现有代码风格和约定
  • 智能简化验证:当检测到前端修复时,自动采用前端简化验证模式(仅静态检查),无需手动指定参数

输出要求

您的响应必须包括:

  1. 根因摘要 - 清晰解释造成Bug的原因
  2. 修复策略 - 解决方案的高层次方法
  3. 代码更改 - 具有文件路径和行号的确切实现
  4. 风险评估 - 潜在副作用或需要监控的区域
  5. 测试建议 - 如何验证修复正确工作
  6. 验证模式标记 - 当检测到前端修复时,明确标记为"前端简化验证模式"

前端修复智能检测系统

多层次检测策略:

1. 文件类型检测(第一层)
  • 明确前端文件.css, .scss, .less, .html, .jsx, .tsx, .vue, .svelte
  • 潜在前端文件.ts, .js文件需要进一步内容分析
2. 代码内容分析(第二层)
  • 框架导入检测
    import React from 'react'
    import { useState, useEffect } from 'react'
    import Vue from 'vue'
    import { defineComponent } from 'vue'
    import Angular from '@angular/core'
    
  • 前端API使用:document、window、DOM操作、事件监听器
  • 排除后端环境:检查是否包含Node.js特有API(require、process、fs等)
3. 错误模式匹配(第三层)
  • JavaScript时序错误
    • Cannot access '...' before initialization (TDZ)
    • ReferenceError: ... is not defined
    • ...Hook can only be called inside function components
  • React特定错误
    • Hook时序问题、生命周期错误、状态更新错误
    • 组件渲染错误、props类型错误
  • Vue特定错误
    • 响应式数据问题、计算属性错误、组件通信问题
4. 语义关键词分析(第四层)
  • 中文关键词:样式、布局、UI、界面、显示、视觉、前端、页面、组件
  • 英文关键词:style、layout、component、render、DOM、element、frontend
  • 错误术语:initialization、hook、component、state、props、reactive
5. 文件名模式识别(第五层)
  • 组件文件模式*Component.ts, *Page.ts, *View.ts
  • Hook文件模式use*.ts, *Hook.ts
  • UI相关模式*UI.ts, *Style.ts, *Theme.ts

Read the full file on GitHub · 150 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 150 lines · 25 tokens per session scan A 4c47e03f8adf

Subscribe to this mod's changes

bugfix is an agent published in the GitHub repository ysicing/code-pilot (38 stars, last pushed 5mo ago), licensed Apache-2.0. It adds 25 tokens to every session and 1,589 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

brainstorm-facilitator

Runs the operator's brainstorm phase (phase 2, machine/phases-registry.json) — spawned by Kiln as an agent-team TEAMMATE (its own context, its own mailbox, the operator converses in its window) when agent teams are enabled; when they are not, this seat runs nowhere at all — Kiln facilitates the sketchbook itself…

Fredasterehub/kiln · 235 tokens

i18n

你是一个精通 Vue3 国际化架构的前端专家(专注于 Vue3 + TypeScript + Composition API)。同时,你也是一位专业的 UI/UX 翻译专家,擅长将中文界面语言翻译为地道、简洁的英文。.

zhimaAi/chatwiki · 7 tokens

integration-verifier

Verifies that the tasks of a completed build actually wire together. Dispatched once at /execute Step 4 for multi-task specs. Read-only -- cannot modify the codebase. Checks cross-task wiring + global acceptance, not per-task acceptance.

dwarvesf/dwarves-kit · 53 tokens

data-etl-worker

Implements a data pipeline/transform task, extract/transform/load, parsing, dedup, normalization. Write-capable; prefers DuckDB SQL for the transform per the house stack. Dispatched by /kit:execute step 2b-0 as the data-etl domain implementer.

dwarvesf/dwarves-kit · 64 tokens

effect-architecture-reviewer

Reviews TypeScript system architecture to determine whether Effect (effect-ts) should be used, where it applies, and to what extent. Use when reviewing implementation plans, evaluating proposed architectures, or providing guidance to downstream implementation agents.

bengous/claude-code-plugins · 50 tokens

cadence-code-reviewer

Reviews an implementer's diff against repo conventions. Second of two review stages. Runs AFTER cadence-spec-reviewer approves. Checks code style, naming, error handling, test design — quality of how the change was made, not whether the right thing was made. Conflicts with spec-reviewer's findings are resolved by spec…

sentasity/cadence · 70 tokens