用途:code-formatter 是一个代码格式化技能,用于在当前目录或指定路径中检测代码文件类型,并按既有项目配置或语言最佳实践自动格式化代码。
主要能力:支持 JavaScript/TypeScript(Prettier)、Python(Black、autopep8)、Go(gofmt)、Rust(rustfmt)、Java(Google Java Format),以及 CSS/SCSS/LESS、HTML、JSON/YAML、Markdown。应用格式时优先使用现有项目配置(如 .prettierrc、.editorconfig、pyproject.toml);若无配置,则参考语言最佳实践与流行风格指南(如 Python 的 PEP 8、StandardJS、Google Style Guide)。完成后会汇总格式化的内容与风格决策。
使用方式:通过调用 @code-formatter;也可指定路径 @code-formatter src/、仅检查 @code-formatter --check-only、指定语言 @code-formatter --language python。
内置规则:JavaScript/TypeScript/CSS 用 2 空格缩进;Python 用 4 空格;Go 用制表符;最大行长 100 字符(除非项目配置另有规定);JavaScript 使用分号(除非项目采用 StandardJS);JavaScript 首选单引号(除非项目配置另规定);多行结构使用尾随逗号。
限制与注意:始终尊重现有项目配置文件;修改配置文件前会先询问;不格式化生成代码或 vendor 目录;跳过二进制文件和锁文件。其他能力或平台支持暂未提供。