本文转载自微信公众号硅基进化实验室Pro 

最近看到一位国外 coder 的观点，觉得有点意思，分享给大家。 
对人类开发者而言最优的，或者至少是我们认为理想的，并不一定是对 AI 助手而言最优的。随着 AI 逐步融入我们的开发流程，我们也需要做出相应的调整。你的代码不应该只适合给人看，更应该适合给 AI 看。 
他举的例子主要是 ts 的，不过其他语言也是类似思想。 
1. 代码即文档（Documentation as Code）
** 传统做法 ** ： 详细的文档通常存放在 Wiki、Notion 或团队知识库中，与代码库分离。 
**AI 友好的做法 ** ： 在项目根目录和每个子模块中放置详尽的 README.md 文件。创建 CONTRIBUTING.md，说明编码规范、PR 预期和测试覆盖要求。如有必要，可以在源码附近添加额外的文档，或者在代码中直接注释，解释代码的目标和...