# Project Scaffold

> 项目脚手架技能 - 模块/页面/技能/IPC处理器的样板代码生成

- Skill: `chainlesschain/project-scaffold` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chainlesschain/project-scaffold`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chainlesschain/project-scaffold/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: chainlesschain (https://skillmd.com/u/chainlesschain)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chainlesschain/project-scaffold

---


# 项目脚手架技能

## 描述

按照项目约定自动生成新模块、Vue 页面、技能定义或 IPC 处理器的完整样板代码。分析现有代码模式确保风格一致。

## 使用方法

```
/project-scaffold <类型> <名称> [选项]
```

## 脚手架类型

### 新技能

```
/project-scaffold skill <name> [--category <cat>] [--with-handler]
```

生成:

- `builtin/<name>/SKILL.md` - Agent Skills 标准格式
- `builtin/<name>/handler.js` - 可选的执行处理器

### 新 Vue 页面

```
/project-scaffold page <name> [--store] [--route <path>]
```

生成:

- `pages/<Name>Page.vue` - Vue 3 Composition API + Ant Design Vue
- `stores/<name>.ts` - Pinia TypeScript Store（可选）
- 路由注册（router/index.ts 追加）
- 菜单项（MainLayout.vue 追加）

### 新 IPC 模块

```
/project-scaffold ipc-module <name> [--handlers <n>]
```

生成:

- `src/main/<name>/<name>.js` - 主逻辑模块
- `src/main/<name>/<name>-ipc.js` - IPC 处理器（含错误中间件）
- `ipc-registry.js` 注册条目

### 新 API 端点

```
/project-scaffold api-endpoint <name> [--method GET|POST|PUT|DELETE]
```

生成:

- Spring Boot Controller + Service + Repository
- 或 FastAPI Router + Schema

## 遵循的项目约定

| 约定       | 规则                                  |
| ---------- | ------------------------------------- |
| 文件命名   | kebab-case (如 `session-manager.js`)  |
| 类命名     | PascalCase (如 `SessionManager`)      |
| IPC 通道   | `module:action` (如 `audit:get-logs`) |
| 页面组件   | `<Name>Page.vue`                      |
| Store 文件 | `<name>.ts` (TypeScript)              |
| 错误处理   | IPC Error Handler 中间件              |
| 日志       | `logger.info/warn/error` 格式         |

## 示例

创建新技能:

```
/project-scaffold skill "file-converter" --category data --with-handler
```

创建新页面:

```
/project-scaffold page "AnalyticsDashboard" --store --route /analytics
```

创建新 IPC 模块:

```
/project-scaffold ipc-module "notification-manager" --handlers 5
```

