ASP.NET Core 开发指南
帮助构建、审查和升级 ASP.NET Core 应用。
内容强调最小化参考资料加载、内置安全机制、秘密管理、HTTPS、授权边界和避免提交凭据,未见恶意行为、隐蔽外传、破坏性默认操作或超范围权限。因此信任度较高。扣分原因是没有明确的用户确认、回滚流程、依赖安全审查或完整数据流说明;许可证信息在给定材料中仍未知。
工作流、引用路由和 ASP.NET Core 常见架构建议内部基本一致,并包含版本、异常处理、日志和失败配置方面的提示。扣分原因是未提供脚本、测试套件、CI 覆盖、输入校验或可诊断的异常输出,且静态评估不能验证关键路径;按校准不超过 10 分。
目标覆盖 Blazor、Razor Pages、MVC、Minimal APIs、控制器、SignalR、gRPC、安全、测试和升级,场景较明确,也要求先确认框架和应用模型。扣分原因是边界和语义触发条件仍较宽泛,未充分说明不适用场景;代理元数据标注 Windows only,与 ASP.NET Core 的跨平台能力及正文范围存在不一致。未见中文支持或中国大陆网络可达性说明。
目录结构、阅读顺序、参考路由、命名和渐进式加载设计清晰,README 说明了安装方式和仓库已弃用状态。扣分原因是选定技能的许可证、版本策略、变更记录、维护责任和更新路径没有在给定技能材料中完整呈现;文档中也缺少示例、FAQ 和系统化故障排查。
内容直接覆盖 ASP.NET Core 应用选择、管道、数据、安全、实时通信、测试和升级,理论上可完成核心设计与代码指导任务。扣分原因是没有代表性输出、可运行示例或执行证据,且若任务依赖未提供的参考文件,结果可能仍需较多人工核验;静态校准最高只能给 7 分。
各主题引用了 Microsoft Learn、官方文档仓库和 source map,具备一定可追溯性,且版本相关内容要求查证官方文档。扣分原因是给定材料没有提交测试、CI 结果或第三方复核,核心内容主要是作者整理的指导;静态校准上限为 5 分。
- 代理元数据中的“Windows only”可能错误限制实际跨平台适用范围,应在发布前澄清。
- 给定材料未包含选定技能目录中的 LICENSE.txt、测试或 CI 证据,许可证和可复现性不能确认。
- “当前”版本建议依赖外部 Microsoft Learn 查证;静态材料本身不能保证 .NET 10 相关断言持续准确。
它能做什么 & 适用场景
该技能面向 ASP.NET Core Web 应用的构建、审查、重构和架构设计。它覆盖 Blazor、Razor Pages、MVC、Minimal APIs、控制器 Web API、SignalR、gRPC、中间件、依赖注入、安全、测试、性能和部署。工作流要求先确认目标框架、SDK 与应用模型,再按任务加载最小必要参考资料。它适合希望遵循当前 Microsoft 官方指导、同时避免过时框架模式的 .NET 开发者。
它先要求确认目标框架、SDK 和应用模型;为新应用或重大重构选择应用模型;指导组织 Program.cs、依赖注入、配置、中间件、路由、日志和静态资源;根据项目选择 Blazor、Razor Pages、MVC 或 API 参考;按需加入数据、身份安全、实时通信、gRPC、后台任务、测试、性能、运维和升级参考;生成新代码时使用对应的 dotnet new 模板,并在涉及 latest 时要求核验 Microsoft Learn 或 ASP.NET Core 文档仓库。
- 正在创建新 ASP.NET Core 应用、需要在 Blazor、Razor Pages、MVC 或 API 模型之间做选择的 .NET 开发者。
- 维护已有 Web 应用、需要整理 Program.cs、依赖注入、配置、中间件或路由的团队。
- 开发 Minimal API 或控制器 API、需要验证、ProblemDetails、OpenAPI、健康检查或限流指导的工程师。
- 为应用加入认证授权、Identity、CORS、CSRF、HTTPS、SignalR、gRPC 或托管服务的开发者。
- 升级旧版 ASP.NET Core、需要处理目标框架、破坏性变更、过时 API 或迁移问题的团队。
优缺点一览
- 覆盖多种 ASP.NET Core 应用模型和常见横切关注点。
- 强调先确认目标框架和应用模型,并按任务加载最小参考集。
- 优先采用 WebApplicationBuilder、内置 DI、配置、日志、ProblemDetails、OpenAPI、健康检查和 Identity 等框架能力。
- 包含版本升级与官方文档映射参考,便于处理新旧 API。
- 依赖仓库中未提供的 references 文件内容;当前提示只展示了 SKILL.md。
- 没有展示测试套件、脚本、资产或实际示例项目,因此无法据此确认具体平台上的验证覆盖。
- “最新”功能需要额外核验 Microsoft Learn 或 ASP.NET Core 文档仓库。
- README 声明整个仓库已弃用,当前 Codex 技能和插件示例应参考 OpenAI Plugins repository。
如何安装
在 Codex 中运行:$skill-installer aspnet-core。该仓库 README 说明,curated 技能可按名称安装;安装后重启 Codex。README 未提供该单个技能的独立许可证内容。
如何使用
在已安装技能的 Codex 会话中,直接提出具体 ASP.NET Core 任务,例如:“审查这个 ASP.NET Core Web API 的中间件、依赖注入和认证配置,并按当前官方指导提出修改建议。”新应用或重大重构时,技能会先读取 stack-selection.md 和 program-and-pipeline.md,再选择一个主要应用模型参考。