六种 bug 模式:组件各自正确,集成后破碎,诊断性复盘中浮现规律

测试全绿,系统不能用:18 个 bug 的六种死法

TL;DR: Aristotle v1.1 发布前发现 18 个 bug,单元测试只拦住 4 个(22%)。剩下 14 个都在集成层——组件接线、配置传递、进程启动的交叉点。对它们做 root cause analysis 后归纳出六种模式:路径/环境不一致(5 个)、注册遗漏(3 个)、启动阻塞(2 个)、静默失败(2 个)、测试-生产路径差异(2 个)、集成拼接错误(4 个)。根因不是问题变难了,是 AI 绕过了手写代码时靠经验建立的防线——实现和审查的节奏脱钩、代码外观误导了质量判断、集成环节从显式动作变成了隐式假设。文末附八维度集成检查清单和 16 种 bug 类型的路线图。 ...

2026-05-07 · 13 分钟 · Alex Wang
修不完的 bug 死循环:四轮归因与回归测试打破螺旋

修不完的 bug 与逃不出的循环:AI 辅助根因诊断实战

一、引子:永远修不完的 bug 前几天,以完全实现 GEAR 协议为目标的 Aristotle 项目[1],终于成功验证了所有核心技术线路,代码也完成了第三次重构,实现了基本功能,并完善了测试。在准备把开发分支合并到 main 上线前,我做了一轮手工测试,发现 SKILL.md 的指令没有被模型正确执行——拿到了 action 却不调用 task() 启动后台 subagent,反而去加载了 LEARN.md。从排查这个问题开始,更多的 bug 被陆续发现: ...

2026-05-01 · 14 分钟 · Alex Wang
七种人机协作模式:Aristotle项目的回顾与反思

回顾与反思:Aristotle 项目中的七种人机协作模式

五篇文章之后,我想退一步,看看脚下的路。 Aristotle:让 AI 学会从错误中反思 讲了设计理念和初版实现。claude-code-reflect:同样的元认知,落在不同的土壤 讲了跨平台移植的坎坷。信任边界:同一个想法在开放系统和受限系统上的实现实验 提出了信任分层模型。从四道伤疤到一套铠甲:Aristotle 改造中的驾驭工程实践 用改造过程验证了理论。一份 Markdown 的三次生命:从静态规则到 Git 版本管理的 MCP Server 把反思规则从 append-only 推进到了 GEAR 协议。 ...

2026-04-16 · 10 分钟 · Alex Wang
一份Markdown的三次生命:从静态规则到Git版本管理的MCP Server

一份 Markdown 的三次生命:从静态规则到 Git 版本管理的 MCP Server

上一篇文章 从四道伤疤到一套铠甲:Aristotle 改造中的驾驭工程实践 的结尾处,Aristotle 有了一份精简的路由器(SKILL.md 从 371 行压缩到 84 行),一个按需加载的 Progressive Disclosure 架构,和一个还算能用的反思→审核→确认流程。 ...

2026-04-16 · 21 分钟 · Alex Wang
四道伤疤化为铠甲:从架构缺陷到Progressive Disclosure重构

从四道伤疤到一套铠甲:Aristotle 改造中的驾驭工程实践

三篇文章之后,再次回到代码,今天要做一个深刻的反思。 第一篇 Aristotle:让 AI 学会从错误中反思 讲了设计理念和顺利的实现过程——3 个 commit 一气呵成。第二篇 claude-code-reflect:同样的元认知,落在不同的土壤 讲了同样理念搬到 Claude Code 上的适配代价——从 V1 到 V3 的持续迭代。第三篇 信任边界:同一个想法在开放系统和受限系统上的实现实验 提出了信任分层模型和驾驭工程的思考框架。 ...

2026-04-11 · 13 分钟 · Alex Wang
信任边界:开放系统与受限系统之间的检查点概念图

信任边界:同一个想法在开放系统和受限系统上的实现实验

Fundamentum autem est iustitiae fides, id est dictorum conventorumque constantia et veritas. — Cicero, De Officiis 正义的基石是信——言辞与约定的始终如一与真实。 前两篇讲了两个项目的故事。Aristotle:让 AI 学会从错误中反思 跑在 OpenCode 上,3 个 commit 一气呵成。claude-code-reflect:同样的元认知,落在不同的土壤 跑在 Claude Code 上,从 V1 迭代到 V3,踩了一路坑。 ...

2026-04-06 · 16 分钟 · Alex Wang
Aristotle 反思系统概念图

Aristotle:让 AI 学会从错误中反思

“Knowing yourself is the beginning of all wisdom.” — Aristotle 每次和 AI 编程助手一起工作,我都会遇到同一个问题。纠正过的错误,下次会话照犯。不是模型笨,是结构性的记忆缺失。 举个例子。上周我纠正了模型一个错误,它道歉了,我接受了,我们继续工作。今天重新开始一个新会话,同样的错误又出现了。纠正过程就这样蒸发了。这不是一次性的问题,而是每次对话的常态。模型记住了当前的上下文,但记不住它之前犯过的错误,以及它是怎么被纠正的。 ...

2026-04-06 · 6 分钟 · Alex Wang