前言¶

多人协作或长期维护项目时，缩进、换行和命名习惯不一致，会增加 diff 噪音和 Code Review 成本。本地 IDE 可以配 Prettier、clang-format 等，但不同语言要多套工具，Agent 会话里改代码也未必自动对齐团队规范。

下面介绍 SkillHub 上的「代码格式化助手」：以通用 SKILL 形式挂在 Agent 上，对代码文件做格式化、语法检查与基础优化，并声明支持 Java、Python、C++、SQL 等语言。适合希望在对话式开发里「顺手把风格收一收」的场景。

这是什么¶

「代码格式化助手」是社区来源（community）的 Agent Skill，坐标为 @user_e5701557/code-auto-formatter，当前版本 1.0.0，分类为 dev-programming，由发布者 user_e5701557 维护。SkillHub 页面标注 requires_api_key=false，安装使用不依赖额外 API Key。

官方简介概括为：自动对代码文件进行格式化、语法检查与基础优化，支持 Java/Python/C++/SQL 等多种语言，一键规范代码风格。它解决的是「在 Agent 工作流里补一层风格与基础质量检查」，而不是替代你仓库里已有的 CI 或专用 Linter 配置。

核心功能¶

依据 SkillHub 与抓取元数据，可核实的能力如下：

1. 代码格式化：对目标代码文件应用统一风格（具体规则由 Skill 内指引 Agent 执行，以安装后的 SKILL 说明为准）。
2. 语法检查：在格式化前后做基础语法层面的检查，减少明显错误进入后续步骤。
3. 基础优化：在简介范围内做轻量优化（不超出官方描述范围）。
4. 多语言：明确列出 Java、Python、C++、SQL 等；其他语言是否覆盖需以 Skill 正文为准，本文不扩展未写明的能力。

平台侧数据（以脚本抓取为准）：评分 100000，下载 802，分类 dev-programming。

安装与启用¶

Skill 基于通用 SKILL.md 格式。安装前需本机有 SkillHub CLI，并把技能装到当前 Agent 能识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。

1. 检查或安装 SkillHub CLI¶

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安装本 Skill¶

将技能安装到当前环境对应的 skills 目录。官方安装说明要求使用 --dir，例如：

skillhub install @user_e5701557/code-auto-formatter --dir <skills 目录>

常用客户端 skills 路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

Cursor 示例：

skillhub install @user_e5701557/code-auto-formatter --dir ~/.cursor/skills/

安装后按你所用客户端要求重启或刷新 Agent，使 Skill 被加载。

3. 通过对话让 AI 安装（可选）¶

SkillHub 页面提供的提示词等价于：让 AI 阅读 SkillHub 安装与优先源配置，并安装 @user_e5701557/code-auto-formatter。适合已习惯用自然语言驱动环境的读者。

典型用法¶

官方页面未单独给出业务代码示例；可复现的流程是「安装 → 在 Agent 中启用 Skill → 针对具体文件提出格式化需求」。

1. 确认 code-auto-formatter 已出现在当前 Agent 的 skills 目录中。
2. 在对话中说明要处理的文件路径或粘贴片段，并明确要求按本 Skill 做格式化、语法检查或基础优化（语言需在 Skill 支持范围内，如 Python、Java 等）。
3. 在 Agent 执行修改后，用本地测试、编译或既有 Linter 再验一遍；Skill 描述的是「助手层」能力，不替代项目级质量门禁。

因 requires_api_key=false，一般无需在环境变量中配置第三方格式化服务的 Key；若 Skill 正文要求调用本地工具，以安装包内 SKILL.md 为准。

适用场景与注意¶

适合：

• 在 Cursor、Claude Code、Codex 等支持 Skills 的客户端里，希望 Agent 改代码后顺带统一风格。
• 多语言仓库里，想用同一套对话习惯触发「格式化 + 基础检查」，减少手动切换格式化配置的次数。

注意：

• 格式化结果是否与团队规范完全一致，取决于 Skill 内规则及 Agent 对本地工具的调用方式；关键分支仍建议以仓库内的 formatter 配置和 CI 为准。
• 简介中的「基础优化」边界未在公开元数据中展开，勿假定等同于重构或性能调优。
• 安装统计中的「安装 0」来自抓取快照，仅作平台展示参考；以你本机 skills 目录是否出现该 Skill 为准。

结尾¶

「代码格式化助手」把多语言代码的格式化、语法检查与基础优化收敛到一个 SkillHub 技能里，坐标 @user_e5701557/code-auto-formatter，无需 API Key 即可按文档安装。若你已在用 Agent 写代码，可先装到 ~/.cursor/skills/（或对应客户端路径），再在对话里对具体文件发起格式化需求。

• SkillHub 页面：https://www.skillhub.cn/skills/user_e5701557/code-auto-formatter
• 安装说明：https://skillhub.cn/install/skillhub.md
• 元数据 API（供工具拉取）：https://api.skillhub.cn/user_e5701557/code-auto-formatter