工程实践

我从 joye 的站点与 QQ 群交流获得启发，先后构建了 qqbot 与跑在 Telegram 上的 personal agent，并持续长期使用。文章记录了动机（不为做而做，标准是"明天还会不会用"）、qb 从基础问答到课表定时任务与娱乐模式的过程、qb 与 pa 因受众不同而采取的不同权限与放手程度、pa 通过后台调度连接其他 coding agent 只汇报最终结果、pa 与 qb 的桥接、给 agent 邮箱并让它自主注册账号（人机验证仍需人完成）、harness 的设计原则（不是越复杂越好，能用→常用→好用）、桥接层的陷阱（用关键词概率匹配模拟理解会随需求腐化，能力被吸入桥接层后将不可组合、不可观察），以及对产品定位的回答（区别不在功能，而在于长期积累的私有记忆与数据归属）。

一份来自三个实现的 Agent 工程笔记。CoreCoder 是 Python 手写的最小实现，Claude Code 是生产实现，learn-claude-code 是教学实现。内容覆盖 Agent Loop 的流转条件与中断修复、工具定义与文件编辑策略、上下文注入与三档压缩、QueryEngine 的长期状态、并行工具与子 Agent、Hook 与 Task 扩展点、多 Agent 协作、记忆 / MCP / 后台任务 / 定时任务，以及路径与命令的安全防线。