如何判断 AI 生成的设计文档合格，并以滑动窗口限流说明人工修改？

核心回答

合格的AI设计文档应让人能据此实现并验证：需求边界明确、模块职责清楚、关键机制正确、失败路径可处理、取舍有依据。文档格式整齐只是可读性，不能证明方案满足业务。

以滑动窗口限流为例，人工审阅要把“接口每分钟最多100次”展开成明确规则：按谁计数、统计最近60秒还是固定自然分钟、拒绝是否计数、多实例怎样共享状态，以及限流服务不可用时如何处理。

一个具体修改例子

假设AI初稿写成“每分钟清空计数器”，却称为滑动窗口。可改为：收到请求时，删除观察区间之外的事件，计算剩余有效事件数，未到阈值才接纳并记录本次事件。观察区间是否包含左边界需要统一，例如使用最近60秒的左开右闭区间。

如果逐请求保存时间戳成本过高，可以改成小桶计数或前后窗口加权，但要说明它是近似值，并给出可接受误差。不能一边声称精确滑动窗口，一边只保存一个每分钟清零的计数器。

多实例场景中，“清理、判断、记录”还需原子化，事件ID要避免同毫秒请求互相覆盖；状态需要过期，时间来源也要一致。只换一张架构图，未解决这些竞争和边界，设计仍不完整。

怎样证明修改有价值

验证窗口交界、同毫秒多请求、恰好过期、空窗口、并发到达、多实例竞争以及状态服务故障。检查结果是否符合预先约定的限额，而不是只看最终HTTP返回正常。

性能参数来自目标容量、下游承载和排队预算，再用代表性负载验证。审阅结果应能指出“原稿哪个假设不成立、改了什么规则、用哪个场景验证”，比笼统评价“方案不够完善”更具体。

参考资料