全栈项目初始化

记录 / 2026-08-06

多仓库前后端全栈工作区配置任务

请将当前父目录配置为适合 AI/Codex 辅助开发的前后端全栈工作区。

一、项目参数

项目名称：[PROJECT_NAME]
工作区根目录：当前目录
后端目录：[BACKEND_DIR]
前端目录：[FRONTEND_DIR]
操作系统：Windows

默认脚本：PowerShell
当前结构：

[WORKSPACE_ROOT]/
├─ [BACKEND_DIR]/    # 后端，独立 Git 仓库
└─ [FRONTEND_DIR]/   # 前端，独立 Git 仓库

二、核心目标

保持前后端为两个独立 Git 仓库，不合并。
父目录仅作为全栈开发工作区。
为父目录、后端和前端分别建立合理的 AGENTS.md。
建立前后端共享文档目录。
创建可复用的项目级 Skills。
创建 Windows PowerShell 启动、停止和状态检查脚本。
不修改现有业务代码。
不创建父级 Git 仓库，除非用户明确要求。
所有配置必须根据项目真实技术栈生成，不得套用未经验证的假设。
如果本提示词与项目真实结构冲突，以项目实际情况为准。
三、绝对安全约束
未经用户明确授权，禁止执行：

git commit
git push
git pull
git merge
git rebase
git reset
git clean
git checkout --
git restore
删除文件
覆盖用户已有修改
修改业务源码
升级或安装依赖
启动长期运行的服务
允许执行只读检查，以及不会修改项目状态的编译、测试和语法验证命令。
发现未提交修改时：

不覆盖、不回滚。
判断是否与本任务冲突。
有冲突时停止并说明。
无冲突时也必须在报告中列出。

第一阶段：仅扫描和设计

当前只执行第一阶段。在用户明确确认前，不得创建或修改任何文件。

1. 检查工作区结构

检查：

前后端目录是否存在。
两个目录是否分别为 Git 仓库。
是否存在嵌套模块或多模块项目。
是否已经存在：
- AGENTS.md
- CLAUDE.md
- GEMINI.md
- .codex
- .agents
- .cursor
- skills
- docs
- scripts
- 其他 AI 开发规范文件
父目录是否已经是 Git 仓库。
不要初始化任何仓库。
2. 检查两个 Git 仓库
分别执行：
```
git -C "[BACKEND_DIR]" status --short --branch
git -C "[FRONTEND_DIR]" status --short --branch
git -C "[BACKEND_DIR]" branch --show-current
git -C "[FRONTEND_DIR]" branch --show-current
```
如目录不是 Git 仓库，只报告，不初始化。
3. 扫描后端项目
根据实际项目选择性检查：
README 和开发文档
构建文件，例如：
- pom.xml
- build.gradle
- build.gradle.kts
- settings.gradle
- package.json
- go.mod
- Cargo.toml
- requirements.txt
- pyproject.toml
配置文件和环境变量示例
主要源码、资源和测试目录
启动入口和启动模块
是否提供 Wrapper
Web 框架和语言版本
Controller/Handler、Service、Repository/Mapper 等组织方式
DTO、VO、Entity、Model 的现有约定
数据库类型
ORM、SQL Mapper、数据库迁移工具
鉴权、权限和异常处理方式
单元测试、集成测试、编译、打包命令
默认端口和上下文路径
所有启动、测试和构建命令必须来自真实配置，不得虚构。
4. 扫描前端项目
检查：
package.json
README
锁文件
源码目录
构建工具
框架及版本
JavaScript 或 TypeScript
UI 组件库
API 请求封装位置
路由、权限和状态管理方式
环境变量配置
单元测试和端到端测试
lint、格式化、类型检查、测试和构建命令
实际包管理器
默认开发端口
是否存在代理配置或后端地址配置
只能写入 package.json 中真实存在的命令。
5. 检查已有目标文件
对于每个已存在的目标文件：

