文档测试

在写代码之前先测试文档——用 AI 对着规格说明走用户故事,在 token 成本而非编码成本上发现漏洞。

什么是文档测试?

文档测试是在编码之前,用 AI 来”走查”你的规格说明文档。让 AI 扮演用户,对着文档里描述的功能逐个走用户故事,看能不能走通。走不通的地方,就是文档的漏洞——也就是未来代码的 bug。

这个技术由胥克谦在社区中推广,核心理念是:在 token 成本上发现问题,比在编码成本上发现问题便宜得多

社区声音

“胥老师的文档测试,谁用谁爽。” — 崔富泽,2026-03-21

“刚跑了一次工作流,确实查到些交互漏洞,这些通常都要人工体验后二次补充。” — 详志,2026-03-21

“对的,所以我在原始文档测试方法的描述里归类在 UAT 测试的前置。” — 胥克谦,2026-03-21

怎么做?

  1. 写好自包含文档(参见自包含文档
  2. 让 AI 扮演用户,按文档描述的流程走用户故事
  3. 记录走不通的地方——缺少的字段、矛盾的逻辑、未覆盖的边界情况
  4. 修补文档,然后再走一遍
  5. 文档通过测试后,再开始编码

为什么重要?

改一行文档的成本几乎为零。改一行已经写好的代码,可能牵扯到测试、部署、回归。文档测试把发现问题的时间点尽可能前移,是”左移”理念在 AI 时代的具体实践。