Commit f552c19f32b3ad675d5c61a9a45d90dcfd0f4b53
1 parent
3ead762c
refactor(skills): 后端构建工具从 Maven 整体切换为 Gradle 最新版
技术栈定义、生成端与校验护栏全路径统一为 Gradle (Kotlin DSL) + Gradle Wrapper： - docs-04 技术栈表：Maven 3.9.x -> Gradle 最新稳定版 - gitignore 模板：target/ -> .gradle/ + build/ - Flyway 依赖声明位置 pom.xml -> build.gradle.kts (CLAUDE 模板 / README) - 测试/护栏命令 mvn test -> ./gradlew test (README / feature-tdd / feature-verify / feature-plan) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Showing
7 changed files
with
10 additions
and
9 deletions
README.md
| ... | ... | @@ -309,9 +309,9 @@ step 0 流程图被抽到独立 `.txt` 文件,SKILL.md 步骤 0 改为 `bash cat |
| 309 | 309 | |
| 310 | 310 | - **MySQL 8.x** 实例已就绪（推荐本地 / `*.local` host；A4 `db-init` 的安全守护要求 host 在白名单且 schema 名含 `test`/`dev`/`local`，避免误删生产库） |
| 311 | 311 | - **`mysql` 命令行**：A4 `db-init` 验证连接 + 自动 `DROP+CREATE` schema 后 apply V1；`scripts/setup-test-db.sh` 在测试闸门前后 drop+create 空库 |
| 312 | -- **Spring Boot + Flyway**（**必需**）：pom.xml 声明 `flyway-core` + `flyway-mysql`；Spring 启动时自动 apply `sql/migrations/V*.sql`。本插件生成的 `setup-test-db.sh` 只清库，schema 必须由 Flyway 应用 | |
| 312 | +- **Spring Boot + Flyway**（**必需**）：`build.gradle.kts` 声明 `flyway-core` + `flyway-mysql`；Spring 启动时自动 apply `sql/migrations/V*.sql`。本插件生成的 `setup-test-db.sh` 只清库，schema 必须由 Flyway 应用 | |
| 313 | 313 | - **本地 git 仓库**（纯本地，无需远程）：A0 `project-init` 执行 `git init`；B 阶段每模块由 `milestone-tag` 本地 `git merge --no-ff` 进默认分支并 `git tag -a milestone/<id>`，完成信号由 `git tag -l` 判定。**不依赖任何远程仓库 / push / GitLab** |
| 314 | -- **本地可运行 `mvn test` / `pnpm test`**：测试闸门 `scripts/test.sh` 由 `skeleton-gen` 生成 | |
| 314 | +- **本地可运行 `./gradlew test` / `pnpm test`**：测试闸门 `scripts/test.sh` 由 `skeleton-gen` 生成 | |
| 315 | 315 | |
| 316 | 316 | ## 设计原则 |
| 317 | 317 | ... | ... |
skills/coding/feature-plan/SKILL.md
| ... | ... | @@ -17,7 +17,7 @@ allowed-tools: Read Write Grep Skill AskUserQuestion |
| 17 | 17 | |
| 18 | 18 | - Plan 告诉 TDD 执行者**做什么**，不是**怎么写代码**——执行者是 `feature-tdd`（同一模型，全上下文），不是机械复制粘贴员 |
| 19 | 19 | - Plan 锁定**文件边界 + 测试意图 + API 形状 + 完成判据**；代码由 TDD 红绿循环产出 |
| 20 | -- **禁止 dump 整个文件内容**（pom.xml / entity 类 / config 文件）到 plan——plan 和代码会成为两个 source of truth 并漂移；2000+ 行 plan 浪费上下文 | |
| 20 | +- **禁止 dump 整个文件内容**（build.gradle.kts / entity 类 / config 文件）到 plan——plan 和代码会成为两个 source of truth 并漂移；2000+ 行 plan 浪费上下文 | |
| 21 | 21 | - DRY、YAGNI、TDD、frequent commits |
| 22 | 22 | |
| 23 | 23 | ## 占位符规则 | ... | ... |
skills/coding/feature-tdd/SKILL.md
| ... | ... | @@ -32,7 +32,7 @@ allowed-tools: Read Write Edit Agent Skill Bash(git add *) Bash(git commit *) |
| 32 | 32 | |
| 33 | 33 | ## 护栏 |
| 34 | 34 | |
| 35 | -- **绝不**在主会话直接跑 `mvn test` / `pnpm test` / `scripts/test.sh`，必须通过子会话 | |
| 35 | +- **绝不**在主会话直接跑 `./gradlew test` / `pnpm test` / `scripts/test.sh`，必须通过子会话 | |
| 36 | 36 | - **绝不**在主会话直接 `mysql -e "ALTER ..."`；业务 schema 改动一律走 `sql/migrations/V*.sql` 文件（只读查询 / 临时调试除外） |
| 37 | 37 | - 每次 commit 必须含 `REQ-XXX-NNN` 标签；不混合无关改动到同一 commit |
| 38 | 38 | - **后端阶段路径硬护栏**：任务表里的 `impl_file` 路径以 `frontend/` 开头 → 硬停并打印 `feature-tdd 后端阶段不允许写前端代码：<impl_file>。请检查 plan 任务定义；UI 推迟到前端阶段（fe-feature-*）`，不再继续 TDD 循环 | ... | ... |
skills/coding/feature-verify/SKILL.md
| ... | ... | @@ -13,7 +13,7 @@ allowed-tools: Skill Read Agent |
| 13 | 13 | |
| 14 | 14 | ## 执行步骤 |
| 15 | 15 | |
| 16 | -1. 从 plan 文件或项目标准命令中确定功能的测试目标（如 Maven profile / pnpm script / pytest path）。 | |
| 16 | +1. 从 plan 文件或项目标准命令中确定功能的测试目标（如 Gradle task / pnpm script / pytest path）。 | |
| 17 | 17 | 2. 派发 Agent 子会话（general-purpose）运行该目标，子会话只返回结构化 JSON（不输出描述文字）： |
| 18 | 18 | ```json |
| 19 | 19 | { | ... | ... |
skills/plan/project-init/templates/CLAUDE-template.md
| ... | ... | @@ -138,7 +138,7 @@ B 阶段分两段，**全部固化到 skills**。入口：`/erp-workflow:coding- |
| 138 | 138 | |
| 139 | 139 | 1. **文件命名**：`sql/migrations/V<n>__<snake_case_desc>.sql`，例：`V5__add_user_email_unique_index.sql` |
| 140 | 140 | 2. **版本号分配**：建文件前 `ls sql/migrations/V*.sql` 查当前最大 n，新文件 `n_max + 1` |
| 141 | -3. **Apply 方式**：Spring Boot 启动 / 测试启动时 Flyway 自动 apply（项目必须在 `pom.xml` 声明 `flyway-core` + `flyway-mysql` 依赖）。`scripts/setup-test-db.sh` 只负责清空库，不做 apply | |
| 141 | +3. **Apply 方式**：Spring Boot 启动 / 测试启动时 Flyway 自动 apply（项目必须在 `build.gradle.kts` 声明 `flyway-core` + `flyway-mysql` 依赖）。`scripts/setup-test-db.sh` 只负责清空库，不做 apply | |
| 142 | 142 | 4. **已合并的 migration 永不修改**：发现错了写一个补救 migration（如 `V7__fix_V5_index_name.sql`），旧 `V_n.sql` |
| 143 | 143 | 5. **临时调试 DDL**：临时在本地试字段/索引可手动 `mysql -e`，但不写 migration；下次 `setup-test-db.sh` 会 drop+create 清掉 |
| 144 | 144 | 6. **A4 生成的 V1**：`V1__initial_schema.sql` 是 A 阶段由 `db-init` 从 `docs/03-数据库设计文档.md`（A3 正向设计的 schema SSoT）翻译生成的初始版本；后续 V2/V3/... 由 B 阶段每个 REQ 按需写入，**同时**反向同步更新 docs/03 对应表小节以保持 SSoT 一致 | ... | ... |
skills/plan/project-init/templates/docs-04-stack-template.md
| ... | ... | @@ -21,7 +21,7 @@ |
| 21 | 21 | | 接口风格 | RESTful API | 统一规范 | 前后端接口设计规范 | |
| 22 | 22 | | 权限认证 | Spring Security / JWT | 最新稳定版 | 登录认证、权限控制 | |
| 23 | 23 | | API 文档 | OpenAPI / Swagger | 最新稳定版 | 接口文档与调试 | |
| 24 | -| 项目构建管理 | Maven | 3.9.x | Java 项目依赖与构建 | | |
| 24 | +| 项目构建管理 | Gradle (Kotlin DSL) | 最新稳定版（8.x / 9.x） | Java 项目依赖与构建；统一用 Gradle Wrapper (`./gradlew`)，构建脚本 `build.gradle.kts` | | |
| 25 | 25 | | JDK 运行环境 | Java | 17 / 21 | Spring Boot 3 推荐版本 | |
| 26 | 26 | | 部署容器 | Docker | 最新稳定版 | 容器化部署 | |
| 27 | 27 | | Web 服务器 / 反向代理 | Nginx | 最新稳定版 | 前端托管、反向代理、负载分发 | | ... | ... |