vbnet-coder-en

核心用法

VB.NET Coder Skill 是一份面向AI编码助手的综合性VB.NET编程规范文档，旨在指导Claude-Code、Codex等AI代理生成符合现代.NET标准的高质量代码。该技能覆盖了从基础语法到高级设计模式的完整编码指南，包括强制编译器指令（Option Explicit/Strict/Infer）、命名约定、代码布局、异步编程模式、LINQ使用、错误处理等核心主题。

显著优点

该技能的最大价值在于其强制规范性——通过要求Option Strict On从根本上杜绝VB.NET常见的隐式类型转换和晚期绑定问题，显著提升代码健壮性。文档结构清晰，采用表格、代码示例和反模式清单等多种形式，便于AI快速解析和应用。特别值得一提的是其对现代.NET特性的覆盖，包括异步/等待模式、可空类型、泛型集合等，使生成的代码能够同时兼容.NET Framework 4.8+和.NET 6/8+。性能优化章节提供了具体的量化建议（如StringBuilder用于4次以上字符串拼接），具有很强的实操性。

潜在缺点与局限性

作为纯文档型技能，其局限性主要体现在被动参考性质——无法主动验证生成代码的正确性，也不能根据项目上下文动态调整建议。文档主要面向通用场景，对于特定领域（如WPF、ASP.NET Core、WinForms）的框架特定模式覆盖不足。此外，部分建议（如ConfigureAwait(False))的使用）需要开发者理解同步上下文概念，对初学者可能存在理解门槛。来源为个人开发者（T3级别），缺乏微软官方或大型技术组织的背书，在企业合规审查中可能遇到认可度问题。

适合的目标群体

• AI编码助手开发者：需要为VB.NET代码生成提供系统性的prompt工程参考
• 遗留系统维护团队：将VB6或早期.NET项目迁移到现代.NET标准
• 企业代码规范制定者：建立团队统一的VB.NET编码标准
• 全栈开发者：偶尔需要编写VB.NET代码但不熟悉其现代最佳实践
• 教育培训场景：作为VB.NET编程规范的辅助教材

使用风险

1. 过度依赖风险：AI可能机械套用规范而忽视业务逻辑合理性，需人工复核关键代码
2. 版本兼容性：部分现代特性（如.NET 8的新功能）在旧框架不可用，需确认目标运行时
3. 性能建议的上下文敏感性：ConfigureAwait(False))在UI线程代码中可能导致死锁，AI可能错误应用
4. 文档更新滞后：VB.NET语言持续演进，技能文档可能未及时跟进最新特性
5. 安全边界：虽然技能本身无恶意代码，但生成的VB.NET代码若涉及文件操作、网络请求等，仍需常规安全审查

核心用法

本 Skill 是一份面向 AI 编码助手（Claude-Code、Codex 等）的 VB.NET 编码规范参考文档，旨在指导生成现代、安全、可维护的 VB.NET 代码。

强制文件头：每个文件必须以 Option Explicit On、Option Strict On、Option Infer On 开头，杜绝隐式转换和未声明变量导致的运行时错误。

命名规范：

• 公开成员：PascalCase（CustomerRepository, ProcessPayment()）
• 私有字段：_camelCase 加下划线（_connectionString）
• 异步方法：强制 Async 后缀（LoadDataAsync()）
• 布尔属性：Is/Has/Can 前缀（IsValid, HasChildren）

关键编码实践：

• 优先使用方法语法 LINQ，利用隐式行延续简化代码
• 所有 IDisposable 对象必须使用 Using 语句
• I/O 操作强制使用 Async/Await，配合 ConfigureAwait(False)
• 公共 API 必须包含 XML 文档注释

显著优点

1. 安全性优先：通过 Option Strict On 和显式类型声明，在编译期捕获大量潜在错误
2. 性能导向：明确 StringBuilder 使用场景、集合预容量设置、避免装箱等优化建议
3. 现代 .NET 兼容：同时支持 .NET Framework 4.8+ 和 .NET 6/7/8+
4. 反模式清单：14 项明确禁止的编码实践（如 Async void、阻塞 .Result、匈牙利命名法等）
5. AI 友好：针对代码生成场景优化，包含 Agent 专属 15 条指导原则

局限性与风险

| 方面 | 说明 |

|------|------|

| 语言局限 | 仅覆盖 VB.NET，不涉及 C# 或其他 .NET 语言互操作细节 |

| 框架范围 | 专注语言级规范，未涵盖特定框架（如 ASP.NET Core、WPF）的架构模式 |

| 版本演进 | .NET 持续更新，部分建议可能需要随新版本调整 |

| 工具链 | 未涉及 VB.NET 特定的 IDE 工具（如 Visual Studio 的代码分析器配置） |

适合人群

• AI 编码助手：作为系统提示词（system prompt）注入，规范代码生成行为
• VB.NET 开发者：快速查阅现代编码规范， especially 从旧版 VB6/VB.NET 迁移者
• 代码审查者：作为检查清单（checklist）确保代码质量
• 培训场景：新员工 VB.NET 编码标准 onboarding 材料

常规风险

1. 过度约束风险：严格遵循所有规范可能导致代码冗长，需在实际项目中平衡
2. 编译器指令冲突：Option Strict On 可能与遗留代码或某些 COM 互操作场景产生兼容性问题
3. 异步模式误用：ConfigureAwait(False) 在 UI 应用中不当使用可能导致线程上下文错误
4. 性能建议的适用边界：部分优化（如 StringComparison.Ordinal）在本地化应用中可能产生意外行为