format

name	format
description	对整个项目或指定模块批量格式化 Java 代码（spotless + eclipse-formatter）。支持传入模块根、模块内子目录或 .java 文件路径。
disable-model-invocation	true

/format Skill

对 Java 代码批量执行格式化（spotless + eclipse P3C-CodeStyle）。

触发场景

用户输入：

• /format —— 对整个项目跑 mvn spotless:apply
• /format <path> —— 定位 path 所属的 Maven 模块，对该整个模块执行 spotless

path 参数语义

• path 可以是模块根、模块内任意子目录、单个 .java 文件，绝对路径或相对项目根的路径均可
• 无论 path 指向多深，实际执行粒度都是模块级：向上找最近的 pom.xml 定位所属模块，然后对该模块整体跑一遍。spotless 有增量缓存，未变更文件近乎零成本
• 若 path 指向项目聚合根，等同 /format（不带参数）
• 若 path 不存在、或向上找不到 pom.xml → 报错并结束

执行步骤

1. 使用 Bash 工具在项目根加载 helper 并解析参数：

   source .claude/hooks/lib/common.sh
   ensure_java_home || { warn_missing_java_home; exit 1; }
   
   PROJECT_ROOT="$(find_project_root)"
   cd "$PROJECT_ROOT"
   
   ARG="<用户传入的 path，可能为空>"
   if [[ -z "$ARG" ]]; then
     mvn -q -B spotless:apply
   
     
      [[ ! -e  ]]; 
        
        
        
        1
     
     MOD= || {
        
        
        
        1
     }
     
      [[  ==  ]]; 
       mvn -q -B spotless:apply
     
       REL=
       mvn -q -B -pl  spotless:apply