Agent 教程

外观

第 6 章研究笔记 ​

关键源码 ​

  • restored-src/src/commands.ts
  • restored-src/src/tools/SkillTool/SkillTool.ts
  • restored-src/src/skills/loadSkillsDir.ts
  • restored-src/src/services/mcp/
  • restored-src/src/utils/plugins/
  • restored-src/src/state/AppStateStore.ts
  • restored-src/src/screens/REPL.tsx
  • restored-src/src/components/
  • restored-src/src/ink/

架构提炼 ​

Commands 是人类入口，Skills 是模型可按需加载的能力手册，MCP 是外部工具总线，Plugins 是可安装的扩展包，UI 状态负责让长任务可观察。

值得学习：

  • commands 加载可 memoize，但可用性要动态判断。
  • skills 先暴露短描述，真正使用时再加载完整说明。
  • MCP 连接状态要建模。
  • plugin 要有命名空间和敏感配置替换规则。
  • UI 状态要表达权限等待、后台任务、工具进度和扩展状态。

谨慎照搬：

  • 插件市场、自动更新、自研 Ink renderer、全部 MCP transport 都是后期复杂度。
  • 一个巨大 AppState 早期会变成全局共享总线。