技能介绍

要解决什么问题

很多全栈脚手架要么前后端拆成两个端口和两套启动命令，要么前端打包链路很重。若你希望用 Flask 3.1 做 API 与页面托管，前端用 Vue.js（CDN + Composition API） 快速落地，同时统一 80 端口、有可追溯的 结构化日志，并避免千篇一律的「AI 风」界面，手工搭目录、pyproject.toml 和 AGENTS.md 往往重复且容易漏项。

技能如何工作

本技能按固定工作流驱动 Agent 完成项目创建：

收集需求：项目名称、功能简述、配色与风格偏好。
初始化结构：运行 scripts/init_project.py 生成约定目录布局。
配置依赖：用 uv 生成根目录 pyproject.toml（含清华镜像等 [tool.uv] 配置）。
Flask 入口：生成主应用文件，集成 src/utils/logger.py（TimedRotatingFileHandler、控制台与文件双写、src/log/ 按天轮转保留 30 天）。
前端：静态资源经 Flask 从 templates/ 提供；HTML 引入 Vue 3 CDN；遵循 references/frontend-design.md 与 references/vue-guidelines.md（独特字体、场景化配色、仅 SVG 图标、响应式断点等）。
同步文档：结构或路由变更后更新 AGENTS.md（结构树、架构说明、更新日志表）。
验证运行：对照交付清单确认单端口路由、日志目录与前端规范。

适用边界与注意点

适合 单端口、轻构建 的全栈原型或小服务；若需要独立前端工程化（Vite/Webpack 多环境构建），本模式不是目标形态。
静态文件路径与路由约定绑定 Flask templates/ 布局，偏离技能既定结构时需自行维护 AGENTS.md 与检查清单。
前端规范是硬性约束（反 Inter/Roboto、无 emoji 图标、对比度与 cursor-pointer 等），与「任意 UI 库」混用时需自行对齐规范。