← 返回提示词库
通用 #简短 难度:入门

CLAUDE.md 组装

CLAUDE.md Assembly

你正在编译权威的 CLAUDE.md 设计系统参考文件。 该文件将位于项目根目录,作为任何 AI 助手(或人类开发者)工作的单一事实来源。

适用平台: ChatGPTClaudeGemini
你正在编写权威的 CLAUDE.md 设计系统参考文件。
该文件将位于项目根目录,作为任何在此代码库上工作的 AI 助手(或人类开发者)的单一事实来源。

## 输入
- **Token 架构:** [阶段 2 输出]
- **组件文档:** [阶段 3 输出]
- **项目元数据:**
  - 项目名称:${name}
  - 技术栈:[Next.js 14+ / React 18+ / Tailwind 3.x / 等]
  - Node 版本:${version}
  - 包管理器:[npm / pnpm / yarn]

## CLAUDE.md 结构

按照以下顺序编译最终文件:

### 1. 项目标识
- 项目名称、描述、定位
- 技术栈摘要(一个表格)
- 目录结构概览(src/ 布局)

### 2. 快速参考卡
一份精简的备忘单 — 最常用信息一目了然:
- 主要颜色及十六进制值(最多 6 个)
- 字体堆栈
- 间距比例(视觉表示:4, 8, 12, 16, 24, 32, 48, 64)
- 断点
- 边框半径值
- 阴影值
- Z-index 映射

### 3. 设计 Token — 完整参考
按层级组织(原始 → 语义 → 组件)。
每个 token 条目:名称、值、CSS 变量、Tailwind 类等效项。
使用表格以便于扫描。

### 4. 排版系统
- 字号比例表(名称、大小、字重、行高、字间距、用途)
- 响应式规则
- 字体加载策略

### 5. 颜色系统
- 完整调色板及色板描述(名称、十六进制、使用场景)
- 语义颜色映射表
- 暗模式映射(如果适用)
- 对比度合规性说明

### 6. 布局系统
- 网格规范
- 容器宽度
- 带有视觉比例的间距系统
- 断点行为

### 7. 组件库
[插入每个组件的阶段 3 输出]

### 8. 运动与动画
- 命名预设表(名称、持续时间、缓动、用途)
- 规则:何时动画,何时不动画
- 性能限制

### 9. 编码约定
- 文件命名模式
- 导入顺序
- 组件文件结构模板
- CSS 类排序约定(如果使用 Tailwind)
- 使用的状态管理模式

### 10. 规则与约束
绝不能违反的硬性规则:
- “绝不使用内联十六进制颜色 — 始终引用 token”
- “所有交互元素必须有可见的焦点状态”
- “最小触摸目标:44x44px”
- “所有图片必须有 alt 文本”
- “z-index 值不得超出定义的范围”
- [添加项目特定规则]

## 格式要求
- 所有 token/值映射使用 Markdown 表格
- 所有代码示例使用代码块
- 每个部分独立(无需滚动到其他部分即可阅读)
- 在顶部包含带有锚点链接的目录
- 最大行长:100 个字符以提高可读性
- 优先使用明确的值,而非“参见上方”的引用

## 关键规则
此文件必须具有权威性。如果 CLAUDE.md 与实际代码之间存在歧义,则应更新 CLAUDE.md 以匹配实际情况 — 绝不能反过来。这记录的是“是什么”,而不是“应该是什么”(那是单独的路线图)。