用途:在 .NET 项目中发现包作者随 NuGet 包发布的 agent 技能(skill)文档,挑选与当前任务和代码版本匹配的技能并加载到 agent 上下文中。核心命令是 dnx dotnet-inspect,配合 -S Skills 等选项。
主要能力:对已还原项目,用 project 子命令查询直接依赖暴露的技能数量与清单,支持 --count、--jsonl、--paths、--print、--row、--raw、--frontmatter、--tail、--output、--prefer-rendered-urls 等;未还原的包可用精确坐标(如 package Markout@0.35.2)查询;包 ID 与 Libraries 可用 package query、library query 发现;find 用于搜索 API 类型/成员。清单含解析版本、包内路径、技能名称与描述。
使用方式:依赖变化后先还原或构建(project 只读现有 project.assets.json)。默认流程不改动仓库,agent 可自行完成发现与加载。先在 stdout 查看文档,省略 -o/--output;确认后再写入。持久化属用户显式请求的流程,会改动受版本控制的状态,需合并 PR 才生效;目标仓库决定安装位置,常见根目录有 skills/、.agents/skills/、.github/skills/、.claude/skills/。安装时保留校验后的技能名作为叶子目录,例如 skills/markout-output-formats/SKILL.md,可重定向 stdout 或使用 --output。若技能引用同级脚本或资源,需一并持久化;不要将同一技能复制到多个根目录。
限制与注意:不要用未固定版本的包查询替代仓库实际使用的版本。升级依赖时需重跑清单,比对已安装技能与新包内容,按需增删。dotnet-inspect 会校验已还原项目的技能名称与描述,需受控的内容会显示为 [Text omitted: required containment],被拒绝的技能不应通过清洗或改名恢复。NuGet 依赖只代表来源,不代表其中的 agent 指令安全。私源或凭据场景可加载 dotnet-inspect 的 private-feeds 技能;未发布包可用本地 .nupkg 路径替代。