review-powershell
Installation
SKILL.md
技能(Skill):审查 PowerShell
目的 (Purpose)
仅查看 PowerShell 中的代码的语言和运行时约定。不要定义范围(差异与代码库)或执行安全/架构分析;这些是通过范围和cognitive技能来处理的。以标准格式发出结果列表以进行聚合。重点关注高级功能设计、参数验证和绑定、错误处理语义、对象管道行为、模块/导出和命名约定、兼容性(Windows PowerShell 与 PowerShell 7+)和可测试性。
核心目标(Core Objective)
首要目标:生成 PowerShell 语言/运行时结果列表,涵盖给定代码范围的函数设计、参数契约、错误处理、管道行为、状态/范围、兼容性和可测试性。
成功标准(必须满足所有要求):
- ✅ 仅 PowerShell 范围:仅审查 PowerShell 语言和运行时约定;未执行范围选择、安全性或架构分析
- ✅ 涵盖所有七个 PowerShell 维度:在相关的情况下评估高级函数/cmdlet 约定、参数设计/验证、错误处理语义、对象管道行为、状态/范围/严格性、兼容性/可移植性和可测试性
- ✅ 结果格式兼容:每个结果包括位置、类别(
language-powershell)、严重性、标题、描述和可选建议 - ✅ 文件:行引用:所有发现都引用带有行号的特定文件位置
- ✅ 排除非 PowerShell 代码:除非明确在范围内,否则不会分析非 PowerShell 文件的 PowerShell 特定规则