build-error-resolver

build-error-resolver is an agent for Claude Code from xiaobei930/cc-best. It costs 88 tokens per session (1,586 once invoked), scanned A, original, MIT.

An agent that diagnoses build and compilation errors and proposes small, targeted fixes.

In plain words
What is it for?
Use it when TypeScript, JavaScript, Go, Python, or another supported project fails to build, then rebuild to verify the fix.
Why use it?
It helps identify the underlying cause of errors such as missing imports, incompatible types, absent dependencies, or syntax problems without turning the repair into a broad rewrite.

Agent for Claude Code

Written for Claude Code: effort in frontmatter.

Part of the cc-best plugin — 19 skills, 44 commands, 8 agents, 20 hooks shipped together

Good fit Use it when TypeScript, JavaScript, Go, Python, or another supported project fails to build, then rebuild to verify the fix.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/xiaobei930/cc-best/build-error-resolver
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.

Clone the repo
git clone --depth 1 https://github.com/xiaobei930/cc-best

Made for: Claude Code.

Or install cc-best, the plugin that ships this one along with the rest of its 19 skills, 44 commands, 8 agents, 20 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for build-error-resolver

README.md
[![agentmods](https://agentmods.dev/badge/agents/xiaobei930/cc-best/build-error-resolver/github.svg)](https://agentmods.dev/agents/xiaobei930/cc-best/build-error-resolver)
Your own site
<a href="https://agentmods.dev/agents/xiaobei930/cc-best/build-error-resolver"><img src="https://agentmods.dev/badge/agents/xiaobei930/cc-best/build-error-resolver/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for build-error-resolver

Your own site · 80×15
<a href="https://agentmods.dev/agents/xiaobei930/cc-best/build-error-resolver"><img src="https://agentmods.dev/badge/agents/xiaobei930/cc-best/build-error-resolver.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 88 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,586 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00088 $0.01586
Opus 5.5 $0.00035 $0.00634
Sonnet 5.5 $0.00018 $0.00317
Haiku 4.5 $0.00009 $0.00159

Measured 1mo ago against content hash 428c727508e6, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

build-error-resolver 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 1mo ago.

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/build-error-resolver.md · 243 lines

How it starts

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

Build Error Resolver Agent

你是一个构建错误解析智能体,专注于快速诊断和修复构建/编译错误。

行为准则

关键指令:最小改动,精准修复。

  • 只修复报错,不做额外重构
  • 一个错误一个修复,不批量猜测
  • 理解错误根因,不只是消除症状
  • 记录解决方案,避免重复问题

核心职责

  1. 错误分析:解析构建日志,定位根因
  2. 精准修复:提供最小改动的修复方案
  3. 类型修复:处理 TypeScript/类型系统错误
  4. 依赖诊断:识别缺失/版本冲突的依赖
  5. 方案记录:记录常见错误的解决模式

与其他组件的关系

配合使用

组件 关系 场景
code-reviewer 互补 修复后由 reviewer 检查质量
code-simplifier 顺序 修复完成后再简化
security-reviewer 并行 修复时同时检查安全
tdd-guide 验证 修复后需要测试验证

调用链

构建失败 → build-error-resolver → 修复 → code-reviewer(可选) → 重新构建

支持的错误类型

TypeScript/JavaScript

错误码 类型 常见原因
TS2304 找不到名称 缺少导入/类型定义
TS2339 属性不存在 类型定义不完整
TS2345 参数类型不匹配 函数签名错误
TS2307 找不到模块 依赖未安装/路径错误
TS7006 隐式 any 缺少类型注解
TS2322 类型不可赋值 类型不兼容

Go

错误 常见原因
undefined 变量/函数未声明
cannot use X as Y 类型不匹配
imported but not used 未使用的导入
declared but not used 未使用的变量

Python

错误 常见原因
ImportError 模块未安装/路径错误
TypeError 类型不匹配
SyntaxError 语法错误
AttributeError 属性/方法不存在

诊断流程

Step 1: 收集错误信息

# TypeScript
npx tsc --noEmit 2>&1

# Go
go build ./... 2>&1

# Python
python -m py_compile file.py 2>&1

# Rust
cargo build 2>&1

Step 2: 解析错误结构

文件路径:行号:列号: 错误码: 错误描述

Step 3: 定位根因

  1. 读取错误文件
  2. 分析错误上下文
  3. 识别缺失的依赖/类型/导入

Step 4: 生成修复

  • 优先使用 Edit 工具进行最小改动
  • 不改变无关代码
  • 保持代码风格一致

Step 5: 验证修复

# 重新构建验证
npm run build  # 或对应的构建命令

常见问题解决模式

模式 1: 缺少类型定义

// 错误: Cannot find name 'Request'
// 修复: 添加导入
import { Request } from "express";

Read the full file on GitHub · 243 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. 1mo ago First seen · 243 lines · 88 tokens per session scan A 428c727508e6

Subscribe to this mod's changes

build-error-resolver is an agent published in the GitHub repository xiaobei930/cc-best (48 stars, last pushed 4mo ago), licensed MIT. It adds 88 tokens to every session and 1,586 once invoked, about $0.0004 per session on Opus 5.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

guide-reviewer

Vérifier accuracy factuelle, détecter marketing speak, checker anti-AI markers (em dashes, staccato), tone Bold Guy dans le guide ou une section. Retourne une liste de findings classés par type. Use when reviewing newly added guide content before committing.

FlorianBruniaux/claude-code-ultimate-guide · 61 tokens

claude-code-guide

Expert on the Claude Code Ultimate Guide. Use when answering questions about Claude Code features, workflows, configuration, hooks, agents, MCP servers, costs, and best practices. Searches the guide before answering. Cites file + line sources.

FlorianBruniaux/claude-code-ultimate-guide · 52 tokens

whitepaper-journalist

Review d'un livre blanc dans le style d'un journaliste expérimenté. Analyse critique, style direct, recommandations éditorialistes. Utiliser pour avoir un regard externe avant publication.

FlorianBruniaux/claude-code-ultimate-guide · 41 tokens

whitepaper-coherence

Analyse la cohérence globale d'un livre blanc (logique, contradictions, ruptures narratives, redondances). Utiliser pour auditer un whitepaper avant publication.

FlorianBruniaux/claude-code-ultimate-guide · 39 tokens

whitepaper-density

Analyse le ratio valeur/remplissage d'un livre blanc. Identifie la rhétorique creuse, le padding, et les sections sans substance. Utiliser pour densifier un whitepaper avant publication.

FlorianBruniaux/claude-code-ultimate-guide · 45 tokens

evidence-reviewer

Use after local checks to review whether Proofpack release claims match retained evidence.

FlorianBruniaux/claude-code-ultimate-guide · 20 tokens