Agent Skills › b-editor/beutl › beutl-format

beutl-format

GitHub

用于对 Beutl 解决方案运行 dotnet format，支持验证或应用代码格式与风格检查。需确认范围和模式，自动匹配 CI 规则，不手动修改样式，格式化后生成变更摘要但不自动提交。

.claude/skills/beutl-format/SKILL.md b-editor/beutl

Trigger Scenarios

用户请求格式化代码检查代码风格修复 lint 错误

Install

npx skills add b-editor/beutl --skill beutl-format -g -y

More Options

Non-standard path

npx skills add https://github.com/b-editor/beutl/tree/main/.claude/skills/beutl-format -g -y

Use without installing

npx skills use b-editor/beutl@beutl-format

指定 Agent (Claude Code)

npx skills add b-editor/beutl --skill beutl-format -a claude-code -g -y

安装 repo 全部 skill

npx skills add b-editor/beutl --all -g -y

预览 repo 内 skill

npx skills add b-editor/beutl --list

SKILL.md

Frontmatter

{
    "name": "beutl-format",
    "description": "Run dotnet format against the Beutl solution. Use when the user asks to format code, check\nstyle, or fix lint errors. Triggers on \"フォーマットして\", \"format\", \"lint\", \"style check\".\nAlways confirm scope and mode (verify vs apply) before running.\n",
    "allowed-tools": "Bash(dotnet format:*) Bash(git diff:*) Bash(git status:*)",
    "argument-hint": "[verify|apply] [path|project]"
}

Format Beutl

Always confirm scope and mode with the user unless they specified them in this turn or $ARGUMENTS is non-empty. Use AskUserQuestion with these defaults:

Mode:
- verify (default, recommended pre-commit) — --verify-no-changes, fails if formatting would change anything. Matches the CI format-check.yml.
- apply — actually rewrites files.
Scope: whole solution (Beutl.slnx) / a single project / specific files (--include "<glob>").

Once scope is decided, run the matching command:

# verify mode (default)
dotnet format Beutl.slnx --verify-no-changes --verbosity diagnostic

# apply mode
dotnet format Beutl.slnx --verbosity diagnostic

# scoped to a single project
dotnet format <path/to/Project.csproj> --verbosity diagnostic

# scoped to specific files
dotnet format Beutl.slnx --include "<glob>" --verbosity diagnostic

If $ARGUMENTS starts with verify or apply, treat the first token as the mode and the rest as scope.

Notes

Style is enforced by .editorconfig and Directory.Build.props — do NOT propose style edits by hand.
.github/workflows/format-check.yml runs dotnet format Beutl.slnx --verify-no-changes; matching it locally avoids round-trips.
XAML formatting is handled separately by xamlstyler.json (run XAML Styler in your editor, or via dotnet tool if installed).