psadt-deploy-skill

psadt-deploy-skill 是一款面向 Windows 企业环境的专业 Claude Code 技能，专门用于驱动 PowerShell App Deployment Toolkit（PSADT）v4.x 的完整 Intune Win32 应用打包生命周期。从需求描述到经过测试、可上传至 Microsoft Intune 的 .intunewin 包，整个流程全部由 AI Agent 自动执行，涵盖调研、脚手架生成、三种部署类型配置、预检、系统测试、打包和 Graph API 上传等全部十二个阶段。

核心能力

psadt-deploy-skill 提供了十二个阶段的完整自动化工作流，覆盖 Intune Win32 包打包的全生命周期：

• Setup（阶段0）：自动健康检查，13 项前置条件逐项验证（PowerShell 7/5.1、权限、git、PSAppDeployToolkit、Intune 凭证等），提供 -Fix 参数自动修复可修复项；
• Intake + Research（阶段1-2）：通过交互式选项引导收集应用信息，并行调研版本号、静默安装参数和 Intune 已知问题；
• Scaffold（阶段3）：根据安装程序类型自动生成启动脚本、检测脚本、运行日志名称和元数据清单；
• Preflight 检查（阶段5）：10 项自动化预检（编码/BOM、AST 解析、v3 cmdlet、钩子结构、检测脚本契约等），返回 GREEN/RED 并指出失败文件名；
• SYSTEM 测试循环（阶段6，可选）：以 SYSTEM 账户权限执行安装/卸载/修复操作，镜像 Intune Management Extension 的实际行为，在上传前确保包质量；
• 打包（阶段7）：一键生成经过验证的 .intunewin 包，输出文件名以应用命名，包含 Detection.xml、SetupFile、SHA256 校验；
• HTML 报告（阶段8）：自动生成双语自包含 HTML 报告，含应用信息、返回码映射、检测规则、需求、分配信息和 Logo；
• Intune Graph 上传（阶段9，可选）：通过原生 Microsoft Graph API 直接上传包，无需第三方模块；
• Entra 组分配（阶段10，可选）：按命名规范创建或复用 Entra 安全组，配置 Required/Available/Uninstall 分配策略；
• 多种包类型支持：MSI/EXE、WinGet 生命周期、浏览器扩展（Edge/Chrome/Firefox）、Windows 功能、第三方驱动程序等多种安装程序类型。

安装与配置

系统要求：

• Windows + PowerShell 5.1+ / PowerShell 7+
• Node.js 18+（仅用于 npx 安装器，技能本身不需要 Node）
• PSAppDeployToolkit v4.x（自动从 PowerShell Gallery 安装）
• Microsoft Win32 Content Prep Tool（自动下载）

安装步骤：

# 一键安装（推荐）
npx psadt-deploy-skill

安装后首次运行会自动执行 Setup Doctor，检查所有前置条件并提供 -Fix 自动修复。

使用步骤

以打包 7-Zip 为 Intune Win32 包为例：

1. 描述需求：在 Claude Code 中直接说「Create the Win32 Intune package for 7-Zip 24.09」；
2. AI 引导收集：Skill 最多提出四个决策门（范围、部署语义、SYSTEM 测试确认、上传确认），其余信息自动调研填充；
3. 自动化执行：Skill 自动完成调研、脚手架、配置、预检、SYSTEM 测试、打包全流程；
4. 报告生成：自动生成 HTML 双语报告，包含完整技术信息；
5. 确认上传：提供只读 Dry Run，确认后通过 Graph API 上传至 Intune。

适用场景

• 企业 IT 管理员：需要大量打包 Win32 应用供 Intune 部署的 IT 团队，AI 自动化大幅提升打包效率；
• 安全合规团队：通过 SYSTEM 测试循环和预检机制，确保每个包在上传前都经过实际安装验证；
• DevOps 工程师：将包打包流程标准化为 AI 可执行的 Skill，实现打包任务的版本化和可重复执行；
• 大型企业 Windows 迁移：批量将传统 Win32 应用迁移至 Intune 管理，Skill 可处理 MSI、EXE、WinGet、浏览器扩展等多种安装程序。

适用人群

企业 IT 管理员、Intune/MECM 工程师、Windows 平台运维人员，以及需要批量管理 Windows 应用程序的企业安全合规团队。

工作原理

psadt-deploy-skill 的核心是一个由 AI Agent 驱动的十二阶段流水线，每个阶段由专门的 PowerShell 脚本控制：

1. Setup Doctor：运行 Initialize-PsadtSkill.ps1 进行 13 项前置检查，提供 GREEN/YELLOW/RED 状态；
2. Intake：通过交互式选项收集应用基本信息和部署需求；
3. Research：自动调研应用的版本、安装参数、Intune 已知陷阱；
4. Scaffold：调用 New-MsiPackage/New-BrowserExtensionPackage/New-WindowsFeaturePackage 等生成器创建包结构；
5. Preflight：运行 Invoke-PsadtPreflight.ps1 执行 10 项自动化检查；
6. SYSTEM Test：运行 Invoke-PsadtSystemTest.ps1 以 SYSTEM 权限执行实际安装/卸载验证；
7. Package：运行 Invoke-PsadtPackage.ps1 生成 .intunewin 包并验证 SHA256；
8. Report：运行 New-PsadtReport.ps1 生成双语 HTML 报告；
9. Upload（可选）：运行 Invoke-IntuneWin32Upload.ps1 通过 Graph API 上传；
10. Assign（可选）：运行 Invoke-IntuneAppAssignment.ps1 创建 Entra 组并分配应用。

官方链接

• npm：https://www.npmjs.com/package/psadt-deploy-skill
• GitHub：https://github.com/pt1987/claude-code-psadt-skill
• PSADT 官网：https://psappdeploytoolkit.com/