当 C#/.NET 代码需要定位难以测试的静态/隐藏依赖时…

在请求或目标明确涉及 C#、.NET、.cs 或 .csproj 时，扫描代码中的静态/隐藏依赖，输出分类计数、文件位置和推荐抽象以指导可测试性改造。

适用场景

解决思路

1. 解析目标路径为一批 `.cs` 文件：若 prompt 给出工作区相对路径，直接定位；若未给出，扫描当前工作区下所有符合条件的 `.cs`，不要只选一个项目而静默漏掉同级项目。
2. 目标是 `.cs` 文件时只扫描该文件；目标是目录时递归扫描其中所有 `.cs` 文件；目标是 `.csproj` 时找到其目录并扫描目录内 `.cs`；目标是 `.sln` 时解析解决方案，找到所有项目目录，扫描所有项目中的 `.cs`。
3. 始终排除 `obj/`、`bin/` 和用户指定的排除 Glob；另排除生成文件与 `*.Designer.cs`，并只扫描生产代码，排除 `*.Tests.csproj` 项目。
4. 支持可选输入 category filter，只限制到 `time`、`filesystem`、`environment`、`network`、`console`、`process` 等指定类别。
5. 用文件列表工具发现路径后立即扫描；在文件发现和内容搜索都失败之前，不要要求用户提供或重新上传文件。
6. 从递归、带行号的内容搜索开始，只搜符合条件的 `.cs` 文件；不要只搜 `static` 关键字，因为 LINQ 表达式、lambda、回调、插值字符串中的环境调用通常没有 `static` 修饰符。
7. 若文件读取工具在列表/搜索已证明存在的路径上失败，先分类失败；仅对已确认的工具可用性、传输、路径规范化失败，在验证规范路径仍位于工作区内后，回退到 `rg -n`、grep 或 shell 文件读取器；遇到内容排除、权限/策略、工作区边界或未知失败时停止。
8. 搜索输出可用于填充 occurrence ledger；只打开验证 receiver 来源所需的周围代码。
9. 搜索模式匹配只作为候选而非最终发现；统计实例调用前，追踪 receiver 来源：通过构造函数、参数、属性或依赖注入（DI）提供的协作者已经是测试缝，不计入“需要包装”总数。
10. 特别地，注入的 `HttpClient` 可用受控 `HttpMessageHandler` 测试；不要仅因注入类型是具体类就统计其调用或建议替换。
11. 按时间类别搜索并记录推荐替换：`DateTime.Now`、`DateTime.UtcNow`、`DateTime.Today`、`DateTimeOffset.Now`、`DateTimeOffset.UtcNow`、`Task.Delay(`、`new CancellationTokenSource(TimeSpan` -> `TimeProvider` (.NET 8+)。
12. 按文件系统类别搜索并记录推荐替换：`File.ReadAllText(`、`File.WriteAllText(`、`File.Exists(`、`File.Delete(`、`File.Copy(`、`File.Move(`、`Directory.Exists(`、`Directory.CreateDirectory(`、`Directory.GetFiles(`、`Directory.Delete(`、`Path.GetTempPath(`，以及访问磁盘的实例成员（`new FileInfo(...)`、`new DirectoryInfo(...)`、`.LastWriteTimeUtc`、`new StreamReader(path)`）-> `IFileSystem` (System.IO.Abstractions NuGet)。
13. 按随机性/身份类别搜索并记录推荐替换：`new Random(`、`Random.Shared`、`Guid.NewGuid(` -> `TimeProvider` 风格缝：注入 `Random` / `IGuidProvider`。
14. 按文化/序列化类别搜索并记录推荐替换：`CultureInfo.CurrentCulture`、`CultureInfo.CurrentUICulture`、`JsonSerializer.Serialize(`、`JsonSerializer.Deserialize(` -> 显式传入 culture/options，或注入 serializer 抽象。
15. 按环境类别搜索并记录推荐替换：`Environment.GetEnvironmentVariable(`、`Environment.SetEnvironmentVariable(`、`Environment.MachineName`、`Environment.UserName`、`Environment.CurrentDirectory`、`Environment.Exit(` -> 自定义 `IEnvironmentProvider`。
16. 按网络类别搜索并记录推荐替换：`new HttpClient(`、`.GetAsync(`、`.PostAsync(`、`.SendAsync(`（确认 receiver 是 `HttpClient`；排除 receiver 为注入或由注入工厂产生的调用）-> 注入 `HttpClient`（通常由 `IHttpClientFactory` 提供）。
17. 按控制台类别搜索并记录推荐替换：`Console.WriteLine(`、`Console.ReadLine(`、`Console.Write(`、`Console.ReadKey(` -> `IConsole` wrapper 或 `ILogger`。
18. 按进程类别搜索并记录推荐替换：`Process.Start(`、`Process.GetCurrentProcess(`、`Process.GetProcessesByName(` -> 自定义 `IProcessRunner`。
19. 对时间调用，除计数外还要检查使用方式：同一逻辑操作中两次环境时钟读取算两个调用点，也是一致性缺陷；例如分别读取 `DateTime.UtcNow` 赋给 `CreatedAt` 和 `ExpiresAt = DateTime.UtcNow.AddDays(30)` 可能漂移；建议捕获一个统一瞬间。
20. 使用 `TimeProvider` 时尽量保留 `DateTimeOffset`；若现有成员需要 UTC `DateTime`，用 `GetUtcNow().UtcDateTime`，绝不要 `.DateTime`，因为它会丢失 UTC kind。
21. 将捕获单一瞬间视为可选的行为级后续改进：机械 wrapper 迁移必须逐一对齐原始读取，除非用户另行批准该语义变更。
22. 在整个扫描范围内统计每个调用点，包括实例成员调用点，不只是 `static` 调用。
23. 在写叙述前建立唯一 occurrence ledger；每个纳入的调用点恰好一行，包含类别、精确模式、`file:line`、推荐缝；所有类别、模式、每文件计数都通过分组同一 ledger 得出，绝不独立重算。
24. 保持三个计数域分开：`Files scanned` 包含所有符合条件的源文件；`affected files` 只包含 ledger 中有行的文件；`call sites` 是 ledger 行数；不要互相替代。
25. 只发布一个权威总数；找到的每个调用点都属于类别汇总和总计；绝不把真实发现放进不计入总数的「additional observations」区。
26. 按成员接触的资源分类，而不是按是否为 `static` 分类；访问同一不可测试资源的实例成员仍要计数并归入对应类别（如 `new FileInfo(path).LastWriteTimeUtc` -> File System；`new HttpClient().GetAsync(...)` -> Network）；实例调用要称为 hidden dependency，而不是 static。
27. 统计实例调用前检查 receiver 来源；只有被测代码自己获取或构造依赖时才计数；排除构造函数、参数、属性、DI 注入的协作者，包括具体 `HttpClient`。
28. 从「需要包装」总数中排除确定性纯 helper：`Path.Combine`、`Path.GetExtension`、`Path.GetFileName`、`Math.*` / `string.*` 静态方法不读取环境输入且易测；如需列出，放在单独的 no action needed 说明中，绝不作为可测试性阻塞项。
29. 报告前覆盖所有类别：time、file system、environment、network、console、process、randomness（`new Random()`、`Guid.NewGuid()`）、culture（`CultureInfo.CurrentCulture`）、serialization/statics（如 `JsonSerializer`）；漏掉存在的类别就是少计。
30. 每个 occurrence 都给出 `file:line`，方便直接跳转。
31. 发布前对账：类别总计、top-patterns 表、每文件表必须加总到同一个 grand total。
32. 将排除项视为范围决策而非类别；在建立 ledger 前移除 `obj/`、`bin/`、生成文件、用户排除文件；任何报告计数都不包含其文件或调用点；只说明一次排除项，不要混入算术。
33. 给截断排名打标签：全面审计中如需对账应列出所有不同模式；若用户只要 top-N 子集，标明是子集，不要暗示其行加总等于 grand total。
34. 生成类别汇总：每个类别总调用点数（time、filesystem、env 等）。
35. 生成 Top patterns：按计数排名最高的 10 个具体模式。
36. 生成 Most affected files：静态依赖数最高的文件。
37. 列出每个类别已有的 .NET 抽象：Time -> `TimeProvider`（.NET 8 内置）；File system -> `System.IO.Abstractions`（NuGet 包）；HTTP -> `IHttpClientFactory`（内置）；Environment -> 自定义 `IEnvironmentProvider`；Console -> 自定义 `IConsole` 或 `ILogger`；Process -> 自定义 `IProcessRunner`。
38. 按结构化报告输出：`## Static Dependency Report`，包含 `**Scope**`、`**Files scanned**`、`**Total static call sites**`；`### Category Summary` 表（Category、Call Sites、Recommended Abstraction）；`### Top 10 Patterns` 表（#、Pattern、Count、Files）；`### Most Affected Files` 表（File、Static Calls、Categories）；`### Migration Priority` 列表。
39. 根据报告推荐先处理哪个类别（计数最高、内置支持最好），保持几行。
40. 仅当用户下一步明确需要时提到 `generate-testability-wrappers` 或 `migrate-static-to-wrapper`，作为交接说明而非推销；绝不用促销性 next-steps 结尾稀释发现。
41. 按用户请求缩放响应：只问特定类别（如 find time statics）时聚焦该类别并给文件位置和计数，不生成所有类别的完整报告。
42. 用户提供具体文件或目录路径时只扫描该范围；除非用户要求，不要扩展到整个解决方案。
43. 完整结构化报告格式仅用于全面审计请求；聚焦问题只返回相关子集（如请求类别的 category summary + affected files）。
44. 不要加载技能或宣布扫描计划后就停止；在同一响应中返回完整审计；如果所有回退都真失败，报告已验证的部分发现和确切限制，不要编造发现或用重新运行请求替代审计。
45. 检查 `.csproj` 的 `TargetFramework`：若 `< net8.0`，不要推荐 `TimeProvider`，改为推荐 `NodaTime.IClock` 或自定义 `ISystemClock`。
46. 执行验证清单：范围内所有 `.cs` 文件已扫描并核对数量；报告包含类别总计、top patterns、affected files；三者对账到同一 grand total；`Files scanned`、`affected files`、`call sites` 作为不同量报告；所有聚合来自一个 ledger 而非独立重算；每个 occurrence 有 `file:line`；没有发现被留在 totals 之外的 additional 区；注入协作者调用未计入 needs wrapping；确定性纯 helper 未计为阻塞；每个检测到的模式都有推荐替换；`obj/` 和 `bin/` 已排除；迁移优先级按影响排序（count × ease of replacement）。
47. 避免常见陷阱：不要扫描 `obj/` 或生成代码；不要统计注入协作者调用；不要漏掉 lambda/LINQ 中的 static；不要在 < .NET 8 推荐 `TimeProvider`；不要忽略测试项目（只扫生产代码，排除 `*.Tests.csproj`）；不要因把发现降级到末尾 also noticed 段而少计；不要把实例成员叫 static；不要为 `Path.Combine` 推荐 wrapper。

适用边界 · 注意事项

• 目标未显式涉及 C#、.NET、`.cs` 或 `.csproj` 时不要激活或使用。
• 用户要生成测试性 wrapper 或执行静态到 wrapper 的迁移时不要用，分别交给 `generate-testability-wrappers`、`migrate-static-to-wrapper`。
• 静态调用已经位于接口或 `TimeProvider` 之后，或代码不是 C#/.NET 时不要用。