mcpField
C
codefmt

codefmt

github.com/amplicode开发134253 次安装7 周前更新
代码仓库

关于 codefmt

codefmt 是按项目代码风格格式化源文件的技能。仓库可通过 IDE 访问时使用 IntelliJ 格式化器,否则在控制台调用项目的外部格式化器。

主要功能

  1. 01选择 IDE 或命令行路径
  2. 02可用时使用 IntelliJ 格式化器
  3. 03回退到项目外部格式化器
  4. 04通过 IDE 格式化代码块
  5. 05用 git diff 报告文件变更

适用场景

  1. 01格式化项目仓库中的文件
  2. 02通过 IDE 格式化选定代码块
  3. 03IDE 不可用时运行外部格式化器

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/amplicode/spring-skills --skill codefmt

安装后在 Claude Code 中输入/codefmt确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
fallback.md
ide.md
scripts/
format-code-block.kts
format-file-group.kts
format-single-file.kts
format-uncommitted.kts

详细介绍

使用项目代码风格格式化源文件

有两种方式可以应用相同的代码风格:IDE 通过 IntelliJ 自带的格式化程序应用风格(保真度最高,并能保持 IDE 的 VFS/PSI 缓存一致);CLI 回退方案 则在无法访问 IDE 时,通过项目自带的外部格式化程序(Spotless / google-java-format / palantir-java-format)应用风格。

选择方式

先在此处进行探测,再加载任一参考文档——这样只需阅读所需的文档。调用 steroid_list_projects(如果尚未加载工具架构,则通过 ToolSearch("steroid list projects execute code") 调用):

  • 返回当前所在的仓库 → IDE 方式:记下该条目的 project_name (不透明的路由键,不是人类可读的 name),并遵循 references/ide.md。其中的操作指南默认已知 project_name——不要再次探测。
  • 调用失败或未列出当前仓库 → CLI 回退方案:遵循 references/fallback.md(检测 Spotless / java-format,并在控制台中运行),并事先告知用户,由于无法访问 IDE,将使用 外部格式化程序回退方案。

代码块 / 行范围格式化(IDE 操作指南 2)仅适用于 IDE——CLI 没有完全等效的方式。如果用户要求格式化代码块,而 IDE 无法访问,请明确说明,不要悄悄改为重新格式化整个文件。

两种方式最后都要执行 git diff --stat <paths>,并报告实际发生的更改。格式化后没有差异也是有效结果——这表示文件本来就符合代码风格;请直截了当地说明,不要暗示已经进行了更改。

评论

支持 Markdown