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

96 lines
3.9 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!--
template-boot-jnpf 父 POM — 把 ssw-jnpf-lite-react 的 NestJS 后端迁到 JNPF 标准栈(jnpf-common-*)的最小骨架。
继承自官方 jnpf-common 7.0.0-RELEASE,统一管理三段子模块。
⚠️ 不要改 parent 路径:jnpf-common 内嵌 BOM <dependencyManagement>,子模块用 ${jnpf.version}
即可拿到所有 jnpf-* 依赖的精确版本。
-->
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<parent>
<groupId>com.jnpf</groupId>
<artifactId>jnpf-common</artifactId>
<version>7.0.0-RELEASE</version>
<relativePath></relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>
<!--
groupId 是 Maven 坐标;Java 包名是 `ssw.*`,二者不必同。
改 groupId 时同步把所有子模块 pom 的 <parent><groupId> 也改一遍。
-->
<groupId>com.example</groupId>
<artifactId>ssw-boot</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<modules>
<module>ssw-admin</module>
<module>ssw-demo</module>
</modules>
<properties>
<java.version>17</java.version>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!--
⚠️ jnpf-* 依赖统一引用此版本号。
原因:jnpf-common 父 POM 的 dependencyManagement 用 ${project.version} 占位,
被我们的 ssw-boot 继承后 ${project.version} 展开成 ssw-boot 自己的版本(1.0.0-SNAPSHOT),
导致 jnpf-common-core / jnpf-common-database 解析成不存在的 1.0.0-SNAPSHOT → "absent" 错误。
用 jnpf.version 显式固定,可绕过此坑。
-->
<jnpf.version>7.0.0-RELEASE</jnpf.version>
</properties>
<!--
⚠️ 把 jnpf-common 父 BOM 里"用 ${project.version} 占位的 jnpf-*"重新声明一次,
显式锁到 ${jnpf.version}。这是覆盖式 dependencyManagement,会**完全替换**父 POM 的同名 entry。
漏一个就会出现 "1.0.0-SNAPSHOT absent" 报错 — 报错会指出具体哪个 artifact,照着补全即可。
启动阶段先列这 4 个最常用的;实际编译报错再补全。
-->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.jnpf</groupId>
<artifactId>jnpf-common-core</artifactId>
<version>${jnpf.version}</version>
</dependency>
<dependency>
<groupId>com.jnpf</groupId>
<artifactId>jnpf-common-database</artifactId>
<version>${jnpf.version}</version>
</dependency>
<dependency>
<groupId>com.jnpf</groupId>
<artifactId>jnpf-common-auth</artifactId>
<version>${jnpf.version}</version>
</dependency>
<dependency>
<groupId>com.jnpf</groupId>
<artifactId>jnpf-common-redis</artifactId>
<version>${jnpf.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>