源码驱动开发

记忆是会过期的

写 React 表单时凭印象用 useState 管理受控组件，上线后才发现 React 19 的 useFormStatus 已经简化了表单提交逻辑；照着记忆写 Vue 3 的响应式 API，却不知道 Composition API 在 Vue 3.4 后有了性能优化。框架的 API 在变，最佳实践在演进，而人的记忆往往停留在上一次认真读文档的时候。

这种"凭记忆写代码"的风险在团队协作中更明显——新人照着旧模式写，老人凭经验改，代码库逐渐变成无人能辨的混合体。

它如何工作

Source-Driven Development 的核心理念是：每一项框架相关的代码决策，都必须有官方文档作为依据。不是"我记得应该是这样"，而是"官方文档说应该是这样，这是链接"。

技能的工作流程清晰明确：

1. 检测技术栈与版本：读取项目的依赖文件，明确列出检测到的版本信息（如 React 19.1.0、Vite 6.2.0），而不是模糊地假设"大概是最新版"
2. 获取官方文档：针对检测到的具体版本，获取对应的官方文档，而不是通用教程或过时的博客文章
3. 核实与引用：在编写代码时，每个模式、每个 API 调用都要能追溯到具体的文档段落
4. 向用户展示来源：让用户看到你参考的文档链接，建立信任的同时，也方便他们自行验证

这个过程确保了生成的代码不是"看起来对"，而是"有据可查地对"。

什么时候不该用

并非所有编码场景都需要如此严格的验证。以下情况可以跳过这个流程：

• 正确性不依赖特定版本：重命名变量、修复拼写错误、移动文件位置
• 纯逻辑代码：循环、条件判断、数据结构操作，这些在不同版本间行为一致
• 用户明确要求速度优先：当用户说"赶紧搞定就行"时，不应该被文档查阅流程拖慢

技能的适用边界是清晰的——它针对的是那些"框架推荐的做法很重要"的场景：表单处理、路由配置、数据获取、状态管理、认证流程等。在这些领域，一个过时的模式可能带来的不是轻微的风格差异，而是实际的功能缺陷或安全隐患。