用途:通过本地 hillclimb CLI 配置、运行、检查、创建检查点或恢复迭代式工作区改进循环,而不是手工编辑 .hillclimb/ 内部文件、自造私有归档命令,或把内置 Flow 适配器当作完整产品契约。
主要能力:优先使用显式公共命令面:hillclimb init、hillclimb validate、hillclimb run、hillclimb checkpoint、hillclimb restore、hillclimb ui、hillclimb doctor。单独的 hillclimb 仅提供帮助。validate 与 run 必须存在 .hillclimb/config.yaml,由 init 创建,命令从当前目录或 --workspace PATH 读取;顶层 agent、eval、strategy 引用需显式且为带 use 的对象形态。需要计划运行形态与就绪状态而不创建 .hillclimb/runtime/ 时,用 hillclimb validate --workspace <path> --json;需要环境或适配器诊断且配置可能缺失时用 doctor。
使用方式:想从当前实时编辑继续时直接用 hillclimb run,运行时会按需自动协调工作区后再试跑;只想归档实时编辑而不运行配置的 agent、eval 或 strategy 时用 checkpoint;用 restore 丢弃实时工作区编辑或回退活动历史。需要真实签入的基准运行或复现时,优先 pnpm examples:list 与 pnpm example:run -- <example-name>。使用内置 flow、harbor 或 gepa 适配器细节前先查 CLI 指南,精确的提供方与运行时前置条件在其中。
参考与限制:权威命令与配置指南见 references/docs/cli.md(作者仓库树中为 docs/cli.md);产品本地验证、示例运行器、实时冒烟与发布命令见 references/docs/testing.md。改进 CLI 与技能面时使用 evals/evals.json 与 evals/README.md,评估材料须保持对 hillclimb 通用。.hillclimb/ 为 CLI 自有的私有状态,调试时可查看,但除用户明确要求低层恢复外不要手工编辑归档文件。具体命令参数与配置字段以同步参考为准,本介绍不展开。