用途：帮助理解 powerplatform-build-tools 代码库架构、跨仓库追踪问题，或按症状调试失败。若给出具体错误，可依据架构图定位失败层并执行对应调试步骤。
主要能力：提供仓库依赖图（build-tools → @microsoft/powerplatform-cli-wrapper → pac CLI → Power Platform API）、各层职责与不负责范围、以 export-solution 为例的完整调用链、按层划分的关键文件清单、认证类型与环境变量映射、按症状的调试手册、任务流水线依赖顺序及构建产物结构。
使用方式：按症状查调试手册。例如 pac.exe 未找到时，确认 tool-installer 任务先运行并设置 POWERPLATFORMTOOLS_PACCLIPATH；认证失败时检查服务连接凭据、认证类型与 cloudInstance；解决方案未找到时设置 system.debug=true 启用 --log-to-console 查看 pac 命令。更新 pac CLI 版本需改 nuget.json 并运行 gulp restore。
适用场景：Azure DevOps 扩展开发与维护、构建失败排查、依赖漏洞修复、任务流水线编排。
限制：不支持 Managed Identity；不支持 Azure DevOps Server 2020 本地部署；whoAmI 在非英文区域设置下可能失败，需将构建代理设为 en-US；PVA 组件导入失败需升级 pac CLI 或联系 PAC CLI 团队；bundleDependencies 中的包无法通过 npm overrides 修复，需直接修补 lock 文件。