baozaotumao
39fe248f9f
- 新增 .claude/skills/new-project/SKILL.md（标准 skill 格式） - install-skill.sh 安装时组装 SKILL.md + verify.sh，单一源无重复 - verify.sh 改用索引数组替代 declare -A，兼容 macOS bash 3.2 - log_pass/log_skip 显式 return 0，避免 set -e 下非 verbose 误退出 - README 改为 skill 优先；补全 copier.yml/scripts/template 入库
70 lines
2.8 KiB
Markdown
70 lines
2.8 KiB
Markdown
---
|
||
name: "new-project"
|
||
description: "使用 scaffold copier 模板一键生成含完整质量门禁的 FastAPI + React 项目。当用户需要从零搭建新项目、初始化工程脚手架、创建新服务、bootstrap 新代码库，或需要带 pre-commit/CI/Docker/Claude 规则的标准化项目骨架时使用。支持按需选择 backend(FastAPI) / frontend(React+Vite) / agent(LLM) 服务、sqlite 或 postgresql 数据库、以及 LLM provider，并自动裁剪 Claude Code 规则文件（原理层 + 落地层）。不适用于：已有项目的局部改造、单文件重构、或非新建场景。"
|
||
dependencies: ["copier"]
|
||
---
|
||
|
||
# new-project
|
||
|
||
## Overview
|
||
|
||
一条命令生成带有完整质量门禁（pre-commit、CI、Docker、Claude Code 规则）的 FastAPI + React 项目，并随选型自动裁剪 Claude Code 落地层规则。模板从 GitHub 拉取，无需本地克隆 scaffold 仓库。
|
||
|
||
## Instructions
|
||
|
||
### 第一步：收集参数
|
||
|
||
若用户未提供足够信息，**一次性**询问以下内容（不要逐个问）：
|
||
|
||
| 参数 | 说明 | 默认值 |
|
||
|------|------|--------|
|
||
| 项目目录名 | 生成到哪个文件夹 | my-project |
|
||
| 是否包含 backend | FastAPI 服务 | true |
|
||
| 是否包含 frontend | React + Vite | true |
|
||
| 是否包含 agent | LLM Agent 服务 | false |
|
||
| 数据库 | sqlite / postgresql | sqlite |
|
||
| LLM provider | 仅 agent=true 时问 | gemini-cli |
|
||
|
||
若用户输入包含 `--preset`，直接套用以下预设，跳过问卷：
|
||
|
||
| Preset | 等价配置 |
|
||
|--------|---------|
|
||
| `principles` | 三服务全 false — 仅复制原理层规则，无服务代码 |
|
||
| `fullstack` | backend+frontend，sqlite |
|
||
| `fullstack-ai` | backend+frontend+agent，postgresql，openai-api |
|
||
| `api-only` | 仅 backend，sqlite |
|
||
|
||
### 第二步：执行生成
|
||
|
||
```bash
|
||
copier copy git+https://github.com/baozaotumao2025/scaffold.git <项目目录> \
|
||
--data project_name="<显示名称>" \
|
||
--data include_backend=<true/false> \
|
||
--data include_agent=<true/false> \
|
||
--data include_frontend=<true/false> \
|
||
--data database=<sqlite/postgresql> \
|
||
--data llm_provider=<provider>
|
||
```
|
||
|
||
> `llm_provider` 仅在 `include_agent=true` 时添加。
|
||
|
||
### 第三步：验证
|
||
|
||
使用本 skill 自带的验证脚本（自包含，无需依赖生成项目内的工具）：
|
||
|
||
```bash
|
||
bash ${CLAUDE_SKILL_DIR}/scripts/verify.sh -v <项目目录>
|
||
```
|
||
|
||
验证失败时，逐条输出修复建议，不要静默跳过。
|
||
|
||
### 第四步：汇报
|
||
|
||
输出生成的服务组合、规则文件列表，以及 verify.sh 汇总结果。
|
||
|
||
## Resources
|
||
|
||
- 模板仓库：`git+https://github.com/baozaotumao2025/scaffold.git`
|
||
- 验证脚本：`${CLAUDE_SKILL_DIR}/scripts/verify.sh`（只读幂等，可重复运行）
|
||
- 规则说明：见 scaffold 仓库 `README.md` — "两层规则体系" 一节
|