Show HN: Gauge – 开源 CLI 以递归方式改进您的文档

用于登山代理体验的开源 CLI。让您的技能、CLI、SDK、MCP 和文档更易于编码代理发现和使用。 Gauge 针对您的产品运行真实的代理，捕获它们遇到问题的地方，并让您自己的编码代理在发布修复之前测试修复。完整循环使用 Docker 和现有代理订阅或 API 密钥在本地运行。无需计量账户。网站·文档·托管仪表·npm·变更日志登录并选择您的组织来访问聊天数据：仪表身份验证登录仪表组织使用acme仪表聊天类别列表仪表聊天查询数据集聊天命令涵盖主题、提示、标签、品牌、报告、答案和引文。请参阅 Gauge Chat 命令以及组织选择和升级指南。这些命令使用托管的聊天数据，不需要 Docker。 Gauge 运行并分析编码会话，以查找编码代理遇到的问题。常见的发现包括： 交互式命令阻止编码代理 代理使用已弃用的命令或过时的 API 模式 即使技能应该有助于完成任务，但技能却未使用 代理自信地声称存在不存在的限制 代理无法确定跨多个命令的预期工作流程 正确的修复可能会更改错误消息、技能内容、帮助文本、代码或文档。 Gauge CLI 允许您在发布之前验证建议的修复。仪表设计供您的编码代理使用。将其指向此存储库并要求它开始，或者在您想要改进的项目中按照以下步骤操作。您需要 Node.js 22.13+、npm、运行 Linux 容器的 Docker 以及要测试的代理的凭据。 Gauge 支持 Claude Code、Codex、Pi 和 OpenCode。它可以使用本机 Claude/Codex 登录或 API 密钥；代理使用量通过您的提供商或订阅进行计费。 1. 安装 Gauge 及其运行时 npm install -g @withgauge/cli gauge 本地运行时 pull Gauge 下载固定到 CLI 版本的已发布 Docker 映像。该映像包含代理工具和标准开发工具。从您的项目目录（Git 是可选的）：这将创建一个私有的 .gauge/ 工作区，包括 SQLite 数据库和本地后端首选项。普通初始化不会更改跟踪文件。当您想要共享 Markdown 案例时添加 --cases ：它还会在 AGENTS.md 中写入 gauge.json 清单、gauge-cases/ 和指南。提交那些共享文件。保持 .gauge/ 私有：它包含持久的测量和分析。仪表技能会告诉您的编码代理在哪里可以找到 CLI 的指令： 改进循环如何工作 爬山意味着做出改变，衡量它是否有帮助，然后重复。定义现实的任务。您的代理会保存具有稳定身份、可编辑默认值和可观察结果的评估或偏好提示。使用可选的 Markdown 案例进行用于共享或 CI 的完全指定的测量。测试您当前的产品。在本地模式下，Gauge 启动新的 Docker 会话并注入配置输入的工作树版本。每个测试代理都会看到其沙箱中的任务和配置的输入。本地模式支持技能、SDK、CLI 和文件。托管计算增加了对文档、经过身份验证的 MCP 和经过身份验证的 API 的支持。寻找摩擦力。 Gauge 将 Claude Code、Codex、Pi 和 OpenCode 中的事件标准化为一致的记录。在本地模式下，您的代理会读取证据，根据标准检查结果，并确定是什么减慢或阻止了任务。它通过仪表运行分析保存来发布结构化的调查结果和判断。在托管模式下，此分析会在每次会话后自动进行。仪表运行洞察显示了证据。更改并重新测试。您的代理编辑产品或其指南，并针对新工件重新运行受影响的案例。分析证据。检查原来的问题是否消失，任务是否成功，以及更改是否引入了新的摩擦。技能和文件输入是从您的工作树中读取的。对于 npm CLI 或 SDK，请在重新运行之前构建并打包新的 tarball。 Gauge 在测试会话中安装这些预发布工件，因此您可以在发布修复之前对其进行验证。 CLI 处理执行和证据收集。在本地模式下，您的编码代理编写更改并分析本地结果。保存的评估和首选项提示位于本地或托管组织中的 .gauge/gauge.sqlite 中。基于共享文件的案例可以选择存在于 gauge-cases/ 中； gauge.json 声明项目输入和自动化。两种测量源都支持本地和托管执行，输入差异如下所述。从保存的本地评估开始；当任务为队友或 CI 做好准备时，使用共享案例。示例：测试发布说明技能 创建技能/发布说明/SKILL.md : --- 名称 : 发布说明 描述 : 以团队格式为新版本编写发布说明。 --- 编写 RELEASE-NOTES.md，以版本为标题，添加新功能的部分