project-init
为新项目初始化 Claude Code 配置
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/doccker/cc-use-exp/HEAD/.claude/commands/project-init.md -o ~/.claude/commands/project-init.mdproject-init.md
为当前项目生成 `.claude/CLAUDE.md` 配置文件。 ## 项目信息收集 请回答以下问题(可跳过非必填项): ### 1. 基本信息 **项目名称**:$ARGUMENTS(如未提供,从目录名推断) **项目描述**(一句话): > 请描述这个项目是做什么的 **作者**:wwj ### 2. 技术栈 **后端**(可多选): - [ ] Go + Gin - [ ] Java + Spring Boot - [ ] Node.js + Express - [ ] Python + FastAPI - [ ] 其他:___ **前端**(可多选): - [ ] Vue 3 + TypeScript - [ ] React + TypeScript - [ ] 无前端 - [ ] 其他:___ **数据库**: - [ ] SQLite - [ ] MySQL - [ ] PostgreSQL - [ ] MongoDB - [ ] 其他:___ ### 3. 项目约定 **启动方式**: - [ ] `./restart.sh` - [ ] `docker-compose up` - [ ] `npm run dev` - [ ] `go run main.go` - [ ] 其他:___ **数据库迁移方式**: - [ ] GORM AutoMigrate - [ ] Flyway - [ ] 手动 SQL - [ ] 其他:___ **特殊约定**(可选): > 例如:不使用行尾注释、API 统一响应格式等 --- ## 生成配置 根据收集的信息,生成 `.claude/CLAUDE.md`: ```markdown # [项目名称] 项目配置 作者:wwj ## 项目概述 [项目描述] ## 技术栈 | 层级 | 技术 | 版本 | |------|------|------| | 后端 | [后端框架] | [版本] | | 前端 | [前端框架] | [版本] | | 数据库 | [数据库] | [版本] | ## 目录结构 [根据技术栈生成典型目录结构] ## 项目定制 ### 开发约定 | 约定 | 说明 | |------|------| | 启动方式 | [启动命令] | | 数据库迁移 | [迁移方式] | | [其他约定] | [说明] | ### API 规范(如有后端) [根据技术栈生成 API 规范示例] ### 前端规范(如有前端) - 使用 [UI 组件库] - [其他前端约定] ## 与 Claude Code 协作 ### 期望你主动做的 - 发现代码中的类型错误和潜在 Bug - 提示更优雅的写法 - 补充缺失的异常处理 ### 不希望你做的 - 不要过度重构已经工作的代码 - 不要添加未要求的功能 - 不要主动创建文档文件 ``` ## 完成后操作 1. 将生成的内容写入 `.claude/CLAUDE.md` 2. 如果目录不存在,先创建 `.claude/` 目录 3. 提示用户检查并调整
当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)
当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
当编写新模块、设计接口、重构代码或代码审查时触发。提供经典模块化六原则检查清单(大小适中/调用深度/扇入扇出/边界清晰/作用域内聚/可预测性),适用于 PR/Review/新模块设计场景。
涉及浏览器、编辑器、CDN/WAF、IM 平台、操作系统剪贴板、第三方 SaaS 等"外部黑盒系统"的代码编写或 bug 调试时触发。强制先抓真实环境数据再推理,避免连续 2 轮"凭代码推理"的修复 no-op。关键词:粘贴/复制异常、跨平台显示不一致、第三方 API 怪结果、CDN/WAF 拦截、本地复现失败、HTML→MD 转换丢属性。
当重构涉及字段映射(dataIndex、枚举映射、类型转换)时触发。防止字段名推测错误,确保字段映射的正确性。
前端开发规范,包含 Vue 3 编码规范、UI 风格约束、TypeScript 规范等