AgentSkillsCN

dotnet-format-analyzers

定义规范的.NET格式与分析器验证命令,并提供生成格式/分析器报告的脚本。在无需重新格式化所有内容的情况下,检查代码格式或Roslyn分析器时使用。

SKILL.md
--- frontmatter
name: dotnet-format-analyzers
description: Define canonical dotnet format and analyzer verification commands, and provide scripts that generate a format/analyzer report. Use when checking formatting or Roslyn analyzers without reformatting everything.

dotnet-format-analyzers

Provide canonical format/analyzer commands and a report-generating script that stays in verify mode.

Canonical commands

Format verification:

bash
dotnet format Workbench.slnx --verify-no-changes

Analyzer verification:

bash
dotnet format analyzers Workbench.slnx --verify-no-changes

Report script

Bash:

bash
bash .codex/skills/dotnet-format-analyzers/scripts/run-format-analyzers.sh

PowerShell:

powershell
pwsh -File .codex/skills/dotnet-format-analyzers/scripts/run-format-analyzers.ps1

Outputs:

  • artifacts/codex/format-report.txt

Targeted usage (preferred)

Never reformat the world unless explicitly asked. Prefer targeted scopes:

  • Solution or project: pass a specific .slnx or .csproj path
  • Files: pass one or more --include paths

Examples:

bash
bash .codex/skills/dotnet-format-analyzers/scripts/run-format-analyzers.sh src/app/Incursa.Web/Incursa.Web.csproj
bash .codex/skills/dotnet-format-analyzers/scripts/run-format-analyzers.sh Workbench.slnx --include src/app/Incursa.Web/Pages/Error.cshtml.cs

Notes

  • Scripts run in verify mode only.
  • The report captures both formatter and analyzer output for CI uploads or local triage.