
关于
使用 Zafiro 工具包进行 Avalonia UI 开发的强制技能、规范和行为规则。
name: avalonia-zafiro-development description: "使用 Zafiro 工具包进行 Avalonia UI 开发的强制技能、约定和行为规则。" risk: safe source: community date_added: "2026-02-27"
Avalonia Zafiro 开发
本技能定义了使用 Avalonia UI 和 Zafiro 工具包开发跨平台应用程序的强制约定和行为规则。这些规则优先考虑可维护性、正确性和函数响应式方法。
核心支柱
- 函数响应式 MVVM:使用 DynamicData 和 ReactiveUI 的纯 MVVM 逻辑。
- 安全性与可预测性:使用
Result类型进行显式错误处理,避免将异常用于流程控制。 - 跨平台卓越性:严格独立于 Avalonia 的 ViewModel 和组合优于继承。
- Zafiro 优先:利用现有的 Zafiro 抽象和辅助工具避免冗余。
指南
- 核心技术技能与架构:基础技能和架构原则。
- 命名与编码标准:命名、字段和错误处理规则。
- Avalonia、Zafiro 与响应式规则:UI、Zafiro 集成和 DynamicData 管道的具体指南。
- Zafiro 快捷方式:常见 Rx/Zafiro 操作的简洁映射。
- 常见模式:高级模式,如
RefreshableCollection和验证。
编写代码前的流程
- 先搜索:在代码库中搜索类似实现或现有的 Zafiro 辅助工具。
- 可复用扩展:如果缺少辅助工具,提议新的可复用扩展方法,而不是内联复杂逻辑。
- 响应式管道:确保在适用时使用 DynamicData 操作符而非普通 Rx。
使用场景
当任务明确匹配概述中描述的工作流或操作时,适用此技能。
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必要的输入、权限、安全边界或成功标准,请停下来要求澄清。
兼容工具
Claude CodeCursor
标签
前端开发