ClaudeCode的项目说明文件
约 724 字大约 2 分钟
2025-07-30
下面是一份 Claude Code 项目说明文件。可以用过/init 命令生成。 可以看出 Claude Code 这个工具非常聪明,通过 md 文件,把项目的重要信息进行记录。
中文.md
此文件为 Claude Code (claude.ai/code) 在此代码库中工作时提供指导。
项目概述
这是一个使用 HTML、CSS 和 JavaScript 构建的简单个人博客网站,使用 Tailwind CSS 进行样式设计。这是一个静态多页面网站,没有后端依赖或构建过程。
技术栈
- 前端: 纯 HTML/CSS/JavaScript(无框架)
- 样式: Tailwind CSS(通过 CDN)
- 图标: Font Awesome 6.4.0(通过 CDN)
- 语言: 中文 (zh-CN)
- 架构: 具有响应式设计的静态网站
项目结构
D:\work\claude\
├── about.html # 关于我们页面,包含团队信息
├── blog.html # 主要博客主页,包含文章列表
├── guestbook.html # 留言簿/联系页面,具有表单功能
├── claude-start.bat # Claude Code 设置的 Windows 批处理脚本
├── key.md # Claude Code 命令参考
└── [聊天助手_*.md] # 聊天会话日志(不属于网站的一部分)
开发命令
由于这是一个没有构建过程的静态网站:
- 开发: 直接在浏览器中打开 HTML 文件或使用任何本地 Web 服务器
- 测试: 在不同浏览器中测试兼容性
- 部署: 将文件上传到任何静态托管服务(Netlify、Vercel、GitHub Pages)
代码架构
一致的页面结构
所有 HTML 页面都遵循相同的模式:
- 具有响应式汉堡菜单的粘性导航头部
- 具有响应式网格布局的主要内容区域
- 包含链接和版权信息的页脚
- 用于交互功能的 JavaScript
主要功能
- 响应式设计: 使用 Tailwind 响应式类的移动优先方法
- 表单处理: 客户端验证和提交(guestbook.html)
- 搜索功能: 仅前端的搜索实现
- 交互元素: 平滑滚动、悬停效果、动态内容
内容组织
- 博客文章: 带有类别的示例文章(JavaScript、CSS、React、工具、Node.js、前端)
- 团队信息: 包含 3 名团队成员和使命宣言的关于页面
- 留言簿: 具有消息显示和统计信息的交互式表单
重要说明
- 语言: 所有内容均为中文 (zh-CN)
- 依赖项: 所有内容均通过 CDN 加载 - 没有 npm/bower 依赖项
- 安全性:
claude-start.bat
文件包含应保持安全的 API 凭据 - 表单: 仅客户端验证 - 目前没有服务器端后端
开发工作流程
- 直接编辑 HTML 文件以更改内容
- 使用 Tailwind 工具类修改 CSS 类
- 在 HTML 文件中的 script 标签内添加 JavaScript 功能
- 使用响应式设计类在不同屏幕尺寸上进行测试
- 通过上传到静态托管服务进行部署