教学版 Agent 代码与生产系统缺失的治理能力差距
风险描述
learn-claude-code 仓库是社区教学实现，明确以"理解 Agent 内部机制"为目标，而非交付生产可用的 Agent 系统。仓库自我声明省略或简化了完整 Hook 总线、生产级权限治理、resume/fork 生命周期、完整 MCP 运行时；团队协作的 JSONL 邮箱是教学协议。把教学代码直接搬到生产环境，会缺失关键治理能力。
缺失或简化的能力
- 权限治理：未实现细粒度的命令白名单、用户授权与危险操作拦截。
- 审计与日志：仅有基础打印，缺乏可检索、可追溯的结构化日志。
- 恢复与续跑：缺乏完整 resume/fork 生命周期支持，长任务中断后难以接续。
- 凭证管理：API Key 等敏感信息的存储与轮换由使用者自行负责。
- 错误隔离：教学代码未覆盖错误在多个 Agent / worktree 之间的隔离与降级。
- 通信协议：JSONL 邮箱不是生产级通信标准，可能丢消息、缺乏 ACK 与重试。
在生产环境中可能引发的问题
- 误删文件、误执行危险命令。
- 凭证泄露或被上传到代码仓库。
- 长任务中断后无法恢复，浪费大量 API 费用。
- 团队协作协议丢消息或多 Agent 互相覆盖。
建议的人工复核与缓解
- 在投入生产前补充权限白名单、超时与中断策略。
- 把工具调用、模型决策、最终结果结构化记录并落入审计存储。
- 使用专门的凭证管理方案（环境变量注入、密钥管理服务）。
- 用生产级消息队列替代教学版 JSONL 邮箱。
- 在隔离环境（容器、临时 worktree）下先验证再合并。
相关页面
- 教学仓库：learn-claude-code（从最小循环到完整 Harness 的中文教学仓库）
- 教程摘要：Learn Claude Code——从最小循环到完整 Harness（shareAI-lab 教学仓库教程摘要）
- 教学对象工具：Claude Code
- 配套风险：把教学实现的协议与结构误认为 Claude Code 官方源码或架构