跳转至

社区路线图

这本书已经有了很强的基础：架构、安全、记忆、执行、可观测性、组织模型，以及一个可运行的参考包。因此，下面不是通用愿望清单，而是下一层价值的待办。

已经完成的部分

如何选择下一步

下面每一项都满足三个条件：

  • 可以很快用于真实工作；
  • 帮助的是整个社区，而不只是作者本人；
  • 提升的是国际可读性，而不只是技术深度。

接下来的 10 个改进

1. 扩展案例研究集合

现有案例已经有用了，但还应该再补 2-3 个：

  • 企业工作流智能体；
  • 客户关系管理/任务智能体；
  • 安全敏感助手。

为什么重要：可识别场景越多，读者越容易把书里的架构映射到自己的系统上。

2. 扩展策略模板集合

书里已经有第一批例子，但社区还需要更明确的模板：

  • 工具审批策略；
  • 记忆写入策略；
  • 出口策略；
  • 发布门禁策略；
  • 检索策略。

为什么重要：可复制、可改造的模板，往往比长篇解释更有价值。

3. 更丰富的追踪示例与视觉 QA

追踪 Schema 与事件目录已经存在。下一步是让它们更容易验证和阅读：

  • 增加更真实的 JSONL 追踪示例；
  • 展示成功运行、等待审批、被策略拒绝和失败运行；
  • 确保渲染后的 schema 页面没有破损表格、粘连列表或 raw diagram blocks；
  • 为最显眼的页面增加轻量级 rendered-site QA checklist。

为什么重要：当社区既有统一事件模型，也能看到它在发布站点里的具体样子时，可观测性才会真正形成共享实践。

4. 扩展 agent_runtime_ref 的真实场景

参考包已经有用了，但下一步还应该补上：

  • 一个知识场景；
  • 一个带审批的高风险场景；
  • 一个被策略拒绝的场景；
  • 在文档里放几份 JSONL 追踪示例。

为什么重要：可运行的参考包不该只展示顺利路径，它应该教会读者生产环境里的真实行为。

5. 面向社区的贡献套件

要让外部贡献更容易：

  • 一页“如何贡献模式”；
  • 一个案例研究模板；
  • 一个术语表条目模板；
  • 一个策略模板模板。

为什么重要：好的开放手册会成长得更快，前提是贡献者知道该怎么帮忙。

6. 更强的内链与章节旅程

需要让章节之间的移动更顺：

  • 更明确的 “下一步读什么”；
  • 架构、案例和模板之间更强的互链；
  • 每个部分内部更短的决策路径。

为什么重要：这本书越不容易让人迷路，它的实际价值就越高。

7. 可发现性层

需要更系统的可发现性改进：

  • 术语表；
  • 速查表；
  • 更强的章节内链；
  • 社交预览素材；
  • ru/en/zh 三语更结构化的落地页文案。

为什么重要：即使书本身很强，如果别人难以发现、难以快速理解、难以转发，它对社区的帮助也会打折扣。

8. 社交与分享素材

需要一些轻量的传播素材：

  • 社交预览素材；
  • 几张适合转发的速查表；
  • ru/en/zh 的简短落地页摘要。

为什么重要：国际传播不只取决于内容本身，也取决于它是否方便分享。

最该先做什么

如果接下来只能做三件事，我会这样排：

  1. 更丰富的追踪示例与视觉 QA
  2. 贡献套件
  3. 扩展案例研究集合

这是在不重写架构章节的前提下，最快提升实际价值的组合。

一个月后会带来什么变化

如果把这份待办落下来，项目会获得：

  • 对新读者更清晰的入口；
  • 更多可被引用和分享的页面；
  • 更多团队可以直接复用的材料；
  • 更清晰的社区参与路径；
  • 更强的国际化项目形象。

下一步最实用的动作

如果按这条路线走，下一步最值得做的是更丰富的追踪示例与视觉 QA，接着是贡献套件。