AI评价
该提示词结构清晰、要求具体,是一份高质量的专业开发指南。
优点:
- 技术栈明确:精准定位Gatsby、React、TypeScript和Tailwind,减少了AI的猜测范围。
- 规范详尽:从代码风格、命名约定到Gatsby特定实践,覆盖了开发全流程,有助于生成风格统一、符合最佳实践的代码。
- 强调类型安全:对TypeScript的严格使用要求(如避免
any、as)能有效提升代码质量。 - 注重性能:明确要求使用Gatsby的优化策略(如图片处理、
Link组件、缓存),有助于构建高性能网站。
缺点/注意事项:
- 学习成本高:对于不熟悉该技术栈的开发者,提示词中的许多术语(如
gatsby-node.js、useStaticQuery)可能难以理解。 - 灵活性较低:严格的规则可能限制了AI在特定场景下探索更优或创新解决方案的空间。
- 环境依赖:提示词假设项目已正确配置了Gatsby及其插件环境,对于从零开始的项目需要额外步骤。
适用人群
该提示词主要面向有一定经验的工程师,特别是正在或计划使用Gatsby+TypeScript+Tailwind技术栈进行开发的开发者。
- 0代码经验者:不推荐直接使用。需要先学习HTML、CSS、JavaScript基础,并了解Gatsby和React的基本概念。
- 初学者/学生:可以作为学习参考和代码规范模板。在使用时,应重点关注其输出的代码结构、类型定义和组件化思想,但不必一开始就严格遵守所有规则。建议先从一个简单的Gatsby教程项目开始。
- 工程师/团队:非常适合。可以作为团队内部的编码规范或新项目脚手架的生成模板,确保项目启动时就具备良好的结构和可维护性。
使用建议
你好,开发者!
如果你正在使用或参考这份提示词来构建你的Gatsby项目,这里有一些建议能帮助你更好地利用它:
1. 将其视为“宪法”而非“法律条文”
这份指南的核心价值在于确立代码质量和项目架构的高标准。在实际开发中,如果遇到极其特殊的情况(例如与某个第三方库集成必须使用类型断言),可以适度变通,但务必确保你有充分的理由,并且这种例外越少越好。
2. 环境先行
提示词中提到的许多Gatsby最佳实践(如图片优化、离线插件)都依赖于正确的环境配置。在使用AI生成页面代码之前,请确保你的gatsby-config.js、package.json已正确安装并配置了必要的插件(如gatsby-plugin-image, gatsby-plugin-typescript等)。AI生成的代码是基于这些预设环境工作的。
3. 分阶段采用
不必强求一次性在所有文件中应用所有规则。可以按优先级分阶段实施:
- 第一阶段(基础):确保所有组件使用TypeScript定义Props接口,使用
useStaticQuery获取站点元数据。 - 第二阶段(优化):全面应用Tailwind进行样式编写,使用Gatsby的
Link和Image组件。 - 第三阶段(高级):实现
gatsby-node.js的程序化页面创建,配置缓存和离线策略。
4. 善用AI的“记忆”功能
在Cursor等具备对话记忆的AI工具中,你可以在后续对话中引用这份提示词(例如说“请按照我们之前约定的编码规范…”),AI会持续遵循这些规则,从而在整个项目周期内保持代码风格的一致性。
5. 补充你的专属规则
这份提示词是一个通用性很强的优秀基线。你可以根据自己或团队的需求进行增补。例如,增加“使用@headlessui/react构建无障碍UI组件”、“所有API调用必须封装在src/lib/api.ts中”等特定规则,使其更贴合你的实际项目。
最后,记住工具的目的是服务于你和你的项目。祝您构建出快速、优雅且健壮的网站!




