feat(language): 增加 Java 与 Python 技术提供方

2026-09-03 17:12:33 +08:00
parent 127bc4e7c1
commit 199a14daea
20 changed files with 208 additions and 0 deletions
@@ -0,0 +1,16 @@
+{
+  "name": "java",
+  "version": "0.1.0",
+  "description": "Java、JDK、构建工具和 Spring 技术能力资料。",
+  "author": { "name": "CraftKit" },
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Java",
+    "shortDescription": "Java 与 Spring 技术能力资料",
+    "longDescription": "按项目 Java、构建工具和 Spring 版本提供设计、命令与专项审查资料。",
+    "developerName": "CraftKit",
+    "category": "Productivity",
+    "capabilities": ["Read"],
+    "defaultPrompt": ["帮我按当前项目版本获取 Java 技术约束。"]
+  }
+}
@@ -0,0 +1,22 @@
+---
+name: profile
+description: 根据项目中的 Java、JDK、Maven、Gradle 和 Spring 证据提供版本匹配的设计、命令和专项审查资料。适用于核心工作流请求 Java 技术能力；通用业务实现或无法确认 Java 项目时不应触发。
+---
+
+# Java Profile
+
+读取自身[能力清单](references/manifest.json)，根据目标模块的构建文件和项目画像返回匹配能力。
+
+## 工作流
+
+1. 从 `pom.xml`、Gradle 文件、Wrapper、工具链配置和 `.craftkit/project.json` 提取 Java 与 Spring 版本证据。
+2. 只选择版本范围匹配的 Profile；版本未知时只使用 `java/default`。
+3. 按请求能力读取对应资料，返回逻辑资料标识、适用版本和证据。
+4. 项目已有命令优先于[命令规则](references/commands/index.md)。
+5. 缺失能力或版本不匹配时返回明确状态，不写项目文件。
+
+## 边界
+
+- 不默认最新 JDK、Spring 或构建插件版本。
+- 不安装 JDK、Maven、Gradle 或项目依赖。
+- 不调用 `dev`，最终设计、实现和审查由核心 Skill 负责。
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Java Profile（java:profile）"
+  short_description: "按项目版本提供 Java 与 Spring 技术资料"
+  default_prompt: "使用 $profile 获取当前项目适用的 Java 技术能力。"
@@ -0,0 +1,7 @@
+# Java 后端设计资料
+
+- 先从构建文件确认 Java、Spring 和持久化框架精确版本。
+- 领域服务、协议入口和持久化实现保持明确边界，事务范围围绕业务一致性定义。
+- Spring 代理、事务传播和异步边界必须以当前项目版本及真实调用路径为依据。
+- DTO、领域对象和持久化对象分别承担各自边界，转换位置遵循项目现有结构。
+- 并发、幂等和失败恢复必须说明数据库约束、条件更新或锁的真实落点。
@@ -0,0 +1,6 @@
+# Java 命令选择
+
+1. 优先使用仓库中的 Maven Wrapper 或 Gradle Wrapper。
+2. 其次使用项目文档和 CI 中已经验证的命令。
+3. 没有 Wrapper 或项目命令时只给出待确认建议，不假定全局工具存在。
+4. Profile 返回命令建议不代表已经获得执行、安装或修改依赖的授权。
@@ -0,0 +1,3 @@
+# Java 回退
+
+版本未知时只使用 Java 版本中性的设计和审查原则。Spring 或构建工具无法确认时不加载对应专属规则，并说明缺少的证据。
@@ -0,0 +1,18 @@
+{
+  "schemaVersion": 1,
+  "provider": { "id": "java", "kind": "language", "displayName": "Java" },
+  "profiles": [
+    {
+      "id": "java/default",
+      "version": { "scheme": "java-feature", "range": "*" },
+      "priority": 10,
+      "detect": { "manifests": ["pom.xml", "build.gradle", "build.gradle.kts"], "wrappers": ["mvnw", "gradlew"] },
+      "capabilities": {
+        "backend-design": "references/backend/design.md",
+        "language-review": "references/review/index.md",
+        "command-resolution": "references/commands/index.md"
+      },
+      "fallback": "references/fallback.md"
+    }
+  ]
+}
@@ -0,0 +1,6 @@
+# Java 专项审查资料
+
+- 检查 Java 版本、编译选项和预览特性是否匹配。
+- 检查资源关闭、异常传播、空值、泛型、并发可见性和序列化边界。
+- Spring 项目额外检查代理失效、事务边界、Bean 生命周期和线程上下文。
+- 只报告有调用上下文和明确影响的问题，避免把个人风格作为缺陷。