Skip to content

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 凭据
  • 表单: 仅客户端验证 - 目前没有服务器端后端

开发工作流程

  1. 直接编辑 HTML 文件以更改内容
  2. 使用 Tailwind 工具类修改 CSS 类
  3. 在 HTML 文件中的 script 标签内添加 JavaScript 功能
  4. 使用响应式设计类在不同屏幕尺寸上进行测试
  5. 通过上传到静态托管服务进行部署

AI编程训练营

联系勋荣

      - 一对一指导
      - AI编程,AI项目实战
      - 课程价格:850元
      - 添加微信codexun咨询