你的 Agent 从未读过的 ADR
编程智能体正以机器速度重新审视每一个未记录的决策。本文探讨了为什么架构决策记录(ADR)已从官僚式的点缀演变为集群基础设施,如何将它们接入智能体上下文,以及无人提醒你的过时 ADR 失效模式。
模型已经在直接与你的客户对话了
AI 助手正在那些你永远看不到的对话中引用你过时的报价、推荐已废弃的端点,甚至还在推销竞争对手。了解如何像对待生产环境一样监控模型的回答,并交付机器可读的真实源数据。
文档复兴:你的 README 是 Agent 的核心上下文界面
二十年来,文档一直是美好愿景的坟墓。编程 Agent 扭转了这一局面:你的 README 现在是可执行的上下文,其质量直接决定了任务的成败。
Prompt 即文档:当系统 Prompt 成为唯一可信的交付物时
当 PM、支持团队和销售开始通过阅读系统 Prompt 来了解产品功能时,这既是一种褒奖,也是一种结构性失效。本文将介绍如何保留有效的部分并修复其余问题。
过时的文档,肯定的错误答案:AI 帮助中心里隐藏的失效模式
当 RAG 系统检索到过时的上下文时,幻觉率会飙升 6 倍。如何将文档新鲜度视为一个工程问题——通过 TTL 过滤、时间重排序、过时评分以及在发布后保持 AI 帮助中心准确性的运营模型。
AI 文档债:随机系统是如何破坏你的技术知识库的
AI 功能文档的腐化速度比任何其他技术债都要快 —— 而且其方式往往令团队措手不及。本文将探讨为什么确定性的文档模式在概率系统中会失效,以及你应该转而编写什么样的内容。
你的 AI 功能说明文档是运行时依赖,而非营销文案
当 Prompt 发生变化而帮助中心文章没有更新时,你的 AI 功能信任契约就会悄然失效 —— 而 Prompt 仓库可以预测这种差距。
Wiki 迎来了第二位租客:为什么面向 AI Agent 的文档与面向人类的文档截然不同
工程团队正悄悄地为其内部文档积累第二批受众——即每位开发者的 AI 助手。如果团队只为其中一类读者编写文档,那么提供给另一类读者的内容注定是残缺的。
这个提示词去年还有意义:AI 系统中的机构知识衰减
当构建 AI 系统的工程师离职后,系统不会立即崩溃——它会缓慢腐烂。以下是如何通过提示词原理文件、评估来源日志和护栏理由注释来防止衰减。
记录概率性功能:模型行为与开发者引导之间缺失的一层
由 AI 驱动的功能没有稳定的输入输出契约可供记录。本文介绍了如何为每次表现都不同的功能编写 API 文档、变更日志和运维手册 —— 利用行为包络(behavioral envelopes)、版本控制纪律和可观测性作为动态文档。