内容
# 巴克利
[](https://pkg.go.dev/m31labs.dev/buckley)
[](https://github.com/odvcencio/buckley/actions/workflows/ci.yml)
[](https://github.com/odvcencio/buckley/actions/workflows/release.yml)
巴克利是一款工具优先的AI代理，用于处理严肃的仓库工作。
它结合了可恢复的会话、Arbiter管理的模型和工具选择、类似Claude的仓库指令，以及多个操作界面：终端、浏览器、一次性、ACP和LSP。
## 代理技能
与巴克利合作的代理应使用 [使用巴克利](https://github.com/odvcencio/m31labs-skills/blob/main/skills/using-buckley/SKILL.md) 技能。
## 为什么选择巴克利
- 一个共享的运行时支持TUI聊天、`buckley -p`、无头会话、ACP编辑器流程和浏览器控制。
- Arbiter管理计划/执行/审查模型路由、推理努力、工具池、超时、批准和升级。
- 运行时提示程序集自动拉取`AGENTS.md`、`CLAUDE.md`、`.claude/instructions.md`、项目上下文和活动技能。
- 工具使用是一等公民。巴克利自带38个内置工具入口点，以及技能、插件、遥测、批准和基于SQLite的持久性。
- 会话在崩溃后存活。计划、批准、遥测和工件保持可恢复。
## 快速入门
```bash
go install m31labs.dev/buckley/cmd/buckley@latest
export OPENROUTER_API_KEY="your-key"
buckley
```
也支持OpenAI、Anthropic、Google和Ollama。当可用时，OpenRouter是默认路径。
## 接口
| 界面 | 命令 | 用例 |
| --- | --- | --- |
| TUI | `buckley` | 具有批准、流式传输和历史记录的交互式编码 |
| 一次性 | `buckley -p "检查此仓库并修复失败的测试"` | 终端上的快速任务执行 |
| 浏览器界面 | `buckley serve --browser` | 任务控制、批准和远程会话控制 |
| ACP代理 | `buckley acp` | ACP兼容客户端的编辑器代理 |
| LSP桥接 | `buckley lsp` | stdio上的LSP编辑器集成 |
## 核心工作流程
```bash
buckley plan "添加身份验证" "支持电子邮件/密码登录"
buckley execute <计划ID>
buckley review
buckley review-pr 123
```
计划器、构建器、审查和运行时层共享相同的治理堆栈、持久性和工具注册表。
## 1.1.0 新增功能
- 跨一次性、TUI、ACP和无头执行路径完全集成的Arbiter运行时。
- 用于仓库指令、项目上下文、工作目录和技能的共享运行时程序集。
- 具有角色/任务感知池过滤的受控工具暴露，在工具调用显示给模型之前。
- Anthropic工具调用和工具结果往返，以便Claude类模型可以参与相同的工具循环。
- 改进的模型解析，用于路由原始ID，例如不合格的Claude模型名称。
## 人们实际使用的命令
```bash
buckley commit
buckley pr
buckley review
buckley review-pr 123
buckley hunt
buckley dream
buckley experiment run "compare-routing" -m z-ai/glm-5.2 -m moonshotai/kimi-k2.7-code -p "实现功能X"
```
`buckley review` 检查选定本地范围的一个不可变快照。默认情况下，不跟踪的文件被排除；重复 `--include-untracked path/to/new.go` 以显式允许可能发送到模型的 工作树文件，在检查它们是否存在机密后。本地代码验证接收仅捕获的提交和补丁的自包含副本；其 JSONL 命令事件必须证明成功、可分类的构建和测试运行，涵盖更改的源路径。API 模型检查工具根植于独立物化的该快照的副本，并且只能在 OS 强制的只读源沙箱中运行确定性的构建/测试/检查计划。`buckley review-pr` 添加远程 PR 差异、CI 状态、提交的审查和未解决的内联反馈；从其 `HEAD` 是 PR 头的检出运行它，以便验证固定到相同的修订版。API 批准需要实际成功的验证工具调用 - 而不是声明 PASS 的文本 - 并且构建/测试证据必须使用一个适用的工具链并涵盖每个更改的源包。分支和 PR 批准需要通过验证、完整的证据、每个提供的反馈 ID 的明确处置以及独立的批准批评者传递。`buckley review -project` 是咨询性架构评估，无法发出批准裁决。`buckley commit` 和 `buckley pr` 使用透明的工具优先工作流程，而不是不透明的文本优先提示。
## 配置
配置是分层的：
```text
~/.buckley/config.yaml
./.buckley/config.yaml
环境变量
```
最小设置：
```yaml
providers:
openrouter:
api_key: ${OPENROUTER_API_KEY}
```
巴克利支持单独的规划、执行和审查模型：
```yaml
models:
planning: z-ai/glm-5.2
execution: z-ai/glm-5.2
review: moonshotai/kimi-k2.7-code
reasoning: xhigh
```
## 技能和指令
巴克利自带8种捆绑技能，包括规划、代码审查、系统调试、重构、测试驱动开发、API设计、git工作流和创意写作。
技能建立在仓库指令之上。如果仓库已经使用`AGENTS.md`或`CLAUDE.md`，巴克利会自动使用它们，并在终端、无头和编辑器会话中应用相同的指导。
## 开发
```bash
./scripts/test.sh
go build ./cmd/buckley
```
主要仓库文档位于 [`docs/`](/home/draco/work/buckley/docs)。
## 许可证
MIT。参见 [LICENSE](LICENSE)。
