Files
adminandClaude 7c4ae39664 refactor(skill): 仓根即技能本体 —— 技能资产进版本控制 + 三处软链指向同一仓
影响:此前技能资产(SKILL.md / HOWTO_MODULE.md / PERMISSION.md / MIGRATION.md /
JNPF_SOURCE_AUDIT.md / JNPF_COMPAT_SURFACE.md / references/ / template-boot-jnpf/)
实体住在 ~/.agents/skills/ssw-jnpf-lite-rust/(仓外、不在 git)⇒ 改仓不生效、实体与仓漂移。
现在仓根 = 技能根(对齐 ssw-jnpf-lite-react 的形态),~/.agents · ~/.claude · ~/.workbuddy
(+ ~/.qwenworkcn)四处软链全部解析到同一个仓 ⇒ 改一次仓 = 改一次技能。

改动:
- 新增根级技能文档 6 份:SKILL.md(并补 frontmatter:name/description/type,原文件没有 frontmatter
  只靠目录名兜底)/ HOWTO_MODULE.md / PERMISSION.md / MIGRATION.md / JNPF_SOURCE_AUDIT.md /
  JNPF_COMPAT_SURFACE.md;references/ 与 template-boot-jnpf/ 一并入仓
- 根 README.md 改为技能版(选型/运行/验收门/已知限制),旧项目版 README 移入 docs/README-project.md
- docs/ 下 3 份与根级同源的文档删除(技能版取代),全仓链接改指根级(已修全部相对链接,无坏链)
- docs/ 保留契约真源 contract.md / runbook.md / decisions.md / known-limitations.md / ddl/
- Cargo.toml 取「技能版注释 + 仓版补充」合并;run.sh 用仓版(多旧名兜底 pkill)
- SKILL.md 补 frontmatter + 「技能目录 = 仓根」说明;CLAUDE.md 目录速览同步;HANDOFF.md 技能资产
  描述同步;工作日志补第三段

验证:cargo build --release 0 error · cargo test 195 passed/0 failed · check-module.sh PASS=57
FAIL=0 · 面 A 尺子 PASS=32 FAIL=0 · 面 B 尺子 PASS=18 FAIL=0 SKIP=0(覆盖 18/18)

Co-Authored-By: Claude <[email protected]>
2026-10-26 16:56:58 +08:00

