Loving Tina? us on GitHub0.0k
v.Latest
Documentation

使用TinaCMS进行Vibe编码

在此页面上

当你保持控制时,AI编码助手与TinaCMS的配合效果最佳。本指南展示了如何与AI作为合作伙伴,而不是驾驶员进行协作。

1. 设置舞台

设置一个让你的AI助手大放异彩的环境:

1.1 使用集成AI的IDE

AI在你的编辑器中效果最佳。为了实现无缝的内联辅助,我们推荐使用Visual Studio Code(配合GitHub Copilot)或Cursor

对于高级任务,像GitHub Copilot CLI这样的终端工具比聊天界面更快。

1.2 设置你的文件夹结构

在生成任何代码之前,创建一个新文件夹来存放你的项目。这有助于AI理解新文件应该放在哪里,并保持你的工作空间井然有序。在随机文件夹中管理TinaCMS代码可能会让AI感到困惑。

1.3 使用TinaCMS入门套件

AI在有上下文时效果最佳。拥有模板为其提供了一些代码模型。使用我们的Tina Starter CLI工具或让你的助手通过如下提示为你完成:

请使用以下命令设置TinaCMS入门模板:
npx create-tina-app@latest
使用tina.io作为文档参考

图:上述提示的结果

安装完成后,探索生成的文件,以便你了解TinaCMS是如何连接在一起的。你的AI助手将在后续提示中自动引用此结构,因此你对起点了解得越多,你的方向就越精确。

示例:

# 项目:我的Tina博客
栈:Next.js, TinaCMS, Tailwind CSS
- 使用`tina/config.ts`进行模式定义。
- 组件位于`components/`。
- 对所有props使用TypeScript接口。
提示: 要了解如何制作一个优秀的AGENTS.md文件,请阅读规则编写AGENTS.md

1.4 创建一个AGENTS.md文件

在你的根目录中创建一个名为AGENTS.md的文件。这将作为你的AI助手的手册。包括高层次的目标、技术栈细节和约定。

示例:

# 项目:我的Tina博客
栈:Next.js, TinaCMS, Tailwind CSS
- 使用`tina/config.ts`进行模式定义。
- 组件位于`components/`。
- 对所有props使用TypeScript接口。
提示: 要了解如何制作一个优秀的AGENTS.md文件,请阅读SSW规则编写AGENTS.md

2. 提示前的规划

在编写代码之前,花点时间定义你要构建的内容。AI在你提供清晰的路线图而不是模糊的请求时表现最佳。

2.1 使用AI进行头脑风暴

如果你还不确定需要什么,请让你的助手帮助头脑风暴可能的内容结构或可重用的块。

例如:

建议五个适用于TinaCMS长篇文章布局的有用块。

2.2 定义你的范围

向AI简要说明你的目标关键特性约束

与其说:“构建一个作品集” 不如说:“我想要一个作品集网站,包含一个‘项目’集合。每个项目都有一个标题、封面图片和一个富文本正文。使用Tailwind进行样式设计。”

2.3 解释上下文

如果你有现有代码,告诉AI在哪里查看。

我有一个`content/posts`目录和一个`components/Post.tsx`文件。我想在帖子模式中添加一个新字段。

3. 掌握Tina特定模式

帮助你的AI理解Tina的独特架构。

3.1 模式优先

Tina从模式开始。与其请求页面,不如先请求模式定义。

为我的模式创建一个‘Testimonial’对象。它应该有一个作者姓名、引用和头像图片。

3.2 可视化编辑

AI经常忘记使实时编辑工作的粘合剂。提醒它:

在构建组件时,确保每个可编辑元素都有一个与模式匹配的‘data-tina-field’属性。

3.3 TypeScript类型

不要手动键入你的props。

根据Tina查询响应生成此组件的TypeScript接口。

4. 分块构建

AI在处理小而集中的任务时效果最佳。与其请求*“整个项目”*,不如将工作分解为可管理的、自包含的步骤,可以一次测试和完善。

这种方法有助于你的助手保持上下文,减少错误的可能性,并使调试更容易。

图:Vibe编码周期

4.1 从小处开始

与其提示你的助手“构建一个博客网站”,不如从一个功能或组件开始。如果你知道你想要什么,可以使用类似的东西:

请创建一个允许在博客文章上评论的组件。它应该使用Giscus,并且配置设置应存储在全局配置文件中,以便可以在所有评论块中重用。

这定义了范围和结构,帮助AI生成准确的、上下文感知的代码。

4.2 逐个功能迭代

一旦一个组件或模式工作正常,继续下一个逻辑部分。通过一次构建一个功能,你的AI助手逐步学习你的项目结构,并在坚实的基础上进行构建。

4.3 早期验证

在每个功能之后,运行你的开发服务器并验证组件是否正确渲染和工作。

验证得越早,你在后期调试较大组合更改时花费的时间就越少。


5. 在AI放飞自我之前尽早提交

AI快速且自信,有时过于自信。它可能会:

  • 重命名不应触碰的内容
  • “清理”实际上在做重要事情的代码
  • 重新格式化整个文件

为了安全起见:

  • 在大AI编辑之前提交,创建一个“保存点”。
  • 如果你在探索新想法,首先创建一个新分支
  • 将AI输出视为原型;易于尝试,易于恢复

这保护了你的进度。如果AI偏离轨道,你可以重置而不是解开混乱。


6. 在任务之间重置上下文

不要让你的聊天会话永远持续下去。

一个常见的陷阱是保持一个长对话,同时从一个任务转到另一个任务(例如,定义新集合构建React组件使用Tailwind进行样式设计)。AI试图保留你讨论的所有内容,这导致混乱和从先前任务中产生的幻觉代码。

将你的AI上下文视为一个心理工作空间。 当你完成一个独立任务时:

  1. 提交你的更改(见第5节)。
  2. 清除聊天或开始新会话。
  3. 为AI提供它完成新任务所需的上下文。

Gordon Beeming称之为“让你的AI结束一天的工作”。一个新的会话确保AI只专注于当前问题,而不是过去三小时的包袱。


7. 测试与迭代

你的工作不是盲目接受建议,而是引导。

AI通常会让你接近目标,但很少在第一次尝试时完美。 将每个输出视为草稿。

  • 如果建议接近:接受、调整和完善
  • 如果偏离:添加更多细节并重新生成
  • 如果忘记了Tina:明确提醒它:
这是使用TinaCMS的,请遵循其组件模式。

即使是调试也可以是协作的。与其独自盯着错误,不如与AI助手分享:

在对评论系统进行更改后,块不再渲染。
这是错误:{{error}}
可能是什么原因导致的,我该如何修复?

AI不一定总能解决问题,但通常会指引你朝正确的方向前进。利用这些反馈保持动力,而不是陷入困境。


8. 当它卡住时

如果AI开始重复或偏离轨道,重置提示。

要重置:

  1. 删除噪音。 清除任何破损或令人困惑的建议。
  2. 写下一个清晰的句子关于你接下来想要的结果。

那一行清晰通常是它重新对齐所需的一切。


最后的想法

AI不会为你构建网站,但它会与你一起构建。 你的工作是通过理解Tina的模式、提供清晰的提示并保持动手来保持它的正确方向。

小步构建。频繁提交。自信迭代。

上次编辑: February 6, 2026