用途:围绕 Ralph Orchestrator 回答“某功能如何工作”、解释观察到的行为(如循环因 max_iterations 终止、hat 未触发)、为代码库改进定位范围、对 bug 报告分诊,以及解答新用户的上手问题。核心原则是把 llms.txt 当作路由器而非全文转储:先发现顶层章节(Getting Started/Concepts/User Guide/Advanced/API/Examples/Contributing/Reference),再缩小到 1–3 个相关页面,优先使用地图直链的 .md 版本而非抓取 HTML,最后基于所读内容作答并附来源 URL。
使用方式:先按子系统分类(hats、event loop、memories、tasks、backends、presets、CLI、TUI、diagnostics、waves、API)定位问题;若 ~/.cache/ralph-docs/llms.txt 存在且不足 7 天则复用,否则重新获取:
mkdir -p ~/.cache/ralph-docs
curl -sSfL https://mikeyobrien.github.io/ralph-orchestrator/llms.txt
-o ~/.cache/ralph-docs/llms.txt
再抓取相关页面:curl -sSfL <url> -o ~/.cache/ralph-docs/<stem>.md;有 web_fetch 等工具的应用之。回答用户“Ralph 是否做 X”时引用相关原文句子。若需代码改动,切换到 ralph-orchestrator 检出仓库并按 references/contributing.md 流程操作。
限制与边界:该技能只负责解答与解释;创建或修改用户 hats 交给 ralph-hats,操作运行中的循环(运行、恢复、合并、调试)交给 ralph-loop,对 ralph-orchestrator 本身的代码编辑使用智能体原生编辑工具。不得编造文档中不存在的功能;文档未覆盖时应说明并建议查看源码仓库。对版本敏感内容(CLI 标志、preset 名称)不要依赖预训练,需对照 guide/cli-reference.md 或 reference/changelog.md 核实。文档与本地安装版本冲突时提示不一致并建议运行 ralph --version。文档抓取页缓存于 ~/.cache/ralph-docs/,7 天过期;引用文档前先重取 llms.txt 以发现重命名或移动。提出代码改进前应先阅读 concepts/tenets/index.md。输出上先给答案再给链接,非平凡结论至少附一个来源 URL。