溯源驱动开发

凭记忆写框架代码，代价是什么

AI 的框架知识来自训练数据，而训练数据会过时。useEffect 的依赖写法变了，Vue 3 推荐的组合模式变了，React 19 用 useActionState 取代了手写 isPending 的做法。凭记忆生成的代码可能用过时的 API、已弃用的模式，或与当前版本最佳实践相悖。这些代码一旦被复制到整个项目，就成了难以自查的隐性债务——评审者只能怀疑，无法验证。

核心能力：让每个模式都能追溯

溯源驱动开发遵循 检测 → 抓取 → 实现 → 引用 四步流程：

1. 检测栈与版本：读取 package.json、requirements.txt、go.mod、Cargo.toml 等依赖文件识别精确版本。版本缺失或模糊时显式询问用户，而不是猜测——版本决定哪种模式正确。
2. 抓取官方文档：抓取所实现功能的具体页面（如 react.dev/reference/react/useActionState），而非首页或整站。权威来源优先级：官方文档 > 官方博客/changelog > Web 标准（MDN、WHATWG）> 兼容表。Stack Overflow、博客教程、AI 生成的文档以及模型自身的训练数据绝不作为主源引用。
3. 按文档模式实现：严格使用文档中的 API 签名，文档有新版就用新版，弃用模式不用，文档未覆盖的显式标记「未验证」。文档与既有代码冲突时呈报差异让用户选择，而不是静默取舍。
4. 引用来源：每个框架特定模式在代码注释中附完整 URL（优先带锚点的深链，比顶层页更抗文档重构），并在对话中说明「为何用 X 而非 Y」。

输出的 SourcedCode 工件记录 stack、patterns、conflicts_surfaced、unverified 四类信息，供下游的核对、评审与契约设计消费。

适用边界

此技能面向框架特定、正确性依赖当前版本最佳实践的任务（表单、路由、数据获取、状态管理、鉴权等），也适合写会被全项目复制的样板代码。对于不依赖版本的纯逻辑改动（重命名、循环、条件、数据结构），或用户明确要求速度优先于验证的场景，不需要走完整溯源流程。诚实声明「未验证」比虚假自信更有价值。