用途:为 Letta Code 本地 mod 创建被 /mods learn --env=<path> 或 bun scripts/mod-learning/learn-mod.ts --env <path> 消费的 JSON 学习环境。环境描述要学习的 mod 行为,以及用于给候选打分的情景套件评测。
主要能力:先定义行为与评测,再写 JSON;支持仓库示例路径 docs/examples/mods/learning/<slug>.env.json 或用户指定路径;提供模板 assets/mod-learning-env.template.json;要求严格 JSON,无注释与尾逗号。
必要用法:用 bun src/skills/builtin/generating-mod-envs/scripts/validate-mod-env.ts path/to/env.json 校验;若技能装在源码树外,从技能目录运行 scripts/validate-mod-env.ts。运行学习可用 /mods learn --env=path/to/env.json --model=auto --backend=api --out=/tmp/<slug>-learn;learn-mod.ts 默认分离,需阻塞退出码时加 --foreground。TUI 指令用单行 --flag=value。
环境结构:必填顶层字段 name、slug、objective、requirements、evaluation;可选 targetModName、candidateDiversityHints、modApiHints、examples。评测字段含 outputFormat、timeoutMs、maxTurns、memoryFiles、scenarios[],以及 requiredResultMarkers、requiredTraceMarkers、forbiddenResultMarkers、forbiddenTraceMarkers。
质量规则:先设计评测,使用唯一哨兵字符串,种子化 memoryFiles,加入负控制与区分场景,把加载失败放入 forbiddenTraceMarkers,避免过脆弱的 trace 标记。
限制:资料未提供收费、价格、平台支持范围等信息。