同一个需求,两种给法:

A:文字描述接口规范,输入什么输出什么,格式要求。
B:给一个已有的类似接口代码 + 一句「照这个写,参数换成 xxx」。

B 的产出可用率高很多。因为风格、错误处理、日志、命名这些都自动对齐了。

文字描述永远写不全。你没写「异常要记日志」,它就真的不记。但给个例子,它会把例子里的所有习惯都带上。

实践:新项目第一件事是让它读三个代表性文件,然后再让它写。这三个文件就是事实上的规范。

主楼