Skip to main content
ClaudeWave
ES, Spanish
Slash Command1.1k estrellas del repoactualizado 2mo ago

project-init

为新项目初始化 Claude Code 配置

Instalar en Claude Code
Copiar
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.md
Después abre una sesión nueva de Claude Code; el slash command carga automáticamente.

project-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. 提示用户检查并调整
api-design-safetySkill

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

api-proxy-safetySkill

网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)

async-task-patternSkill

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。

bash-styleSkill

当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。

cc-api-contract-safetySkill

前后端接口契约安全规范,适用于接口新增或调整、联调、列表分页异常与临时兼容治理;用于避免响应结构漂移被前端兼容长期掩盖。

cc-api-design-safetySkill

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

cc-api-proxy-safetySkill

网关/代理/WAF/CDN 中间件响应判定与关键词匹配安全规范。适用于 proxy/gateway/waf/cdn/nginx/openresty/rewrite/redirect 等代码,防止把正常长正文中的 Cloudflare、502、bad gateway、error 等技术术语误判为上游错误。

cc-async-task-patternSkill

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。