以下为本文档的中文说明
Avalonia Zafiro 开发技能是一个为使用 Avalonia UI 框架和 Zafiro 工具包进行跨平台应用开发而定义的强制性规范和开发指南。它的核心支柱包括四个层面:函数响应式 MVVM,使用 DynamicData 和 ReactiveUI 实现纯粹的 MVVM 逻辑;安全性与可预测性,使用 Result 类型进行显式错误处理,避免使用异常进行流程控制;跨平台卓越性,严格保持 ViewModel 与 Avalonia 框架的解耦,采用组合优于继承的设计原则;Zafiro 优先,充分利用现有的 Zafiro 抽象和辅助工具,避免重复造轮子。使用场景面向使用 Avalonia UI 和 Zafiro 工具包进行跨平台桌面应用开发的 .NET 开发团队。核心特点在于强制性的开发规范和统一的架构风格。它不仅仅是一套建议,而是必须遵守的规则,旨在确保代码库的可维护性和一致性。设计原则强调可维护性、正确性和函数响应式方法,通过强制的架构约束消除常见的开发陷阱,确保团队协作效率。从技术实现角度来看,该技能采用了业界成熟的最佳实践和设计模式,确保了代码质量和系统稳定性。通过持续的功能迭代和社区反馈收集,它不断优化和完善自身的功能集与用户体验。对
Avalonia Zafiro Development
This skill defines the mandatory conventions and behavioral rules for developing cross-platform applications with Avalonia UI and the Zafiro toolkit. These rules prioritize maintainability, correctness, and a functional-reactive approach.
Core Pillars
Guides
- Core Technical Skills & Architecture: Fundamental skills and architectural principles.
- Naming & Coding Standards: Rules for naming, fields, and error handling.
- Avalonia, Zafiro & Reactive Rules: Specific guidelines for UI, Zafiro integration, and DynamicData pipelines.
- Zafiro Shortcuts: Concise mappings for common Rx/Zafiro operations.
- Common Patterns: Advanced patterns like RefreshableCollection and Validation.
Procedure Before Writing Code
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.



