.NET Skills 评测 用两个构建流程验证技能是否可复现

按固定版本的 MSBuild 技能说明,复现共享输出路径、修正后离线编译、四份独立日志和文本回放,说明宿主激活与诊断证据的区别。

AgentIndex · 发布于 2026-11-04 · 更新于 2026-11-04

.NET Agent Skills 的价值在于把常见开发任务整理成可执行的调查步骤。对于智能体而言,知道应该先收集什么证据、哪些情况不适用,往往比再增加一段通用编码建议更有帮助。它提供的是技能和部分宿主专用组件,实际工具链仍由开发环境提供。

我们选了两个能独立检查的 MSBuild 流程:记录二进制日志,以及诊断多个项目的输出目录冲突。结论是,这两份说明可以在本次环境中手工复现,并得到可核对的构建证据;此次没有测试智能体是否自动激活技能,也没有测量模型修复率或 token 节省。

本次怎样验证

2026-11-04,我们固定仓库提交 9837da685079d576feb27f9dd4f87631d3d94107,使用 macOS arm64 和 .NET SDK 10.0.102。样本是自己编写的两个最小 C# 类库,目标框架为 net10.0,没有额外 NuGet 包。固定版本 MSBuild 技能

先用公共构建属性让两个项目指向相同目录,读取 MSBuild 的实际求值结果;再移除这些公共覆盖,恢复 SDK 默认路径,分别还原和编译两个项目。日志采用说明中的自动命名方式,并使用文档的文本回放后备路径检查。本站可复现样本

检查实际结果
固定技能文件指纹符合记录的 SHA-256
人工设置公共输出和中间目录两个项目求值后的路径相同
恢复 SDK 默认目录两个项目的绝对输出与中间路径分开
修正后的两个项目均可使用本地空包源还原并生成 DLL
两次还原与两次构建生成四份不同名称的非空 binlog
选择构建日志做文本回放能查到项目及 OutputPath 证据

我们没有强制触发并发文件损坏,也没有把“路径相同”说成已复现所有偶发构建故障。测试回答的是更具体的问题:这组配置是否会让两个项目写到相同位置,修正后是否仍然可编译,以及证据能否留存和读取。

为什么先查求值结果

项目文件里看到的字符串,不一定就是最终路径。公共 props、配置、目标框架和全局属性都可能参与求值。技能先要求比较实际输出与中间路径,再结合项目实例判断冲突,这比只搜索某个 XML 字段更接近问题本身。目录冲突说明

我们的样本还说明,只在目录末尾增加目标框架名,不能区分目标框架相同的两个不同项目。需要看完整路径是否包含项目边界。中间目录同样重要,因为还原产物也会写到那里;不能只给最终 DLL 分目录,而让中间文件继续共享位置。

实际调查时,应记录项目身份、配置和参与求值的全局属性,统一路径分隔符并转换成绝对路径,再比较写入目标。一次求值也不总等于一次真实写入,技能对只查询项目引用元数据的实例给出了排除条件;本次没有另外构造这些高级实例。

日志命名也是工作流的一部分

二进制日志技能建议每次 MSBuild 调用单独使用 /bl:{},由受支持的版本自动生成名称。本次两次还原和两次构建得到四个独立文件,没有覆盖前一次的记录。该占位符要求 .NET 8 SDK 或对应的较新 MSBuild,本次使用的是 .NET 10。日志生成说明

日志留存对智能体尤其有用。修正配置后,可以回到原始失败或原始求值证据,而不是只凭最后一次成功输出解释原因。但日志存在不等于已经完成诊断:还需确认它来自哪一次命令、哪个配置,以及是否包含要分析的项目。

我们的样本先确认文件存在且非空,再执行 MSBuild 的日志回放,输出可搜索的诊断文本。没有把二进制文件直接当普通文本解析。这个后备流程在本次 SDK 中有效,没有测试所有历史 SDK 或操作系统。

技能、宿主和工具应分别验收

仓库 README 明确区分可移植技能和宿主专用组件。插件中声明的 agent、语言服务和 MCP 服务,需要宿主分别支持,不能因为其中一项可用,就假定整套组件都已接入。仓库组件说明

例如该快照的 MSBuild 插件声明了 binlog MCP,并通过 dotnet dnx 启动带预发行选项的包。我们没有安装或调用这个 MCP,而是验证技能写明的文本回放后备路径。采用者若需要 MCP 路径,应另行核对实际包版本、宿主连接和可用工具。插件声明

建议先挑一个团队经常遇到的任务,确认对应 SDK 和工作负载,再在测试项目里执行技能步骤。之后才检查宿主能否正确发现、激活并完整执行这个流程。这样可以区分环境缺失、技能未触发和诊断结论错误,减少把所有问题都归为模型能力不足。

采用结论

对已经维护 .NET 项目、希望把调查步骤变成团队惯例的开发者,这个仓库值得从单个插件开始试用。它不能替代 SDK、平台工作负载或具体业务测试。本次也没有评估 MAUI、Windows 界面、框架升级或整个技能集合的质量。

固定版本的仓库采用 MIT 许可。合理的验收产物是一个可重跑的小样本、对应日志和依据清楚的结论,而不是“安装了很多技能”这一数量指标。许可文件

业务系统的项目准备可结合 NocoBase 3 评测;处理外部运营数据时,可看 Claude Ads 如何保留证据与未知项。