Project Scaffold

核心用法

project-scaffold 是面向多技术栈的项目初始化助手，支持通过对话交互或自动推断确定项目类型，并输出对应的目录结构、初始化命令及配置文件模板。覆盖的主流场景包括：

• Web 应用：Next.js 14+（App Router、TypeScript、Tailwind CSS）
• 后端 API：FastAPI（Python 3.11+、uv 包管理、Pydantic 模型）
• 移动应用：SwiftUI（MVVM 架构、Xcode 标准目录）
• CLI 工具：Node.js/TypeScript 或 Python 可执行脚本
• 浏览器扩展：Manifest V3 标准结构（background、content、popup、options）

显著优点

1. 决策树驱动：通过结构化问答快速收敛技术选型，降低"选择困难"成本
2. 社区最佳实践：目录组织遵循各生态主流规范（如 Next.js 官方推荐、uv 现代 Python 工具链）
3. 即开即用：提供完整的 git init、lint 配置、测试占位、README 模板等后续步骤
4. 跨栈统一：一套交互范式覆盖前后端、移动端、浏览器插件等多端场景

潜在局限

• 版本锁定风险：初始化命令固定使用 latest 标签或特定版本（如 create-next-app@latest），可能引入破坏性更新
• 定制化深度有限：预设结构偏向"标准应用"，对微前端、Monorepo、跨平台混合开发等复杂场景覆盖不足
• 环境依赖：Node.js/Python/Swift 等运行时需用户本地预装，skill 本身不处理环境管理
• 无运行时验证：仅生成静态文件结构，不执行编译/测试确保脚手架可用性

适合人群

• 需快速启动 MVP 的独立开发者或技术负责人
• 团队需要统一新项目目录规范的工程化场景
• 学习新技术栈时希望获得"官方推荐"结构参考的开发者

常规风险

• 依赖供应链：npx create-* 和 uv pip install 均从 npm/PyPI 拉取最新包，存在恶意包投毒或漏洞引入风险（建议固定版本号并审查 lockfile）
• 秘钥泄露：模板中包含 .gitignore 基础规则，但 .env.local 等敏感文件仍需用户自行确认是否误提交
• 架构债务：脚手架的"通用性"可能导致生产环境过度设计（如为小脚本引入完整 Next.js 体系）

核心用法

project-scaffold 是一款纯文档型 Skill，用于为新项目生成标准化目录结构与初始化配置。支持五大项目类型：Web App（React/Next.js）、API 后端（FastAPI）、移动应用（SwiftUI）、CLI 工具（Node/Python）及浏览器扩展。用户只需声明项目类型，即可获得完整的文件树示例、推荐命令（如 npx create-next-app、uv init）及 Post-Scaffold 检查清单。

显著优点

1. 零代码风险：纯 Markdown 实现，无可执行脚本、无动态加载、无外部 API 调用，安全审计达 S 级。
2. 即开即用：直接复制命令即可初始化项目，无需理解复杂配置。
3. 社区最佳实践：目录结构遵循各框架官方推荐（如 Next.js App Router、FastAPI 分层架构）。
4. 跨栈覆盖：前端、后端、移动端、CLI、浏览器扩展一网打尽。

潜在局限

• 非交互式：无法根据用户输入自动生成实际文件，仅提供文本模板。
• 版本敏感：npx create-next-app 等命令随框架升级可能变化，需人工核对。
• 无自定义能力：预设结构固定，复杂 Monorepo 或多包架构需额外调整。

适合人群

• 频繁初始化新项目的高级开发者
• 需要快速理解项目规范的新手工程师
• 团队 Leader 制定内部脚手架标准时参考

常规风险

极低。唯一注意事项为：命令示例中的 npx/npm 会访问 npm registry，属标准包管理行为，与 Skill 本身无关。