读取内容。
总结其有效规则和用途。
说明建议保留、补充或冲突的部分。
不直接覆盖。
提出合并方案并等待确认。
6. 确认项目级 Skill 规范
根据当前运行环境的真实规范，确认项目级 Skills 应放置的位置，例如：

.agents/skills
.codex/skills
.cursor/skills
当前工具明确支持的其他目录
必须通过当前环境文档、内置说明或现有项目结构确认，不得猜测。
报告最终选择及原因。若无法确认，列出候选方案并等待用户决定。
7. 第一阶段输出格式
完成扫描后，只输出以下内容：
项目扫描结果
后端技术栈与目录约定
前端技术栈与目录约定
真实启动命令
真实验证命令
Git 仓库状态
已有 AI 规则和工作区文件
建议的 Skill 存放位置及依据
计划新增或修改的文件
对每个文件标注：
新增
合并修改
保持不变
存在冲突，需要确认
是否会覆盖已有文件
风险与待确认事项
最后明确询问用户是否进入第二阶段。

第二阶段：用户确认后实施

只有用户明确确认后才能开始。

1. 目标结构

根据扫描结果创建或补充：

[WORKSPACE_ROOT]/
├─ AGENTS.md
├─ README.md
├─ docs/
│  ├─ README.md
│  ├─ api/
│  │  └─ README.md
│  ├─ database/
│  │  └─ README.md
│  ├─ requirements/
│  │  └─ README.md
│  └─ superpowers/
│     └─ specs/
│        └─ README.md
├─ scripts/
│  ├─ start-dev.ps1
│  ├─ stop-dev.ps1
│  └─ status-dev.ps1
├─ [DETECTED_SKILLS_DIRECTORY]/
│  ├─ project-fullstack-feature/
│  │  └─ SKILL.md
│  ├─ project-api-sync/
│  │  └─ SKILL.md
│  └─ project-db-change/
│     └─ SKILL.md
├─ [BACKEND_DIR]/
│  └─ AGENTS.md
└─ [FRONTEND_DIR]/
   └─ AGENTS.md

如果目标文件已经存在，合并有效内容，不得直接替换。

2. 父目录 AGENTS.md

父级规则只管理跨项目协作，不堆积框架细节。
至少包括：

项目结构和双仓库边界
指令优先级
前后端分别提交
Git 安全规则
已有未提交代码保护规则
默认全栈开发流程
后端优先和例外条件
API 一致性检查项
设计文档规则
完成和验证标准
默认全栈流程：

阅读需求。
检查两个仓库状态。
查找前后端相似实现。
梳理数据库、接口、权限和交互。
输出设计并等待确认。
实现并验证后端。
根据真实接口实现前端。
执行联调和字段对照。
分别执行两个项目的验证命令。
展示两个仓库各自的 diff 和 status。
未经授权不提交、不推送。
API 对照至少检查：

URL 和 HTTP Method
Path、Query 和 Body 参数
请求和响应字段
分页结构
ID 精度
金额精度
日期、时区和格式
枚举值
null、undefined 和空字符串
错误码
权限标识
重要功能设计文档使用：

转载请注明作者和出处，并添加本页链接。
原文链接: //pongpongkai.top/222

全栈项目初始化

多仓库前后端全栈工作区配置任务

一、项目参数

二、核心目标

三、绝对安全约束

第一阶段：仅扫描和设计

1. 检查工作区结构

2. 检查两个 Git 仓库

3. 扫描后端项目

4. 扫描前端项目

5. 检查已有目标文件

6. 确认项目级 Skill 规范

7. 第一阶段输出格式

项目扫描结果

后端技术栈与目录约定

前端技术栈与目录约定

真实启动命令

真实验证命令

Git 仓库状态

已有 AI 规则和工作区文件

建议的 Skill 存放位置及依据

计划新增或修改的文件

是否会覆盖已有文件

风险与待确认事项

第二阶段：用户确认后实施

1. 目标结构

2. 父目录 AGENTS.md