name: vs-build description: 使用项目级 skill 内置的本地 Python 构建脚本执行编译、构建、重建与发布前构建验证。用户提到编译、构建、build、rebuild、重新编译、解决方案、项目、sln、csproj、发布前验证时使用。禁止切换到 dotnet、msbuild、powershell 或其他直接编译命令。
VS Build
目的
把编译请求统一收敛到 skill 内置脚本 .cursor/skills/vs-build/scripts/build.py，避免误用 dotnet build、msbuild、powershell 等直接编译命令。
适用场景
当用户提出以下任一诉求时应用本 skill：
- 编译、构建、重建、重新编译
- 发布前构建验证
- 构建某个解决方案或某个 C# 项目
- 提到
.sln、.csproj、解决方案、项目路径
不适用于运行程序、执行测试、查看日志、安装依赖。
固定规则
- 编译前先读取
开发文档.md。 - 构建只能通过
.cursor/skills/vs-build/scripts/build.py执行。 - 默认构建参数使用：
configuration=Debugplatform=x64target=Buildverbosity=minimal
- 用户明确要求
Release、Rebuild、Clean、diagnostic等时，才覆盖默认值。 - 脚本报错、MSBuild 不存在、目标路径无效或参数不明确时，立即停止并向用户报告。
- 绝不回退到
dotnet、msbuild、devenv、powershell或其他直接编译命令。
目标判定
按下面顺序确定构建目标：
- 用户明确给出
.sln路径：构建该解决方案。 - 用户明确给出
.csproj路径：构建该项目。 - 用户只说“编译这个项目”，但上下文已明确某个 C# 项目：解析到对应
.csproj后构建该项目。 - 用户只说“编译一下”“帮我构建”而未限定范围：优先使用仓库默认解决方案。
- 若请求针对的不是
.csproj，不要猜测其他编译命令；优先转为包含它的解决方案构建，或先向用户确认范围。
执行流程
1. 识别范围
- 先判断是“整个解决方案”还是“单个 C# 项目”。
- 范围不清楚时，优先使用仓库默认解决方案，除非上下文已经清楚指向某个项目。
2. 调用脚本
统一执行：
python ".cursor/skills/vs-build/scripts/build.py" "<target-path>" --configuration Debug --platform x64 --target Build --verbosity minimal
按用户要求覆盖参数：
- 整体编译：
<target-path>使用.sln - 单个 C# 项目编译：
<target-path>使用.csproj - 重建：
--target Rebuild - 清理：
--target Clean - 发布前验证：按用户要求切换到对应目标或配置
3. 返回结果
- 成功时默认只说明：构建目标、配置、平台、是否成功，以及必要的构建摘要
- 失败时优先返回脚本错误或构建输出摘要
- 不补充任何“也可以试试 dotnet/msbuild”的替代建议
- 除非用户明确要求列出下一步可选操作，否则不要主动追加“如果你要，我可以继续帮你”之类的后续建议
- 不要在成功后自动罗列“运行程序”“改成 Release 再编译”“执行 Rebuild”这类额外动作
成功回复应偏简洁，优先类似：
已完成编译，DlcvDemo 构建成功，参数是 Debug、x64、Build、minimal。构建过程中同时生成了依赖项目 DlcvCsharpApi、ImageViewer、PressureTestRunner，最终状态是 status: success、exit_code: 0。
示例
示例 1
用户说：编译一下
处理方式：
- 读取
开发文档.md - 运行
python ".cursor/skills/vs-build/scripts/build.py" - 参数默认使用
Debug + x64 + Build + minimal
示例 2
用户说：帮我编译某个 csproj
处理方式：
- 将目标解析为对应
.csproj - 运行
python ".cursor/skills/vs-build/scripts/build.py" "<project-path>" - 参数默认使用
Debug + x64 + Build + minimal
示例 3
用户说：重建某个 sln，用 Release
处理方式：
- 运行：
python ".cursor/skills/vs-build/scripts/build.py" "<solution-path>" --configuration Release --platform x64 --target Rebuild
禁止事项
- 不先试
dotnet build - 不先试
msbuild - 不用
powershell包一层再编译 - 不调用外部
C:/mcp-build-server.py - 不因为脚本失败就自动改走其他编译命令
- 不把读取项目文件、解决方案文件、目录结构这类动作解释成“可以绕过 skill 脚本”
- 不在构建成功后主动追加与当前请求无关的下一步建议列表