ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

ASP.NET Core Skill 参考路由指南:用 _sections.md 快速定位官方技术参考的正确打开方式

ASP.NET Core Skill 参考路由指南:用 _sections.md 快速定位官方技术参考的正确打开方式 ASP.NET Core Skill 参考路由指南用 _sections.md 快速定位官方技术参考的正确打开方式【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills导读skills/.curated/aspnet-core是 Skills Catalog for Codex 仓库中面向 ASP.NET Core 开发的技能包而其中的 references/_sections.md 是整个技能包的路由表它不直接讲解某个框架特性而是回答当前任务应该打开哪一份参考文档、按什么顺序读这一关键问题。读完本文你将掌握该路由表 6 条场景化阅读路径、主参考与横切参考两组文件映射表的完整内容以及如何将其与 SKILL.md 定义的工作流联动在真实开发任务中做到只加载任务所需的最小参考集。一、路由表的定位给 Agent 的一张导航图_sections.md在文件开头就表明自身角色Use this file as the routing table for the rest of the skill将本文件作为技能其余部分的路由表。它面向的核心矛盾是ASP.NET Core 技能包共包含 12 份参考文档含本路由表在内若 Agent 在每次任务中都全量加载既浪费上下文也容易让知识互相干扰。SKILL.md 中的 Overview 明确给出了约束Load the smallest set of references that fits the task. Do not load every reference by default.加载与任务匹配的最小参考集默认不要全量加载。_sections.md正是实现这一约束的机制——它把任务类型 → 参考文档 → 阅读顺序的映射关系预先固化下来Agent 只需对照路由表即可做出正确选择。从文件组织看references/目录下的参考文档分为三类角色路由表_sections.md本文的主角主参考Primary References与应用模型app model直接相关的 6 份文档横切参考Cross-Cutting References跨应用模型通用的 6 份文档。二、Start Here六类任务的标准化阅读路径_sections.md的 Start Here 部分给出了按任务类型划分的阅读路径。这些路径不是随意排列的而是遵循先定技术栈 → 再搭宿主与管道 → 然后选一个主应用模型 → 最后补齐安全与运维的依赖顺序。路径 1新应用或重大重构stack-selection.md - program-and-pipeline.md - 一个主应用模型参考 - security-and-identity.md - testing-performance-and-operations.md这条路径先通过 stack-selection.md 在 Blazor、Razor Pages、MVC、Minimal APIs、控制器、SignalR、gRPC 之间做出选择随后用 program-and-pipeline.md 搭建Program.cs、服务注册、配置、中间件管道等宿主骨架再打开且只打开一个主应用模型参考Blazor / Razor Pages / MVC / API 四选一之后按默认顺序接入安全security-and-identity.md与测试运维testing-performance-and-operations.md。路径 2已有应用的功能开发主应用模型参考 - program-and-pipeline.md - 按需的横切参考已有代码库不重新选型因此第一步直接打开与现有应用模型对应的那份主参考保持与代码库一致的模型再回到 program-and-pipeline.md 核对宿主与管道层面的正确做法最后按需only as needed补充横切参考避免无谓加载。路径 3API-first 工作apis-minimal-and-controllers.md - security-and-identity.md - contenteditable="false">【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进