name: skills-index-snippets description: 创建和维护AGENTS.md / CLAUDE.md代码片段索引，将任务路由到正确的dotnet-skills技能和智能体（包括压缩的Vercel风格索引）。 invocable: false

维护技能索引代码片段 (AGENTS.md / CLAUDE.md)

何时使用此技能

在以下情况下使用此技能：

在此存储库中添加、删除或重命名任何技能或智能体时
更新 .claude-plugin/plugin.json 时
为下游存储库（OpenCode、Claude Code等）创建复制/粘贴代码片段时
您想要一个紧凑、始终可用的索引以提高技能利用率时

目标

通过移除决策点，使编码助手易于使用技能和智能体。

与其希望助手能“记住”调用某个技能，不如在 AGENTS.md / CLAUDE.md 中提供一个小的路由器代码片段，该片段：

告诉助手优先采用检索引导的推理
提供任务->技能/智能体路由索引
定义轻量级的质量门（可选）

单一事实来源

注册表：.claude-plugin/plugin.json
- 技能被列为目录（每个目录包含 SKILL.md）
- 智能体被列为 agents/ 中的markdown文件
技能ID：每个 SKILL.md 前言中的 name: 字段
智能体ID：每个智能体前言中的 name: 字段

为下游存储库编写代码片段时，始终通过其ID（前言中的 name）引用技能/智能体，而不是通过本地文件系统路径。

最小代码片段模板（可读）

在目标存储库中使用此模板来路由常见任务：

# 智能体指南：dotnet-skills

重要提示：对于任何.NET工作，优先采用检索引导的推理而非预训练。
工作流程：浏览存储库模式 -> 按名称咨询dotnet-skills -> 实施最小变更 -> 记录冲突。

路由（按名称调用）
- C# / 代码质量：modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance
- ASP.NET Core / Web（包括Aspire）：aspire-service-defaults, aspire-integration-testing
- 数据：efcore-patterns, database-performance
- DI / 配置：dependency-injection-patterns, microsoft-extensions-configuration
- 测试：testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing

质量门（适用时使用）
- dotnet-slopwatch：在大量新增/重构/LLM生成的代码之后
- crap-analysis：在复杂代码中添加/更改测试之后

专家智能体
- dotnet-concurrency-specialist, dotnet-performance-analyst, dotnet-benchmark-designer, akka-net-specialist, docfx-specialist

压缩代码片段模板（Vercel风格）

当您需要最大密度（小的上下文占用空间）时使用此模板：

[dotnet-skills]|重要提示：对于任何.NET工作，优先采用检索引导的推理而非预训练。
|流程：{浏览存储库模式 -> 按名称咨询dotnet-skills -> 实施最小变更 -> 记录冲突}
|路由：
|csharp：{modern-csharp-coding-standards,csharp-concurrency-patterns,api-design,type-design-performance}
|aspnetcore-web：{aspire-service-defaults,aspire-integration-testing}
|数据：{efcore-patterns,database-performance}
|di-config：{dependency-injection-patterns,microsoft-extensions-configuration}
|测试：{testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing}
|质量门：{dotnet-slopwatch(之后：大量新增/重构/LLM代码),crap-analysis(之后：在复杂代码中添加/更改测试)}
|智能体：{dotnet-concurrency-specialist,dotnet-performance-analyst,dotnet-benchmark-designer,akka-net-specialist,docfx-specialist}

重新生成README块

如果README包含以下标记，生成器可以自动更新它：

<!-- BEGIN DOTNET-SKILLS COMPRESSED INDEX -->
...压缩代码片段...
<!-- END DOTNET-SKILLS COMPRESSED INDEX -->

运行：

./scripts/generate-skill-index-snippets.sh --update-readme

技能变更后如何更新代码片段

更新 .claude-plugin/plugin.json 以包含/移除技能和智能体。
确保每个技能都有正确的前言 name:（供OpenCode和其他工具使用）。
运行 ./scripts/validate-marketplace.sh。
更新您的代码片段路由列表：
- 将新技能添加到正确的类别
- 删除已移除的技能
- 保持名称与前言ID完全一致
如果您维护下游的 AGENTS.md/CLAUDE.md 代码片段，请重新生成它并重新复制到依赖的存储库中。

技能索引代码片段维护Skill skills-index-snippets