用途:这是一个代码格式化技能入口,帮助智能体找到正确的格式化流程,用于修复代码风格违规(缩进、空格、换行等)、一致地应用 .editorconfig 规则、在提交前准备代码(pre-commit hook 格式化)、遵循团队编码规范,以及对特定文件或整个代码库进行格式化。它不用于构建(dotnet-build)、测试(dotnet-test)或代码分析(code-analyze)。
主要能力:按目标分为三类——.NET(C#)代码格式化、使用 Prettier 格式化 JSON/YAML/Markdown/JavaScript/TypeScript,以及依次运行所有格式化器(dotnet + prettier)的全面格式化。输入包括 target(dotnet/prettier/all)、files(特定文件或目录)和 verify(仅检查模式);输出为直接修改后的文件与退出码(0 表示成功,非零表示存在违规)。
使用方式:快速格式化 .NET 可执行 cd ./dotnet 后运行 dotnet format PigeonPea.sln;Prettier 可运行 npx prettier --write "**/*.{json,yml,yaml,md}";全部格式化可运行 ./.agent/skills/code-format/scripts/format-all.sh;仅检查可运行 dotnet format PigeonPea.sln --verify-no-changes;格式化特定文件可用 dotnet format --include ./console-app/Program.cs 或 npx prettier --write ./README.md。
适用场景与集成:可在提交前通过 pre-commit hook 自动格式化,也可在推送代码或创建 PR 前手动执行,或在 CI/CD 中用 --verify-no-changes / --check 模式验证格式。可与 code-analyze(先修风格)和 dotnet-build(构建整洁代码)配合使用。
限制与配置:格式化是非破坏性的,支持 --verify-no-changes 在不改动的情况下检查,并尊重 .editorconfig。相关配置文件包括 .editorconfig、.prettierrc.json、.pre-commit-config.yaml 和 .prettierignore。若格式化失败需查看错误信息;文件未被格式化需检查 .editorconfig 规则、文件扩展名和 ignore 模式;pre-commit hook 失败可先手动运行格式化器;样式冲突时 .editorconfig 优先;性能问题可改为对特定项目或文件格式化。成功时 dotnet format 会显示完成信息或已格式化文件列表,prettier 会显示已格式化文件数或没有输出。