我的 agent.md 如何提升 LLM 辅助代码质量

一位开发者分享了自己通过编写 agent.md 文件来约束 AI 编程助手行为、提升代码输出质量的实践,引发了关于“注释到底该写什么”“指令如何量化”以及“AI 写代码是否需要强制规则”的激烈讨论。

一位开发者分享了自己通过编写 agent.md 文件来约束 AI 编程助手行为、提升代码输出质量的实践,引发了关于“注释到底该写什么”“指令如何量化”以及“AI 写代码是否需要强制规则”的激烈讨论。
![[Question]: Chat doesn't retrieve answer from knowledge](https://www.chat-gpts.plus/wp-content/uploads/2026/08/8022-2eace44f-768x403.jpg)
这个问题通常出现在 RAGFlow 中聊天机器人的检索组件未正确关联知识库,或系统提示词缺少 {knowledge} 变量,导致大语言模型(LLM)无法接收知识库内容。优先检查知识库是否已正确关联、嵌入模型是否一致,以及系统提示词是否包含 {knowledge} 变量。

该报错是 DeepSeek-V4 模型在并行处理( -np > 1 )与投机解码(MTP/DSpark)同时启用时触发的 KV 缓存回滚重放 bug,导致长程注意力失效并输出乱码。优先排查是否同时启用了并行槽位和投机解码,并尝试暂时禁用投机解码或仅使用单槽位验证。

该报错是 llama.cpp 在 CUDA 后端执行推理时,GPU 因长时间被占用未响应导致驱动看门狗(Watchdog)超时并触发内核态重置(Xid 8),进而引发 cudaStreamSynchronize 同步失败。优先排查 GPU 看门狗超时时间设置及超长上下文推理导致的单次 Kernel

该报错发生在 llama.cpp 的 HIP 后端执行 GGML_OP_SOLVE_TRI 运算时,当矩阵维度超过自定义快速内核限制(n>64 或 k>32)而回退到 rocBLAS strsm 路径,而 rocBLAS 在 gfx906(MI50)上缺少预编译的 Strsm 内核导致崩溃。优先排查

该报错发生在 llama.cpp WebUI(llama-server)在 Linux 下通过 Wayland 会话粘贴图片时,剪贴板图片无法通过传统 paste 事件读取。优先排查浏览器是否因权限策略(如 SSL 证书、权限 API)阻止了异步剪贴板读取,可优先尝试通过点击“Paste image
![[deepseek-v4-flash-sm86 fork] PP8 + DSpark: recurring deadlock in the V2-runner PP sampled-token/draft broadcast protocol (PPHandler)](https://www.chat-gpts.plus/wp-content/uploads/2026/08/53402-1007c917-768x403.jpg)
该报错发生在 vLLM V2 Runner 启用流水线并行(PP=8)配合 DSpark 投机解码(DeepSeek-V4-Flash 模型)时,表现为长时间运行后 PP 末级 rank 死锁、采样 token 广播协议错位。优先排查 PP 广播的 NCCL 集体通信调度是否因数据依赖产生跨步错位,
![[DSpark] Native graph assertion on Apple Silicon with official LFM2.5-2.6B DSpark GGUF](https://www.chat-gpts.plus/wp-content/uploads/2026/08/27528-0cf76c3f-768x403.jpg)
该报错发生在 macOS Apple Silicon 上使用 llama.cpp 加载官方 LiquidAI LFM2.5-2.6B DSpark 草稿模型进行推测解码时,首次生成请求即触发原生图断言崩溃。优先排查 llama.cpp 版本是否过旧,升级到 v0.2.0(或 b10541 及以上)即

在 llama-server 中,当同时启用 `--embeddings`(或 `--embedding`)和 `--spec-type draft-mtp` 时,启动过程会因 GGML_ASSERT 失败而中止。优先排查方案是确保不要同时启用这两个选项,或尝试暂时移除 `--spec-type d
![[Bug]: MooncakeStoreConnector stores invalid recurrent states with mamba_cache_mode=align, causing silent output corruption](https://www.chat-gpts.plus/wp-content/uploads/2026/08/53084-6479b0bb-768x403.jpg)
该报错发生在 vLLM 使用 MooncakeStoreConnector 外部前缀缓存且模型带循环状态(GDN/Mamba/ShortConv),并以 mamba_cache_mode="align" 运行时,生产者可能发布不含有效循环状态快照的 Store key(空块 ID 0),导致消费者跳