Prompt Library 与 Rule Cards 的区别

明确网站两大核心栏目的定位与区别:一个提供可执行的"做什么",一个传递知识规范的"如何做"。

这是一个很好的问题,有助于我们明确网站的核心定位和内容策略。根据我们已经实现的功能和您提供的 Rule 内容,我们可以这样来定义 Prompt Library 和 Rule Cards 的区别:

Prompt Library (提示词库) - "做什么" (What to Do)

  • 核心内容: 具体的、可直接执行的 AI 指令 (Prompts)。
  • 目标: 为用户提供即插即用的解决方案。用户可以直接复制这些提示词到 AI 工具(如 Cursor, ChatGPT)中,以完成一个特定的、原子化的开发任务。
  • 形式:
    • 指令式: "生成一个支持暗黑模式的 Tailwind 卡片"、"重构这个旧的 JS 组件为 React Hooks"。
    • 角色扮演式: "你是一个高级前端专家..."、"你是一个响应式布局专家..."。这些也是一种特殊的提示词,旨在设定上下文以获得更高质量的输出。
  • 例子: 我们目前 prompts.ts 里的所有内容,无论是生成组件的指令,还是设定 AI 角色的 Rule,本质上都是一种 Prompt。它们都是用户可以直接用来与 AI 对话的输入。

Rule Cards (规则卡片) - "如何做" & "为什么这样做" (How & Why)

  • 核心内容: 最佳实践、开发规范、决策指南和代码风格准则。
  • 目标: 帮助开发者建立正确的开发心智模型 (Mental Model),理解"为什么"要这么做,而不仅仅是"做什么"。它更侧重于知识和规范的传递
  • 形式:
    • 可视化图表: 决策树(例如,选择哪个状态管理库?Redux vs. Zustand)、流程图。
    • 清单 (Checklists): 代码审查清单、发布前检查清单。
    • 规范文档: 像您之前提供的 TypeScript General GuidelinesGatsby Best Practices,这些虽然可以被包装成一个大的 Prompt,但其核心价值是作为一套开发团队需要共同遵守的规则
    • 简明的"Do's and Don'ts":用正反面对比的方式,清晰地展示推荐和不推荐的做法。
  • 例子:
    • 一个名为"CSS 命名规范"的卡片,可能展示 BEM 规范的核心思想和示例。
    • 一个名为"React 组件设计"的卡片,可能会有一个图表,解释容器组件 (Container) 和展示组件 (Presentational) 的区别。
    • 一个名为"文件夹结构"的卡片,会用树状图展示一个推荐的 Next.js 项目结构。

核心区别总结

特征 Prompt Library (提示词库) Rule Cards (规则卡片)
目的 提供可执行的指令,解决具体问题 (Action-Oriented) 传递知识和规范,建立正确心z智 (Knowledge-Oriented)
内容核心 Prompt 文本本身 (The "What") 最佳实践、规范、图表、决策逻辑 (The "How" & "Why")
用户行为 复制、粘贴、执行 阅读、理解、学习、参考
表现形式 代码块、纯文本 可视化图表、清单、简洁的规则描述

协同关系

Rule CardsPrompt Library 可以是相辅相成的。

  • 一张 Rule Card(如"Gatsby 最佳实践")可以链接到多个相关的 Prompts(如"生成一个使用 gatsby-plugin-image 的组件"、"创建一个 useStaticQuery 的 hook")。
  • 一个 Prompt 的详情页也可以反向链接到它所遵循的 Rule Card,帮助用户理解这个 Prompt 背后的设计思想。

简而言之,用户去 Prompt Library 是为了找工具,而去 Rule Cards 是为了学方法