用途:当编码智能体需要从 Terrain 的 .terrain/ 资产获取项目知识时使用,指导按分层顺序读取上下文、私有知识与 repomix 索引。
主要能力与分层:一、架构层 .terrain/agent/context.md,包含模块图、核心流程、系统边界与技术栈,可直接读取;二、私有领域层 .terrain/knowledge/**/*.md,包含业务术语、内部框架、API 与脚手架指南,调研时按文件名排序读取;三、结构化元数据 .terrain/agent/meta-inputs.md;四、源码索引见 repomix-context-skill。回答架构问题前必须检查新鲜度: ~/.terrain/bin/terrain tools freshness --project <slug> 或 bunx @terrain-ai/cli tools freshness --project <slug> 分数 <50 不依赖宏观上下文,改用 repomix-context-skill;50–69 用 repomix grep 或 codegraph-skill 交叉验证;≥70 架构上下文通常可靠。冲突时优先级:repomix 源码切片 > codegraph > agent/context.md > human/。
查询流程:任务接收 → 新鲜度检查 → 读取 context.md → 业务/内部术语读 knowledge/*.md → 符号/调用图用 codegraph-skill → 实现/源码用 repomix-context-skill → 需要 shell/git/测试用 rtk-skill。
规则:不得编造与 context.md 或 meta-inputs.md 冲突的模块名;已有索引资产时不要读取整个实时仓库树;不要把完整 repomix.md 载入上下文,只 grep 切片;优先 .terrain/ 而非猜测项目结构。
私有知识目录 .terrain/knowledge/ 由开发者添加 markdown,Terrain 在生成上下文时扫描。人类文档 .terrain/human/ 由 Litho 生成,适合入门但比 context.md 更密集。相关技能包括 repomix-context-skill、codegraph-skill、rtk-skill。
限制:资料未提供安装命令之外的更多细节,未说明收费或平台信息。