| description | 递归检查并同步所有 Kurisu.* 相关依赖包的版本，确保基础包升级后所有直接或间接引用的项目都同步升级 PackageReference，避免类型不兼容。适用于 Abstractions/Extensions/Aspect.Abstractions 升级场景。 |
| name | Kurisu 依赖升级同步检查 |
Kurisu 依赖升级同步 Skill
适用场景
项目依赖关系（完整列表）
升级任意包时，必须同步升级以下被直接影响的项目：
| 包名 | 直接依赖方（需同步升级的项目） |
|---|
Kurisu.Aspect.Abstractions | Kurisu.Aspect、Kurisu.AspNetCore.Abstractions |
Kurisu.AspNetCore.Abstractions | Kurisu.Extensions.Cache、Kurisu.Extensions.ContextAccessor、Kurisu.Extensions.SqlSugar、Kurisu.AspNetCore |
Kurisu.Extensions.ContextAccessor | Kurisu.Extensions.SqlSugar |
Kurisu.Extensions.Cache | Kurisu.AspNetCore |
Kurisu.Extensions.SqlSugar | Kurisu.Extensions.EventBus |
Kurisu.Aspect | Kurisu.AspNetCore |
间接依赖：如 Kurisu.Aspect.Abstractions 升级，除了直接影响 Kurisu.Aspect 和 Kurisu.AspNetCore.Abstractions，还需递归检查 Kurisu.AspNetCore.Abstractions 的所有依赖方（Kurisu.Extensions.Cache、Kurisu.Extensions.ContextAccessor、Kurisu.Extensions.SqlSugar、Kurisu.AspNetCore），以及这些依赖方各自的依赖方。即全链路递归同步。
流程
0. 环境变量检查（第一步，必须）
触发 skill 后首先检查以下环境变量是否存在，任一缺失则终止并报告：
| 变量名 | 用途 | 检查方式 |
|---|
NUGET_SERVER_URL | 私有 NuGet 源地址 | 检查是否已设置 |
NUGET_API_KEY | 私有 NuGet 源 API 密钥 | 检查是否已设置 |
敏感信息保护：检查时只报告「已设置」或「未设置」，绝不输出环境变量的实际值。
检查示例：
[ -n "$NUGET_SERVER_URL" ] && echo "NUGET_SERVER_URL: 已设置" || echo "NUGET_SERVER_URL: 未设置"
[ -n "$NUGET_API_KEY" ] && echo "NUGET_API_KEY: 已设置" || echo "NUGET_API_KEY: 未设置"
环境变量导出模板（由开发者在本地 shell 配置中填写）：
export NUGET_SERVER_URL="https://your-nuget-server/v3/index.json"
export NUGET_API_KEY="your-nuget-api-key"
1. 确定升级包与版本类型
- 明确本次升级的基础包（如
Kurisu.AspNetCore.Abstractions、Kurisu.Extensions.ContextAccessor 等）。
- 指定升级类型：
patch / minor / major（语义化版本）。
2. 检查 build 配置
- 确认目标项目的
.csproj 已配置 <GeneratePackageOnBuild>true</GeneratePackageOnBuild>，确保 Release build 后自动生成 .nupkg 文件于相对路径 bin/Release/。
3. 升级变更包自身版本
- 修改目标项目的
<Version> 字段（如 0.1.5 → 0.1.6），保存。
4. 构建变更包
- 执行
dotnet build -c Release，生成 .nupkg。
5. 推送变更包到私有 NuGet
cd src/Kurisu.Extensions.ContextAccessor/bin/Release
dotnet nuget push Kurisu.Extensions.ContextAccessor.0.1.6.nupkg \
--source "$NUGET_SERVER_URL" \
--api-key "$NUGET_API_KEY" \
--skip-duplicate
6. 递归升级依赖链
- 遍历所有
.csproj 文件，查找直接或间接引用该包的项目。
- 按从底向上顺序处理依赖链。每处理一个项目，需同时完成两项升级：
a. 升级引用的包版本：将项目中指向已升级包的
<PackageReference> 版本号更新为最新
b. 升级自身 Version：提升本项目 <Version> 字段（如 0.2.5 → 0.2.6）
- 两项升级完成后：
c.
dotnet build -c Release 生成 .nupkg
d. 推送到私有 NuGet（同步骤 5）
e. dotnet test 验证
7. 最终验证
- 全部升级完成后，执行
dotnet build -c Release 和 dotnet test，确保类型兼容且功能无回归。
完成标准
- 变更包及所有直接/间接引用其的依赖项目，PackageReference 版本一致且为最新。
- 所有包均已推送到私有 NuGet 源。
- 构建、测试全部通过。
示例 prompt
- "Kurisu.AspNetCore.Abstractions 发布新版本，patch 升级并递归同步所有依赖链"
- "Kurisu.Extensions.ContextAccessor minor 升级后，帮我同步所有相关项目的依赖版本并推送"
