Micro Agent

一个为你编写并修复代码的 AI 智能体。

Demo

只需运行 micro-agent，输入提示词（prompt），它就会生成测试用例，并反复迭代代码直到所有测试用例通过。

为什么选择它？

LLM（大语言模型）非常擅长为你提供存在缺陷的代码，通常需要反复迭代才能使代码达到预期效果。

既然 AI 不仅能处理生成，还能处理迭代和修复，何必还要手动去完成这些工作呢？

为什么是“微”智能体（Micro Agent）？

AI 智能体固然很酷，但通用的编程智能体往往达不到预期或承诺的效果。它们倾向于在复合错误中变得混乱。想象一下你的扫地机器人在桌子底下被卡住，然后这种状况乘以 1000 倍。

微智能体的核心理念是：

创建一个明确的测试用例，以便清晰地反馈代码是否按预期工作。
反复迭代代码，直到所有测试用例通过。

点击了解更多关于为什么会有 Micro Agent。

本项目不是什么

本项目并不试图成为一个端到端的开发者。AI 智能体目前（或在短期内）还不具备胜任这项工作的足够能力。本项目不会安装模块、读写多个文件，也不会做任何在失败时极有可能导致混乱的事情。

它是一个微智能体。它小巧、专注，并尽可能把一件事做好：编写测试，然后产出通过该测试的代码。

安装

Micro Agent 需要 Node.js v18 或更高版本。

npm install -g @builder.io/micro-agent

快速开始

最好的入门方式是以交互模式运行 Micro Agent，它会询问有关生成代码的问题，并利用你的反馈来改进生成的代码。

micro-agent

看，你现在已经是一名测试驱动的开发者了。不客气！

手动运行

添加 LLM API Key

Micro Agent 支持 Claude、OpenAI、Ollama 或任何兼容 OpenAI 的提供商（如 Groq）。你需要将 API Key 添加到 CLI 中：

micro-agent config set OPENAI_KEY=
micro-agent config set MODEL=gpt-4o

或者使用 Claude：

micro-agent config set ANTHROPIC_KEY=
micro-agent config set MODEL=claude

如需使用自定义 OpenAI API 端点（例如 Ollama 或 Groq），你可以通过以下方式设置：

micro-agent config set OPENAI_API_ENDPOINT=
micro-agent config set OPENAI_API_ENDPOINT=https://api.groq.com/openai/v1

单元测试匹配

Demo

要在单元测试匹配模式下对文件运行 Micro Agent，你需要提供一个在每次代码生成尝试后运行的测试脚本。例如：

micro-agent ./file-to-edit.ts -t "npm test"

这将在文件 ./file-to-edit.ts 上运行 Micro Agent，执行 npm test，并不断重写代码直到测试通过。

上述命令假设文件结构如下：

some-folder
├──file-to-edit.ts
├──file-to-edit.test.ts # 测试文件。如果需要不同路径，请使用 -f 参数
└──file-to-edit.prompt.md # 可选的 prompt 文件。如果需要不同路径，请使用 -p 参数

默认情况下，Micro Agent 假设你有一个与要编辑的文件同名但后缀为 .test.ts 的测试文件（例如上述示例中的 ./file-to-edit.test.ts）。

如果情况并非如此，你可以使用 -f 标志指定测试文件。你还可以添加一个 prompt 来指导代码生成，既可以放置在名为 .prompt.md 的文件（如 ./file-to-edit.prompt.md）中，也可以通过 -p 指定 prompt 文件。例如：

micro-agent ./file-to-edit.ts -t "npm test" -f ./file-to-edit.spec.ts -p ./path-to-prompt.prompt.md

视觉匹配（实验性功能）

Visual Demo

[!WARNING] 此功能处于实验阶段，正在积极开发中。请谨慎使用。

Micro Agent 还可以帮助你匹配 UI 设计。为此，你需要提供设计图和渲染代码的本地 URL。例如：

micro-agent ./app/about/page.tsx --visual localhost:3000/about

Micro Agent 将生成代码，直到代码的渲染输出与你放置在编辑文件旁边的截图文件（本例中为 ./app/about/page.png）尽可能匹配。