1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | pester-migration-github-awesome-copilot |
| 作者/维护者 | GitHub（github/awesome-copilot 官方合集仓库）；技能内容由 Pester 框架核心维护者之一贡献 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/pester-migration |
| 许可证 | MIT（仓库级，来自 GitHub API） |
| GitHub Stars | 38,765（GitHub API，属整个 awesome-copilot 合集，不代表本技能自身热度） |
| Forks | 4,909（同上，属合集整体） |
| 最新版本 | 无独立版本号，随仓库持续更新（本技能内容最近一次改动 2026-07-12） |
| 安装方式 | gh skills install github/awesome-copilot pester-migration（需 GitHub CLI）或手动复制 skills/pester-migration 整个目录 |
2. 功能介绍与亮点
Pester 是 PowerShell 的标准测试框架，历次大版本升级（v3→v4、v4→v5、v5→v6）都会让旧测试套件大批量报错，这个技能专门解决“升级 Pester 版本后测试全红”的问题：
- 三条独立迁移路径：v3→v4、v4→v5、v5→v6 各自对应一份独立参考文档，Agent 按需加载对应章节，而不是一次性把全部内容塞进上下文。
- 版本反推诊断表：给出一张“从测试代码里出现的具体写法（如
Should Be无横线、Assert-MockCalled）反推当前版本”的对照表，不需要用户自己先搞清楚版本号。 - 心智模型清晰：明确指出 v4→v5 是“运行时机制的根本变化”（Discovery/Run 两阶段模型），而 v3→v4、v5→v6 大多是语法层面调整，并要求“一次只跨一个大版本，不要跳级”。
- 引用官方权威来源：以 Pester 官方迁移文档 pester.dev/docs/migrations/ 为权威来源，技能是对官方文档的结构化镜像与执行指导。
- 技能内容由 Pester 框架的实际核心维护者之一撰写、经 GitHub 官方账号评审合并，准确性有直接的技术权威背书。
3. 适用场景
固定分类：工程效率与代码质量
任何维护 PowerShell 测试套件（*.Tests.ps1）的团队，在升级 Pester 版本后遇到测试全红、需要把 Assert-MockCalled、Invoke-Pester 等旧语法批量迁移到新版本时可用。对使用 Claude Code、Codex 等 Coding Agent 的初中级用户尤其省心——不用先啃三份官方迁移文档才敢升级依赖版本。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——标准 Agent Skills 格式（SKILL.md + YAML front matter +
references/子目录），复制到.claude/skills/目录即可使用。 - Codex：✅ 原生支持——Codex CLI 技能系统构建在同一 Agent Skills 标准之上，兼容含子文件引用的 SKILL.md 结构。
- OpenClaw：未验证。
- Hermes Agent：未验证。
5. 推荐理由
Pester 大版本升级（尤其 v4→v5 的 Discovery/Run 重构）是 PowerShell 测试维护里公认的高摩擦环节，官方迁移文档本身分成三份、内容详尽但阅读门槛不低。这个技能把“先诊断处于哪个版本、该走哪条升级路径”自动化，并把官方文档拆成按需加载的参考资料。内容由 Pester 框架实际维护者撰写、经 GitHub 官方仓库评审合并，免费开箱即用，不依赖任何付费服务。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 官方合集仓库出品，是被广泛使用的开发工具平台配套内容；该子技能自身尚无独立于合集之外的第三方讨论证据 |
| 可用性 | 9 | 单条命令即可安装；SKILL.md + 3 份独立参考文档架构清晰、按版本分层，附带版本诊断表；内容 2026-07 更新，仓库整体每日活跃维护；无付费依赖 |
| 安全性 | 9 | 纯提示词与文档指导类技能，本身不含可执行脚本，不联网外发数据；文中的 PowerShell 命令是给用户参考手动执行的安装指令，不由 Agent 自动运行 |
安全检查清单：
① Shell 命令执行——文档中给出 Install-Module 等命令供用户参考执行，技能本身不自动运行任何脚本。
② 联网外发——无。
③ API Key/凭据——不需要。
④ 可疑指令——通读全文（含三份参考文档）未发现夹带指令或 prompt injection 迹象。
⑤ 作者/组织信誉——GitHub 官方仓库出品；内容由 Pester 框架核心维护者之一贡献，经 GitHub 官方账号评审合并。
⑥ License——MIT，明确。
⑦ 最近维护——仓库整体每日有提交；本技能内容最近一次改动为 2026-07-12。
综合评分 = (7+9+9)/3 = 8.3
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| junit-5-skill-lambdatest-agent-skills | 帮助将 Java 测试从 JUnit 4 迁移到 JUnit 5 的语法与断言变化 | 覆盖 Java/JUnit 生态；本技能覆盖 PowerShell/Pester 生态，服务不同技术栈下同类“测试框架版本迁移”痛点，互不重叠 |
| test-driven-development-addyosmani-agent-skills | 通用测试驱动开发方法论指导，教如何从零写好新测试 | 面向“怎么写新测试”；本技能面向“已有测试套件如何跟着框架大版本升级走”，二者互补而非替代 |
8. 用户评价
该技能目前在第三方平台（Reddit、Hacker News、PowerShell 社区论坛等）尚无具名用户评价。技能收录于 GitHub 官方的 Awesome GitHub Copilot 技能展示站，该站为自动化技能目录聚合，非人工撰写的使用反馈。
9. 其他补充
技能覆盖 v3→v4、v4→v5、v5→v6 三条独立迁移路径，覆盖 Pester 从较早版本到当前最新大版本的完整升级链路，遇到跨多个大版本的迁移需求时需分步依次应用对应路径的指导，而非一次跳级。
10. 安装使用方式
方式一（GitHub CLI，推荐）：
gh skills install github/awesome-copilot pester-migration方式二（手动安装）：
将仓库中的 skills/pester-migration/ 整个目录（含 references/ 子目录的三份迁移指南）复制到本地 Agent 的 skills 目录（如 Claude Code 的 .claude/skills/）。
安装后，在 PowerShell 测试套件升级 Pester 版本后报错、或明确要求“升级 Pester 测试”时向 Agent 提出请求即可触发；技能会先判断已安装版本与测试代码对应的版本，再决定加载哪条迁移路径的参考文档。
11. 注意事项
- 技能只给出迁移后的代码改法，不会自动运行测试验证结果，需要用户在迁移后自行执行
Invoke-Pester确认套件转绿。 - 内容以英文撰写。
- 技能明确建议一次只跨一个大版本迁移，跳级迁移（如 v3 直接跳 v6）需要分步依次应用对应路径的指导，而非一步到位。