两万五千个小时

给 Agent / LLM 应用开发者、系统架构师：这篇不是“做了什么”，而是“为什么这么做”的绝佳范例，工程实现与产品体验的取舍逻辑比源码本身更值钱。

为什么你的 Agent 读了文件，却好像什么都没读到？ 先说两个场景，你可能都踩过 场景一：幽灵型（更隐蔽，更多人踩） 我让 Agent 分析一份服务器日志，找出最近一周的报错规律。

模型不调用工具，不一定是它做完了——很可能它只是被协议层的静默信号卡住了，或者正在等你的那一下 Nudge

如何系统评估 Agent Skill，证明它没被改坏？ 写好一个 Skill 只是开始，真正的挑战是：改了之后，怎么证明它没变坏？

多智能体 Multi-Agent 协作的 5 种模式：怎么选、怎么演进 Multi-Agent 系统越来越常见，但"用多个 Agent 协作"本身不是目标——选错模式，复杂度只会翻倍。

Claude Code 源码：系统提示词 导航 🧠 概念派？ → 什么是系统提示词 — 它决定了 LLM 的行为边界

Claude Code 源码：Agent 工具 — 多 Agent 的路由与定义机制 导航 🎯 为什么需要多 Agent？

Claude Code 源码：工具 Plan 模式 导航 🎯 什么是 Plan 模式？ → 核心问题 — 为什么需要"先规划再执行" 🔄 完整流程是什么？ → 生命周期 — 从进入到退出的 5 个阶段

Claude Code 源码：普通工具实现 Read / Write / Edit / TodoWrite 导航 📖 读文件？ → FileReadTool — 去重缓存与 cat -n 格式 ✍️