scaffold/.claude/skills/new-project/SKILL.md

name, description, dependencies

name	description	dependencies
new-project	使用 scaffold copier 模板一键生成含完整质量门禁的 FastAPI + React 项目。当用户需要从零搭建新项目、初始化工程脚手架、创建新服务、bootstrap 新代码库，或需要带 pre-commit/CI/Docker/Claude 规则的标准化项目骨架时使用。支持按需选择 backend(FastAPI) / frontend(React+Vite) / agent(LLM) 服务、sqlite 或 postgresql 数据库、以及 LLM provider，并自动裁剪 Claude Code 规则文件（原理层 + 落地层）。不适用于：已有项目的局部改造、单文件重构、或非新建场景。	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

第二步：执行生成

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 ${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 — "两层规则体系" 一节