嗨，老铁，今天聊聊零文档编码，让你一学就会。

什么是零文档编码？

说实话，你可NengYi经听过“代码即文档”这句话。

但零文档编码geng进一步，把所有业务意图dou塞进测试里。

换句话说业务契约直接写进断言。

那你就Neng省去传统手写 PRD 的麻烦。

核心理念

先别被技术细节吓倒。

想象一下：你把整个项目的源代码塞进 AI 的上下文窗口，它会把噪声搞成幻觉。

噪声，就是实现细节——数据库配置、错误处理、各种 Helper 函数……

而业务意图，就是那条主线——用户想要Zuo什么。

怎么快速上手？ 第一步：拆分用例目录

Coding 是从业务场景开始，而不是从模块开始。

把 specs/ 下的文件按“用户目标”划分，而不是按 Controller 或 Service 排列。

"RegisteringUser.spec.ts"、"CreatingOrder.spec.ts"——直观又好记。

@UseCase 与 @MSS 标签

@UseCase 用来标识用例文件的整体业务目标。

@MSS 标记主成功流程；@Extensions 标记异常分支。

@UseCase RegisteringUser
describe => {
    // 主成功流程
    it => {
        const result = await register;
        expect.toBe;
    });
    // 异常分支
    it => {
        const result = await register;
        expect.toBe;
    });
});

第二步：写可执行的断言

"一句一句写，别乱套"

"那边这个变量其实没用，我先删了"

步骤一：先确定业务目标——比如注册账号。

步骤二：写一个主流程断言，用 @MSS 标记它。让 AI Neng明白这是Zui重要的场景。

步骤三：再加几个 @Ext 分支，用来覆盖异常情况。这样 AI 在生成代码时就Nengkan到完整需求。

步骤四：Zui后跑一次测试，确认断言Neng通过。

步骤五：给 AI 一个提示：“请基于这些断言实现注册功Neng”。AI 就Neng自动填充实现代码。

"我觉得Ke以直接把所有逻辑dou塞进一个函数里这样geng简单"

- 对不起，不对不对，应该拆成小函数才geng清晰呀！哈！

"那个那个…我忘了加个 import"

"害，我得回头检查一下路径了"

"咱就是说只要测试通过那就是成功啦"

"你懂的，这种方式真的省事儿"

为什么百度不收录？答案来了！

"有些页面根本就没被百度抓取啊？这到底咋回事？"

"原因hen简单，一般是因为页面没有被公开索引或者 robots.txt 阻止爬虫抓取。"

"另外Ru果内容被标记为 noindex，也会导致百度不收录。"

“不管怎么说Ru果你想让搜索引擎kan到，就别给它加 NOINDEX。”"

零文档编码带来的好处

- “你再也不用担心 PRD 脏化。” 说明：PRD 一旦落后就跟着废掉；而 Zero‑Doc 的契约永远是Zui新版本。

- “AI Neng直接根据断言生成代码。” 说明：测试即需求，即可作为 Prompt。

- “开发门槛低。” 说明：只要会写单测，就Neng玩转 AI 编程。

- “维护成本低。” 说明：只维护一套测试文件夹，不需要同步多份文档。

'我觉得这条也hen重要——持续集成时Ke以直接跑这些测试'

'当然你还得保证测试本身质量，否则 AI 会学到垃圾'

'嘿，你懂吗？没事儿，我帮你修复一下'

可Neng遇到的挑战与解决办法

'有时候 AI 生成的实现和断言不完全匹配，需要手动微调'

'Ru果业务逻辑非常复杂，单测太多容易跑慢'

- 'Ke以把核心场景提炼成几条关键断言，然后让 AI 用自己的方式 ' - '或使用参数化测试减少重复' - '别忘了给每条断言加上描述，让 AI geng容易理解'

  - '还有，一个好习惯是把所有用例放在同一目录下让 CI 自动发现并执行'
  - '当出现“未捕获异常”的时候，你得确认是不是断言写错了'
  - '不要太纠结细节，只关注业务结果'
　　'哈哈，kan起来像个大工程，但其实只是一堆小句子组合而Yi'

一下吧！

'Zero‑Doc 并不是新概念，它只是把旧式 PRD 换成了可执行的测试' 'AI 在理解需求时只需要kan到“要Zuo什么”，而不是琐碎实现细节' '所以当你准备好让断言完全接管业务描述时就该试试 Zero‑Doc'

    

---