CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

语言约束

本项目默认使用简体中文，新增/更新的 skill、规则、记忆等文件应该使用简体中文（可允许部分必须要英文字母的表述，如 API、URL、ID 等）。

项目概述

这是一个通用的企业级员工 AI 工作台，包括但不限于：

需求分析（requirements-analysis）
撰写 PRD / FSD（prd-writer）
撰写测试用例
构建 PC 端后台 Demo（pc-demo）
构建 H5 移动端 Demo

工作流程：需求分析 → PRD 撰写 → PC/H5 Demo 开发 → 测试用例编写

目录结构

rongshu/
├── CLAUDE.md                          # 本文件
├── .claude/skills/                    # Claude Code 技能目录
│   ├── prd-writer/                    # PRD 撰写技能
│   ├── requirements-analysis/         # 需求分析技能
│   ├── pc-demo/                       # PC 端 Demo 构建技能
│   └── lark-*/                        # 飞书集成技能（文档、表格、日历等）
├── .resources/                        # 截图、图片等资源文件
├── 工作空间/                           # 产研工作目录
│   └── 产研/
│       └── <业务线>/                   # 如：权益
│           └── <项目名称>/             # 如：汇丰全行
│               ├── 需求文档/           # PRD、FSD 等需求文档
│               │   └── screenshots/   # 需求文档配图
│               ├── 测试用例/           # 测试用例文档
│               └── 产品原型/           # Demo 项目
│                   ├── pc-demo/       # PC 端后台 Demo（Vue 3）
│                   └── h5-demo/       # H5 移动端 Demo
└── 企业知识和技能库/                    # 企业知识沉淀（待建设）

架构要点（PC Demo）

技术栈：Vue 3.5 + Vue Router 4 + Element Plus 2.10 + Vite 5
无真实后端：Mock.js 在浏览器内拦截 /api/* 请求，生成假数据
认证机制：localStorage.token 存储登录态，路由守卫 beforeEach 检查 token
新增页面两步：① src/router/index.js 加路由（含 meta.title） → ② Layout.vue 的 <el-menu> 加菜单项
Mock 接口格式：所有返回必须遵循 { code: 200, data, msg } 结构
定制化路径：客户定制页面遵循 customization/<客户>/<模块> 路径前缀

常用命令（PC Demo）

cd 工作空间/产研/权益/汇丰全行/产品原型/pc-demo
npm install        # 安装依赖
npm run dev        # 启动 Vite 开发服务器（端口 8080，热更新）
npm run build      # 生产构建
npm run lint       # ESLint 校验并自动修复

无测试框架，无单测命令。

技能说明

requirements-analysis（需求分析）

当用户提到"需求分析"、"分析需求"、"撰写需求分析"、"需求调研"时使用。在 PRD 撰写前进行需求调研、分析和确认。输出到 工作空间/产研/<业务线>/<项目名称>/需求文档/ 目录。

prd-writer（PRD 撰写）

当用户提到"写PRD"、"撰写需求"、"产品需求"、"需求背景"、"功能设计"、"撰写产品需求文档"时使用。按五段式模板输出（需求背景→需求目标→流程图→功能清单→系统改造），包含 Mermaid 流程图。输出到 工作空间/产研/<业务线>/<项目名称>/需求文档/ 目录。

pc-demo（PC 端 Demo）

当用户提到"PC后台"、"后台页面"、"新增页面"、"添加菜单"、"PC端开发"、"后台列表"、"后台详情"、"管理后台"、"新建页面"、"开发页面"、"页面模板"等关键词时使用。即使用户只是简单提到要做一个后台页面或管理界面，也应该触发此 skill。

注意：pc-demo skill 模板文档描述的是 React + Ant Design + Vite，但实际项目使用 Vue 3.5 + Element Plus 2.10 + Vite 5。开发时以对应项目的 CLAUDE.md 和实际代码为准。

文档约定

需求文档存放在 工作空间/产研/<业务线>/<项目名称>/需求文档/ 目录
测试用例存放在 工作空间/产研/<业务线>/<项目名称>/测试用例/ 目录
产品原型存放在 工作空间/产研/<业务线>/<项目名称>/产品原型/ 目录
文件命名格式：<简述>-<类型>-<日期>.md（如 销售数据导出-需求沟通记录-20260410.md）
流程图使用 Mermaid 语法

CLAUDE.md 4.6 KB Trvalý odkaz Historie Surový