关于 codefmt
codefmt 是按项目代码风格格式化源文件的技能。仓库可通过 IDE 访问时使用 IntelliJ 格式化器,否则在控制台调用项目的外部格式化器。
主要功能
- 01选择 IDE 或命令行路径
- 02可用时使用 IntelliJ 格式化器
- 03回退到项目外部格式化器
- 04通过 IDE 格式化代码块
- 05用 git diff 报告文件变更
适用场景
- 01格式化项目仓库中的文件
- 02通过 IDE 格式化选定代码块
- 03IDE 不可用时运行外部格式化器
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ amplicode/ spring-skills --skill codefmt安装后在 Claude Code 中输入/codefmt确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/fallback.mdide.mdscripts/format-code-block.ktsformat-file-group.ktsformat-single-file.ktsformat-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