sonvee/fullstack-init

全栈项目初始化

触发条件

当用户明确表达要从零初始化一个全新的前后端分离项目时，主动触发此 skill。

应触发的典型场景包括：

• 提到“初始化项目”“新建全栈项目”“搭建前后端分离项目”“创建一个新项目”“帮我建个项目”
• 明确要创建同仓库下的 frontend/ + backend/ 结构
• 明确要初始化 monorepo 全栈模板、根目录共享文件与前后端基础脚手架
• 已经进入 superteam 模式，并要求按 fullstack-init + superteam 流程启动一个新项目

即使用户没有明确说“全栈”，只要上下文明确是在说“同时新建前端和后端”的全新项目，也应触发。

与 superteam 组合时的角色感知解释

当已经进入 superteam 模式，且当前窗口角色已经锁定后，像“项目初始化”“初始化项目”“开始初始化”“把项目先搭起来”“先把项目建起来”这类未显式指向前端或后端对象的初始化语义，必须先结合当前窗口角色自动解释，不得按“整仓一次性全部初始化”理解：

• 当前角色为 pm：上述语义指代 pm 负责的根目录共享初始化与正式派工流程，只能走 steps-superteam 中的 pm 流程
• 当前角色为 frontend-coder：上述语义指代前端项目初始化，只能走 steps-superteam 中的 frontend-coder 流程，并严格落到 frontend-init
• 当前角色为 backend-coder：上述语义指代后端项目初始化，只能走 steps-superteam 中的 backend-coder 流程，并严格落到 backend-init
• 若当前窗口尚未完成角色确认，不得解释这类语义化初始化指令，必须先回到 superteam 的角色确认流程
• 若用户显式说“初始化前端”或“初始化后端”，应将其视为显式目标；但执行时仍不得突破当前角色边界。若显式目标与当前角色冲突，必须停止并按 superteam 流程报阻塞或等待重新派工

不应触发的典型场景包括：

• 现有项目中的功能开发、Bug 修复或局部重构
• 只初始化前端，或只初始化后端
• 只调整 README、.gitignore、.env.* 或其他局部配置
• 只讨论技术方案、目录设计或 skill 规则，但尚未真正开始初始化项目

---

技术栈约定

• 这是用户固定的技术选型，在给建议、生成代码、初始化项目时，始终遵循以下栈，不推荐替代方案，除非用户主动提出更换
• 在运行本 Skill 的过程中，明确指定不使用 brainstorming 的 Skill，以防止干扰项目初始化的流程步骤

---

项目结构约定

• 前后端分离开发，但放在同一个 Git 仓库（Monorepo）
• 目录结构遵守如下约定：

project-root/
├── frontend/             # 前端项目
├── backend/              # 后端项目
├── .gitignore            # Git 忽略文件
├── CONFIG.md             # 项目配置说明
└── README.md             # 项目说明文档

• 为了确保空目录能被 Git 追踪，有必要在空目录下放置一个空的 .gitkeep 文件
• 前后端子项目的环境变量由各自目录内的 .env.* 管理，根目录不创建 .env，避免混淆
• 前后端各自独立 install node_modules，互不干扰，保持清晰的依赖关系

---

命名规范

• 所有文件名、目录名只使用英文字母、数字、连字符（-）或下划线（_），严禁中文命名，防止编码问题
• 文件内容（注释、文档、README）推荐使用中文，方便理解

---

初始化执行步骤

• 当与 superteam 组合使用时，必须先遵守 superteam 的角色确认、工作区存在性检查、任务单派工与边界检查规则，不得因为“初始化项目”而跳过这些前置约束
• 当与 superteam 组合使用时，项目初始化 一类未指明对象的语义化指令，必须按当前已锁定角色自动解释：pm -> 根目录共享初始化与派工、frontend-coder -> 前端初始化、backend-coder -> 后端初始化
• 当与 superteam 组合使用时，一旦当前窗口角色确认完成，后续初始化动作必须严格只按该角色在 superteam 中被允许的流程执行，不得有任何跨界操作
• 当与 superteam 组合使用时，即使用户显式点名要初始化另一侧目录，也不得因此突破角色边界；目标与角色冲突时，必须停止并报阻塞
• 不得因为“顺手补一下初始化”“只是先搭个脚手架”“帮另一侧一起建好”而读取、创建或修改其他角色职责范围内的目录、代码、配置或协作文档；若超出当前角色边界，必须停止并按 superteam 流程报阻塞或等待重新派工

| 步骤类型 | 描述 | 参考文档 | | --------------- | ------------------------------------- | ------------------------------------------------ | | steps-normal | 常规初始化流程 | steps-normal | | steps-superteam | 使用 superteam skill 时的初始化流程 | steps-superteam |