chore: sync with upstream e7cb442 + update zh translations

This commit is contained in:
xuxiang
2026-02-02 18:57:56 +08:00
parent 6f87d43c19
commit d7cafbe582
66 changed files with 9395 additions and 1465 deletions

View File

@@ -1,100 +1,100 @@
---
name: springboot-verification
description: Verification loop for Spring Boot projects: build, static analysis, tests with coverage, security scans, and diff review before release or PR.
description: Spring Boot 项目的验证循环Verification loop包含构建、静态分析、带覆盖率的测试、安全扫描以及在发布或 PR 前的差异评审diff review
---
# Spring Boot Verification Loop
# Spring Boot 验证循环(Verification Loop
Run before PRs, after major changes, and pre-deploy.
在提交 PR 前、发生重大变更后以及预部署阶段运行此流程。
## Phase 1: Build
## 阶段 1构建Build
```bash
mvn -T 4 clean verify -DskipTests
# or
# 或者
./gradlew clean assemble -x test
```
If build fails, stop and fix.
如果构建失败,请停止并修复。
## Phase 2: Static Analysis
## 阶段 2静态分析Static Analysis
Maven (common plugins):
Maven(常用插件):
```bash
mvn -T 4 spotbugs:check pmd:check checkstyle:check
```
Gradle (if configured):
Gradle(如果已配置):
```bash
./gradlew checkstyleMain pmdMain spotbugsMain
```
## Phase 3: Tests + Coverage
## 阶段 3测试 + 覆盖率(Tests + Coverage
```bash
mvn -T 4 test
mvn jacoco:report # verify 80%+ coverage
# or
mvn jacoco:report # 验证 80% 以上的覆盖率
# 或者
./gradlew test jacocoTestReport
```
Report:
- Total tests, passed/failed
- Coverage % (lines/branches)
报告指标:
- 测试总数、通过/失败数量
- 覆盖率 %(行/分支)
## Phase 4: Security Scan
## 阶段 4安全扫描Security Scan
```bash
# Dependency CVEs
# 依赖项 CVE 漏洞扫描
mvn org.owasp:dependency-check-maven:check
# or
# 或者
./gradlew dependencyCheckAnalyze
# Secrets (git)
git secrets --scan # if configured
# 密钥(Secrets)扫描 (git)
git secrets --scan # 如果已配置
```
## Phase 5: Lint/Format (optional gate)
## 阶段 5代码规范/格式化Lint/Format可选阈值
```bash
mvn spotless:apply # if using Spotless plugin
mvn spotless:apply # 如果使用了 Spotless 插件
./gradlew spotlessApply
```
## Phase 6: Diff Review
## 阶段 6差异评审Diff Review
```bash
git diff --stat
git diff
```
Checklist:
- No debugging logs left (`System.out`, `log.debug` without guards)
- Meaningful errors and HTTP statuses
- Transactions and validation present where needed
- Config changes documented
自查清单(Checklist
- 未残留调试日志(如 `System.out`,或缺少防护检查的 `log.debug`
- 错误信息和 HTTP 状态码具有明确语义
- 在必要处已包含事务(Transactions和校验Validation
- 配置变更已记录在文档中
## Output Template
## 输出模版(Output Template
```
VERIFICATION REPORT
验证报告 (VERIFICATION REPORT)
===================
Build: [PASS/FAIL]
Static: [PASS/FAIL] (spotbugs/pmd/checkstyle)
Tests: [PASS/FAIL] (X/Y passed, Z% coverage)
Security: [PASS/FAIL] (CVE findings: N)
Diff: [X files changed]
构建 (Build): [通过/失败]
静态分析 (Static): [通过/失败] (spotbugs/pmd/checkstyle)
测试 (Tests): [通过/失败] (通过 X/Y覆盖率 Z%)
安全 (Security): [通过/失败] (CVE 发现数量: N)
差异 (Diff): [X 个文件已变更]
Overall: [READY / NOT READY]
结论 (Overall): [就绪 / 未就绪]
Issues to Fix:
待修复问题:
1. ...
2. ...
```
## Continuous Mode
## 持续模式(Continuous Mode
- Re-run phases on significant changes or every 3060 minutes in long sessions
- Keep a short loop: `mvn -T 4 test` + spotbugs for quick feedback
- 在发生显著变更时,或在长会话中每 3060 分钟重新运行各阶段。
- 保持短反馈循环:运行 `mvn -T 4 test` + spotbugs 以获得快速反馈。
**Remember**: Fast feedback beats late surprises. Keep the gate strict—treat warnings as defects in production systems.
**记住**快速反馈优于后期惊讶。保持严格的准入门槛——在生产系统中将警告Warnings视为缺陷Defects