速查表 · 常见错误 · 阅读指南

A 核心概念速查表

概念	一句话	文件位置
instructions.md	常驻系统提示	agent/instructions.md
agent.ts	模型与运行时配置	agent/agent.ts
tools/	类型化工具，文件名即工具名	agent/tools/*.ts
skills/	按需加载的操作手册	agent/skills/*.md
subagents/	子 Agent，独立上下文	agent/subagents/*/
channels/	多入口（Slack/Discord/Web）	agent/channels/*.ts
sandbox/	隔离执行环境	agent/sandbox/sandbox.ts
connections/	外部 MCP/OpenAPI 连接	agent/connections/
schedules/	定时任务	agent/schedules/*.ts
hooks/	生命周期钩子	agent/hooks/

B 常见错误与解决方案

问题	原因	解决
eve init 报引擎错误	Node 低于 24	nvm install 24 && nvm use 24
工具不被调用	文件名非 snake_case	改成 get_weather.ts
子 Agent 看不到 skill	子 Agent 不继承 root skills	在子 Agent 目录放一份
改了 instructions 行为变了	没跑评测	把 evals 接进 CI
沙箱里删了项目文件	没区分 /workspace 与源码	产物写进 /workspace

阅读指南

时间	章节	目标
Day 1	§01-§03	从零到第一次跑通
Day 2-3	§04-§08	掌握核心能力
Day 4	§09-§10	进阶实战与评测
Day 5	§11 + 附录	做判断与查漏