source-driven-development 是做什么的?
将每一个实现决策锚定在官方文档上。在需要权威、有来源引用的代码且避免过时模式时使用。适用于任何注重正确性的框架或库构建。
概述
源驱动开发(Source-Driven Development)是一种方法论,确保AI代理生成的所有代码都优先基于框架、库或工具的官方文档。这消除了猜测和过时的知识,通过将每个实现决策绑定到权威来源,提供可靠、可追溯的代码
为什么使用
- 避免过时模式:许多AI模型依赖于可能过时或错误的训练数据。源驱动开发确保AI优先查阅当前版本的官方文档
- 提高正确性:通过引用官方来源,代码更有可能遵循最佳实践,并避免已知的陷阱
- 可追溯性:每个决策都可以追溯到具体文档,方便代码审查、调试和知识传递
- 框架无关:适用于任何有文档的框架或库——React、Vue、Angular、Django、Flask、Spring等
如何使用
使用此技能时,AI代理应:
- 识别相关官方文档:对于给定的任务或API,查找该框架或库的官方文档
- 基于文档提供实现:使用文档中的信息(代码示例、配置选项、最佳实践)来生成代码
- 引用来源:在响应中包含链接或引用,指示所使用信息的位置(例如:
根据React官方文档...) - 保持更新:优先使用最新版本的文档。如果兼容性问题需要降级,请注明版本
支持平台
- Claude Code
- Cursor
- Codex(及其他基于AI的编码助手)
使用示例
用户:“如何在React中实现useEffect?”
AI(使用源驱动开发):“根据React官方文档(https://react.dev/reference/react/useEffect),useEffect用于在组件中执行副作用。以下是一个基于官方示例的实现...”
工作流程
- 用户提出请求:用户请求实现某个功能或使用特定API
- AI检索官方文档:AI查找该功能或API的官方文档(可能从本地缓存或在线获取)
- AI提供实现:基于文档生成代码,包括注释和来源引用
- 用户验证:用户可以点击文档链接确认准确性
潜在改进
- 添加自动文档提取工具(如Web爬虫)以保持AI知识库同步
- 在AI提示中加入版本感知上下文,以处理多个文档版本
- 为常见框架和库建立来源验证检查清单
结论
源驱动开发是在AI辅助开发中确保代码质量和正确性的强大范式。通过将每个实现决策锚定在官方文档中,可以减少错误、避免过时模式,并构建更可靠的软件。