开源 CLI 工具 Gauge 改进文档

Gauge 是一个开源的命令行工具，用于递归地改进文档。它可以让编码代理更容易发现和使用技能、CLI、SDK、MCP 和文档。Gauge 运行真实代理针对你的产品，捕捉它们卡住的地方，并让你的编码代理在发布之前测试修复方案。完整的流程可以在本地使用 Docker 和你现有的代理订阅或 API 密钥运行，无需 Gauge 账户。

Gauge 运行和分析编码会话以找到编码代理遇到的问题。常见发现包括：交互式命令阻止编码代理、代理使用已弃用的命令或过时的 API 模式、技能即使应该有助于任务也未使用、代理自信地声称不存在限制、代理无法弄清楚跨多个命令的预期工作流程。正确的修复可能会改变错误消息、技能内容、帮助文本、代码或文档。Gauge CLI 允许你在发布之前验证提出的修复方案。

Gauge 设计为被编码代理使用。指向这个存储库并要求它开始，或者在你想要改进的项目中按照以下步骤操作。你需要 Node.js 22.13+、npm、运行 Linux 容器的 Docker 以及你想要测试的代理的凭证。Gauge 支持 Claude Code、Codex、Pi 和 OpenCode。它可以使用原生 Claude/Codex 登录或 API 密钥；代理使用通过你的提供者或订阅计费。

1. 安装 Gauge 和其运行时：npm install -g @withgauge/cli gauge local runtime pull Gauge 下载固定到你的 CLI 发布的已发布的 Docker 镜像。该镜像包含代理支架和标准开发工具。

2. 设置你的项目：从你的项目目录（Git 是可选的）：gauge init --local 这会创建一个私有的 .gauge/ 工作区，包括 SQLite 数据库和本地后端偏好。Plain init 不会更改任何跟踪的文件。当你想要共享 Markdown 案例时添加 --cases：它还会写入 gauge.json 元表示、gauge-cases/ ，以及 AGENTS.md 中的指导。提交这些共享文件。保持 .gauge/ 私有：它包含持久的测量和分析。

3. 安装技能：Gauge 技能教你编码代理在哪里找到 CLI 的说明：gauge install-skill

改进循环的工作原理：爬坡意味着做一个改变，测量它是否有所帮助，然后重复。定义现实的任务。你的代理保存带有稳定身份的 evals 或偏好提示、可编辑的默认值和可观察的结果。使用可选的 Markdown 案例用于完全指定的测量，旨在共享或 CI。测试你当前的产品。在本地模式下，Gauge 启动新的 Docker 会话并注入配置输入的工作树版本。每个测试代理在其沙盒中看到任务和配置的输入。本地模式支持技能、SDK、CLI 和文件。托管计算添加了对文档、认证 MCP 和认证 API 的支持。

找到摩擦。Gauge 将 Claude Code、Codex、Pi 和 OpenCode 的事件标准化为一致的文字。在本地模式下，你的代理阅读证据，将结果与标准进行比较，并确定什么减缓或阻止了任务。它通过 gauge run analysis save 发布结构化的 Findings 和判断。在托管模式下，此分析在每个会话后自动发生。gauge run insight 显示证据。

改变并重新测试。你的代理编辑产品或其指导并重新运行受影响的案例针对新的工件。分析证据。检查原始的 pro