用途:在编写与具体框架相关的代码时,让每个实现决策都以官方文档为依据,避免凭记忆写出过时或错误的模式。适合需要权威、可溯源实现的场景,例如脚手架、起步代码、表单、路由、数据获取、状态管理、认证,以及评审或改进框架相关代码。
主要能力与流程:
- 检测技术栈与版本,读取依赖文件(如 package.json、composer.json、requirements.txt/pyproject.toml、go.mod、Cargo.toml、Gemfile),明确说明识别结果;版本缺失或有歧义时向用户询问。
- 抓取官方文档中的相关页面(而非首页或整站),来源优先级为官方文档、官方博客/更新日志、Web 标准参考(MDN、web.dev 等)、浏览器/运行时兼容数据;Stack Overflow、博客教程、AI 生成文档及训练数据不可作为主要来源。
- 按文档所示模式实现,采用文档中的 API 签名,不使用已废弃写法;文档未覆盖的内容标注为未验证。
- 为每个框架相关模式给出引用,使用完整 URL,尽量用带锚点的深链接,必要时引用相关段落与兼容性数据。
适用场景:当用户明确要求经过验证或“正确”的实现;构建会被复制的样板与模式;框架推荐做法影响较大的功能;代码评审;以及任何准备凭记忆写框架代码的时刻。
限制:当正确性与特定版本无关(改名、修错字、移动文件)、纯逻辑代码、或用户明确要求优先速度时可不用。官方来源相互冲突时应向用户说明;文档与现有代码冲突应提示并让用户选择,不可静默决定。无法验证时必须明确标注。需在应用改动前自行验证命令、生成代码、依赖与外部服务行为,本技能不能替代环境测试、安全审查或用户对破坏性操作的批准。