项目脚手架

使用最佳实践的项目结构、工具和配置来快速搭建新项目。

使用方法

当 Colt（或你）需要启动一个新项目时，使用此技能来生成完整的项目样板。

决策树

询问或推断项目类型：

Web 应用 (React / Next.js)

my-app/
├── src/
│   ├── app/              # Next.js App Router
│   ├── components/       # 可复用的 UI 组件
│   ├── lib/              # 工具函数、辅助类、API 客户端
│   ├── styles/           # 全局样式、Tailwind 配置
│   └── types/            # TypeScript 类型定义
├── public/               # 静态资源
├── tests/                # 测试文件
├── .gitignore
├── .eslintrc.json
├── tailwind.config.ts
├── tsconfig.json
├── package.json
└── README.md

初始化命令：

npx create-next-app@latest my-app --typescript --tailwind --eslint --app --src-dir
cd my-app && npm install

API / 后端服务 (FastAPI)

my-api/
├── app/
│   ├── __init__.py
│   ├── main.py           # FastAPI 应用入口
│   ├── routers/          # 路由模块
│   ├── models/           # Pydantic 模型 / 数据库模型
│   ├── services/         # 业务逻辑层
│   └── config.py         # 设置 / 环境变量
├── tests/
├── .gitignore
├── pyproject.toml
├── requirements.txt
└── README.md

初始化命令：

mkdir my-api && cd my-api
uv init && uv pip install fastapi uvicorn

移动应用 (SwiftUI)

MyApp/
├── MyApp/
│   ├── App.swift
│   ├── ContentView.swift
│   ├── Models/
│   ├── Views/
│   ├── ViewModels/
│   └── Services/
├── MyAppTests/
├── MyAppUITests/
└── README.md

初始化： 使用 Xcode 或 swift package init --type executable

CLI 工具 (Node / Python)

my-cli/
├── src/
│   └── index.ts          # 入口文件
├── bin/
│   └── my-cli            # 可执行包装器
├── tests/
├── .gitignore
├── tsconfig.json
├── package.json
└── README.md

浏览器扩展

my-extension/
├── src/
│   ├── background.ts
│   ├── content.ts
│   ├── popup/
│   │   ├── popup.html
│   │   ├── popup.ts
│   │   └── popup.css
│   └── options/
├── icons/
├── manifest.json
├── .gitignore
├── tsconfig.json
├── package.json
└── README.md

脚手架搭建后检查清单

生成项目结构后，请执行以下步骤：
1. git init && git add -A && git commit -m "Initial scaffold"
2. 创建适合项目类型的 .gitignore 文件
3. 设置代码检查配置 (ESLint / Ruff)
4. 添加一个包含项目名称和设置说明的基础 README 文件
5. 添加一个基础测试文件以验证测试运行器正常工作

资源模板

.gitignore (通用基础版)

node_modules/
__pycache__/
.env
.env.local
dist/
build/
.next/
*.pyc
.DS_Store
*.log
coverage/