125 lines
5.3 KiB
Bash
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env bash
# template-boot-jnpf/ 一键自检脚本
#
# 用途:验证从本模板复制走的副本(jxcj-boot 等)是否"5 项关键修复都还在"。
# 当用户把模板改名/换包后忘了某项时,跑这个脚本能立即定位。
#
# 用法:
# cd /path/to/your-boot # 例如 /Users/xs/Desktop/jxcj/boot
# bash ../scripts/verify.sh # 或 bash scripts/verify.sh
#
# 检测 5 项(每项 PASS/FAIL + 修复指引):
# 1. mvn package 全绿(验证依赖解析 + 编译)
# 2. ssw-admin/target/*-SNAPSHOT.jar 是 fat jar(大小 > 100M)
# 3. jar Manifest 含 Start-Class=ssw.SswAdminApplication
# 4. DemoMapper.class 含 @DS(value="ssw-demoDs")(动态多数据源切换)
# 5. 父 POM 含 <jnpf.version> 属性 + <dependencyManagement> 锁版本
set -u
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
PASS=0; FAIL=0
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
no() { echo " ❌ $1"; FAIL=$((FAIL+1)); }
hdr() { echo; echo "── $1 ──"; }
cd "$ROOT" || { echo "❌ 无法 cd 到 $ROOT"; exit 1; }
# ---- 1. mvn package ----
hdr "1. mvn -pl ssw-admin -am package -DskipTests(验证依赖 + 编译)"
if mvn -pl ssw-admin -am package -DskipTests -o 2>&1 | tail -5 | grep -q "BUILD SUCCESS"; then
ok "BUILD SUCCESS"
else
no "mvn package 失败(最常见:jnpf-* 1.0.0-SNAPSHOT absent → 父 POM 没锁版本;看 README '验证记录' #1)"
fi
# ---- 2. fat jar 检查 ----
hdr "2. ssw-admin fat jar 大小(应 > 100M)"
JAR="$ROOT/ssw-admin/target/ssw-admin-*-SNAPSHOT.jar"
JAR_FILE="$(ls $JAR 2>/dev/null | grep -v "\.original$" | head -1 || true)"
if [ -z "${JAR_FILE:-}" ]; then
no "找不到 ssw-admin/target/*-SNAPSHOT.jar(运行 step 1 重打)"
elif [ ! -f "${JAR_FILE:-}" ]; then
no "${JAR_FILE} 不存在"
else
SIZE=$(stat -f %z "${JAR_FILE}" 2>/dev/null || stat -c %s "${JAR_FILE}" 2>/dev/null)
SIZE_M=$((SIZE / 1024 / 1024))
if [ "$SIZE_M" -gt 100 ]; then
ok "fat jar ${SIZE_M}M(${JAR_FILE})"
else
no "${JAR_FILE} 只有 ${SIZE_M}M(瘦 jar;spring-boot-maven-plugin 没绑 repackage → README '验证记录' #5)"
fi
fi
# ---- 3. Manifest ----
hdr "3. jar Manifest 含 Start-Class=ssw.SswAdminApplication"
if [ -n "${JAR_FILE:-}" ] && [ -f "${JAR_FILE:-}" ]; then
MANIFEST="$(unzip -p "${JAR_FILE}" META-INF/MANIFEST.MF 2>/dev/null || true)"
if echo "$MANIFEST" | grep -q "Main-Class: org.springframework.boot.loader.launch.JarLauncher"; then
ok "Main-Class 是 JarLauncher(Spring Boot fat jar 入口)"
else
no "Main-Class 不是 JarLauncher(瘦 jar 形态,不是 Spring Boot fat jar)"
fi
if echo "$MANIFEST" | grep -q "Start-Class: ssw.SswAdminApplication"; then
ok "Start-Class = ssw.SswAdminApplication"
else
no "Start-Class 不是 ssw.SswAdminApplication(ssw-admin/pom.xml 的 mainClass 配错?)"
fi
else
no "跳过(jar 不存在)"
fi
# ---- 4. DemoMapper 含 @DS ----
hdr "4. DemoMapper 含 @DS(value=\"ssw-demoDs\")"
if [ -n "${JAR_FILE:-}" ] && [ -f "${JAR_FILE:-}" ]; then
DEMO_MAPPER_JAR="$(unzip -l "$JAR_FILE" 2>/dev/null | grep -oE 'BOOT-INF/lib/ssw-demo-controller-[^ ]+\.jar' | head -1)"
if [ -z "$DEMO_MAPPER_JAR" ]; then
no "BOOT-INF/lib/ 里找不到 ssw-demo-controller-*.jar(业务模块没打包进 fat jar)"
else
TMP="$(mktemp -d)"
unzip -p "${JAR_FILE}" "$DEMO_MAPPER_JAR" > "$TMP/demo-controller.jar" 2>/dev/null || true
unzip -p "$TMP/demo-controller.jar" "ssw/demo/mapper/DemoMapper.class" > "$TMP/DemoMapper.class" 2>/dev/null || true
if javap -v "$TMP/DemoMapper.class" 2>/dev/null | grep -q "Lcom/baomidou/dynamic/datasource/annotation/DS;"; then
if javap -v "$TMP/DemoMapper.class" 2>/dev/null | grep -A2 "DS;" | grep -q 'ssw-demoDs'; then
ok "@DS(value=\"ssw-demoDs\") 在 DemoMapper.class 字节码里"
else
no "@DS 注解存在但 value 不是 ssw-demoDs(业务库 key 与 application-dev.yml 对不上?)"
fi
else
no "DemoMapper.class 完全没有 @DS 注解(业务表会落进 master 库;改 DemoMapper.java 加 @DS)"
fi
rm -rf "$TMP"
fi
else
no "跳过(jar 不存在)"
fi
# ---- 5. 父 POM 含 jnpf.version + dependencyManagement ----
hdr "5. 父 POM 含 <jnpf.version> 属性 + <dependencyManagement> 锁版本"
PARENT_POM="$ROOT/pom.xml"
if grep -q "<jnpf.version>" "$PARENT_POM"; then
VERSION=$(grep -oE "<jnpf.version>[^<]+" "$PARENT_POM" | sed 's/<jnpf.version>//')
ok "jnpf.version = ${VERSION}"
else
no "父 POM 没有 <jnpf.version> 属性(jnpf-* 依赖会解析成 1.0.0-SNAPSHOT → README '验证记录' #1)"
fi
if grep -q "jnpf-common-core" "$PARENT_POM" | grep -q "dependencyManagement" "$PARENT_POM"; then
if awk '/<dependencyManagement>/,/<\/dependencyManagement>/' "$PARENT_POM" | grep -q "jnpf-common-core"; then
ok "dependencyManagement 里锁了 jnpf-common-core"
else
no "dependencyManagement 段里没有 jnpf-common-core(jnpf-* 解析会污染)"
fi
else
no "父 POM 完全没有 <dependencyManagement>(jnpf-* 解析污染 1.0.0-SNAPSHOT)"
fi
# ---- 总结 ----
echo
echo "── 总结 ──"
echo "PASS=$PASS FAIL=$FAIL"
if [ "$FAIL" -eq 0 ]; then
echo "全 ✅ 模板产物与 README 验证记录一致"
exit 0
else
echo "有 ❌ — 看上面 FAIL 行的指引 + template-boot-jnpf/README.md '验证记录' 章节"
exit 1
fi