让两个陌生 Claude Code 子代理实测 API 文档，揪出 16 处问题
Unusual-Albatross43 · reddit · 2026-10-27
作者在其开源项目 Angelia(本地网关，连接 WhatsApp/Telegram 与 Mac 上的编码 agent CLI)发布文档化 API 前，用两个从未见过项目的 Claude Code 子代理(Sonnet 和 Haiku)做冷启动测试:只给用户请求和 llms.txt 起始链接，不给源码，对真实 daemon 运行。
结果:两者都写出了可用脚本——Sonnet 用 6 次工具调用写出 Python,Haiku 用 11 次写出 Node。共发现 16 个文档问题，修复 12 个。代价最大的坑:
- 核心流程只存在于示例代码中，「打印跟随你 turn 事件的 out 事件」这类描述易误读，现已改为 4 步编号说明
- 未记录的副作用:任务答案默认也会发到真实聊天，只想取结果的脚本会误发消息
- 缺少 Unix socket 的标准库 Python 示例(quick start 只有 curl)，已补上并配测试
- 历史分页的两处描述互相矛盾——这会导致错误代码而非仅仅是慢
- 链接指向三处(站点、GitHub main、release tag)让冷启动 agent 怀疑规格缺失
作者询问是否有人在 CI 中定期跑这种「冷 agent 对文档」测试。
「编程与Agent」频道最新
- 把一切接入 Dot:达人分享突破 ChatGPT 订阅额度限制的用法 — teortaxesTex · 2026-10-27
- UCSB 教授王骁连获三笔超 18 万美元资助，推进实用高效主动式 AI Agent — xwang_lk · 2026-10-27
- 开发者观点：生成式游戏不必实时渲染，回合制交互同样可行 — djcows · 2026-10-27
- 用 Claude 三周重制《街霸2》HD，token 花了 3000 美元 — Fantastic-Jeweler781 · 2026-10-27
- 求职作品集反向工程法：先用 Agent 调研面试官，再定作品要传达的一两个亮点 — brandon_galang · 2026-10-27
- 给 AI 一台无隐私裸机 24/7 放养：比任何 agent 课程学得都多 — EXM7777 · 2026-10-27