---

name: avalonia-zafiro-development description: "使用 Zafiro 工具包进行 Avalonia UI 开发的强制技能、约定和行为规则。" risk: safe source: community date_added: "2026-02-27"

Avalonia Zafiro 开发

本技能定义了使用 Avalonia UI 和 Zafiro 工具包开发跨平台应用程序的强制约定和行为规则。这些规则优先考虑可维护性、正确性和函数响应式方法。

核心支柱

1. 函数响应式 MVVM：使用 DynamicData 和 ReactiveUI 的纯 MVVM 逻辑。
2. 安全性与可预测性：使用 Result 类型进行显式错误处理，避免将异常用于流程控制。
3. 跨平台卓越性：严格独立于 Avalonia 的 ViewModel 和组合优于继承。
4. Zafiro 优先：利用现有的 Zafiro 抽象和辅助工具避免冗余。

指南

• 核心技术技能与架构：基础技能和架构原则。
• 命名与编码标准：命名、字段和错误处理规则。
• Avalonia、Zafiro 与响应式规则：UI、Zafiro 集成和 DynamicData 管道的具体指南。
• Zafiro 快捷方式：常见 Rx/Zafiro 操作的简洁映射。
• 常见模式：高级模式，如 RefreshableCollection 和验证。

编写代码前的流程

1. 先搜索：在代码库中搜索类似实现或现有的 Zafiro 辅助工具。
2. 可复用扩展：如果缺少辅助工具，提议新的可复用扩展方法，而不是内联复杂逻辑。
3. 响应式管道：确保在适用时使用 DynamicData 操作符而非普通 Rx。

使用场景

当任务明确匹配概述中描述的工作流或操作时，适用此技能。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停下来要求澄清。