技能介绍

要解决什么问题

Agent 从原型到上线，常见失败模式可以拆成三条线：设计期重复踩同类架构坑、输出期工具/RAG 结果上 LLM 仍瞎编、运行期长流式任务断流或循环卡死。单点补丁往往管不住整条生命周期。

技能如何组织

本集合把可靠性拆成三个互补子技能，按阶段分工：

agent-dev-pitfalls（设计期）：架构选型、记忆/规划、Harness 铁律、上下文工程等 10 大类 35+ 真实坑，适合在写第一版 prompt 和工具链之前对照。
hallucination-defense（输出期）：针对编造、closed-world 问答、空结果等场景，用 9 层防御 + 7 盲点 做输出门禁；做 RAG / 工具调用类 agent 时通常应一并启用。
agent-loop-reliability（运行期）：长任务、流式 SSE 断流、循环卡死、跨会话续传与事务边界；适合进入长流式生产部署后再重点接入。

各子技能内部已含中文触发词、落地 SOP（映射 Read/Grep/Bash/Agent 与写前确认关卡）、Grep 验证信号、产出模板，以及 TS/Python/Go 骨架与行业实战补充节。

适用边界

三者是互补关系：前两个侧重「少犯 / 不编」，第三个侧重「跑不死」。新手优先从 agent-dev-pitfalls 入手；agent-loop-reliability 在任务尚短、无流式生产压力时可后置。内容经多轮整理并含实战经验，引用以公开文章标题等通用参考为主，落地时仍需结合你自己的数据域与工具权限做裁剪。