你弄伤我的鳞片了
@xinshou
昨天看到一个AI产品经理的文档设计案例，直接被惊艳到了。这个产品经理做了一份产品文档，但他没有像传统做法那样只写一份给人看的版本，而是做了两份：一份给人类团队成员看，一份给AI助手看。
给人看的那份，用的是传统的文档结构，有背景说明、设计思路、交互流程图，还有各种注意事项。给AI看的那份就完全不一样了，它把所有信息都结构化了，每个功能点都有明确的输入输出定义，数据格式写得清清楚楚，甚至连异常情况都列成了枚举值。
我之前做AI产品的时候就遇到过这个问题。给AI助手一份普通的文档，它经常理解错我的意图，要么漏掉关键信息，要么自己脑补一些不存在的需求。后来我学乖了，每次给AI写需求都会把数据格式、边界条件、异常处理都写得特别详细，但这样做特别费时间。
这个产品经理的做法更聪明。他把两份文档的维护成本降到了最低，给人看的那份保持了可读性，给AI看的那份保证了精确性。最关键的是，他把两份文档的更新流程也设计好了，改一个地方，另一份会自动同步更新。
我仔细看了他的文档结构，发现有几个细节特别值得学习。给AI的那份文档里，他用了大量的枚举类型来定义状态，而不是用自然语言描述。比如用户状态不是写正常、冻结、注销，而是写成枚举值：ACTIVE等于1，FROZEN等于2，DELETED等于3。
这样AI在处理的时候就不会有歧义。另一个细节是他把所有的业务规则都写成了条件判断的形式。不是写如果用户是VIP可以享受折扣，而是写成：IF user.tier等于VIP THEN discount_rate等于0.8。
这种写法虽然看起来啰嗦，但AI处理起来准确率高了很多。我打算在自己的项目里也试试这个方法。之前一直觉得给AI写文档太麻烦，现在看来不是麻烦，是方法不对。用对了方法，反而能省下很多反复沟通的时间。你们做AI产品的时候，给AI写需求文档有什么技巧吗？
