feat: 重组为标准 skill 包结构 + 修复 verify.sh bash 3.2 兼容

- 新增 .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 入库
This commit is contained in:
baozaotumao
2026-06-01 21:19:45 -07:00
parent 167fa10dde
commit 39fe248f9f
53 changed files with 3744 additions and 55 deletions
+69
View File
@@ -0,0 +1,69 @@
---
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+frontendsqlite |
| `fullstack-ai` | backend+frontend+agentpostgresqlopenai-api |
| `api-only` | 仅 backendsqlite |
### 第二步:执行生成
```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` — "两层规则体系" 一节