WPF 标准开发指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f5ec5127/wpf-standard-development。
技能介绍
要解决的具体问题
WPF 项目里让模型接手代码,最常见的失败不是它不会写 XAML,而是它把一套自己喜欢的架构强加给现有代码库:为了页面间复用顺手搬来 CommunityToolkit.Mvvm,给只跑了 .NET Framework 4.8 的解决方案加上 TargetFramework=net8.0,把 UI 状态塞进 Code-behind,或者在 async void 里裸调 .Wait()。这些改动常常能编译通过,却污染了 diff、打破了既有的主题与资源字典体系,让后续回归变得困难。
这个技能的做法是把约束写死在流程前段,而不是等交付前再检查一遍。
核心能力
先读后写。 动手之前必须先读完最近的 AGENTS.md、解决方案、项目文件、应用入口、目标窗口以及一两个相似实现,从中提取当前在用的 .NET 版本、WPF 风格、MVVM 框架、DI 容器、导航方案、主题与目录结构,并原样沿用。禁止为了统一个人偏好而做架构迁移,也不得擅自升级 .NET、SDK、NuGet 包或项目格式。
最小闭环。 交付物是用户要求的最小桌面端闭环:界面、状态、命令、业务服务和必要的持久化。需求之外的功能一律不加,包括演示窗口、示例数据、README 和各种「为未来预留」的抽象层。
低风险细节按约定补全。 只有在业务口径、数据覆盖、系统权限、外部发送、发布签名或安装策略不明确且会实质改变结果时才提问,否则直接按现有代码和常见约定推进,采用保留用户已有改动的最小差异修改。
关键步骤
- 确认目标项目类型、目标框架、启动方式、现有 UI 架构与受影响的数据流
- 圈定必须修改的
View/ViewModel/Model/Service/ 资源 / 配置,排除未要求的扩展 - 按现有模式实现界面与交互,复用
ResourceDictionary、样式、转换器、命令、对话框和公共服务 - 检查绑定路径、通知更新、命令状态、异步异常、窗口生命周期与持久化读写是否闭环
- 只对受影响的解决方案或项目跑一次合适的轻量构建或静态检查,然后简洁交付
界面层优先使用绑定、样式和模板,不把业务逻辑堆进 Code-behind;沿用现有布局体系,同时支持窗口缩放、DPI、长文本与基础键盘操作,避免只依赖固定像素定位。MVVM 层沿用项目已有的 INotifyPropertyChanged、命令、消息总线和 MVVM Toolkit,现有项目没上框架就不该为简单功能新增框架。ViewModel 不查找视觉树、不持有无必要的 Window 引用、不依赖具体控件。异步与生命周期坚持耗时 I/O 异步执行,Dispatcher 只在绑定对象确需更新 UI 时使用,不用它掩盖线程设计缺陷;窗口关闭时解除长期事件订阅,释放流、计时器、托盘图标等资源,避免 ViewModel 泄漏。
适用边界
明确排除:不新增或修改单元测试、UI 自动化测试、Mock、快照和覆盖率配置,除非用户明确要求;不主动运行完整测试套件。不创建演示窗口、示例数据、设计文档或占位项。不为简单功能新增无需求的抽象层、框架、事件总线、缓存、埋点或插件系统。不用硬编码路径、吞异常、跨线程强行更新控件或绕过权限来换取表面完成。
不做分发:不擅自提交、推送、发布、打包、签名、安装或修改用户真实数据,也不改发布配置、安装程序、证书、自动更新和生产分发渠道。
失败如实报告:无法构建时说明缺失的 SDK、工作负载、私有依赖或环境条件,不用额外脚手架掩盖;只修复本次修改引入的问题,发现无关的既有构建问题时停止扩大修改,并在交付中注明。
使用场景
- 接手一个停滞的老 WPF 项目,需要在沿用现有 MVVM 框架和主题的前提下补完一个业务功能
- 现有 WPF 应用的窗口要增加一批可缩放、支持 DPI 的界面,且必须复用现有 ResourceDictionary
- 维护使用了 .NET Framework 4.8 的 WPF 程序,任务涉及异步读写本地数据库并处理取消逻辑
- 修改现有 ViewModel 的状态通知与命令可执行逻辑,修复跨线程直接更新控件的问题
适合人员
- 维护遗留 WPF 桌面程序的开发工程师,诉求是在不改变现有架构下安全交付需求
- 负责 Windows 客户端 UI 重构的前端工程师,诉求是让新页面沿用既有样式、模板和主题体系
- 管理 WPF 项目技术债的技术负责人,诉求是避免 AI 助手引入无关重构、升级或格式化改动
- 为团队搭建 Agent 技能平台的研发工程师,诉求是让模型遵守团队已有的框架与代码规范