源码驱动开发

解决框架 API 幻觉问题

大模型的训练数据往往滞后于前端框架的快速迭代。当你要求实现 React 表单、Next.js 路由或状态管理时，模型极易凭记忆写出已废弃的旧版 API 签名，导致交付的代码在当前项目中无法运行。SourceDrivenDevelopment 针对这一痛点，强制在编写任何框架相关代码前先验证官方文档，而不是盲目依赖权重中的历史记忆。

核心工作流

该技能将工程交付过程拆解为四个严谨的步骤：

• 探测技术栈与版本：在动手前必须读取 package.json 等依赖文件，锁定确切的包版本。如果版本号缺失或模糊，必须向用户提问，绝不允许猜测。
• 抓取权威文档：只抓取与目标功能相关的特定官方文档页面。来源按权威度严格分级，官方文档优先级最高，其次为官方博客、Web 标准参考及兼容性数据。博客和第三方教程不能作为主要参考来源。
• 基于文档实现：严格按照文档展示的最新 API 签名和推荐模式编写代码。如果官方文档与项目现有代码存在冲突，需将矛盾暴露出来，由用户决定如何处理，绝不静默妥协。
• 强制引用来源：每一个框架特定的决策，都必须在代码注释中附带完整的官方文档 URL，并尽可能提供锚点链接。

适用边界与注意点

该技能主要服务于依赖特定版本 API 的框架业务代码。对于纯算法逻辑、变量重命名等不依赖框架版本的特性，无需启用此工作流。此外，当官方文档与迁移指南存在矛盾时，技能会将差异摆在台面上，要求对照实际项目版本进行二次验证，而不是给出模棱两可的猜测。