前言¶

电力电子和新能源系统中的锁相环（PLL）设计，需要反复调整 PI 控制器参数以获得合适的带宽和阻尼比。手动计算参数容易出错，且调试过程耗时。当开发者提到”锁相环”、”PLL”、”PLL带宽”、”PI参数”、”KPLLp”、”KPLLi”、”阻尼比”、”自然频率”等关键词时，这个 Skill 可以介入，提供参数计算支持。

这是什么¶

这是一个基于 SKILL.md 格式的 Skill，用于计算和整定 PLL 的 PI 控制器参数。由社区开发者 user_28a3fa40 发布，版本 1.0.0，属于 dev-programming 分类。它提供两种计算方向：根据目标带宽和阻尼比正向计算 PI 参数（KPLLp/KPLLi），或根据已知 PI 标幺值参数反推闭环带宽和阻尼比。

核心功能¶

正向参数计算¶

根据用户设定的目标带宽和阻尼比，计算 PI 控制器的参数（KPLLp/KPLLi）。这一步用于在设计阶段确定控制器参数。

反向参数反推¶

当已知 PI 标幺值参数时，可以反推闭环带宽和阻尼比，用于验证现有设计的性能指标。

触发关键词¶

当对话中包含以下关键词时，Skill 会自动识别并介入：锁相环、PLL、PLL带宽、PI参数、KPLLp、KPLLi、阻尼比、自然频率。

安装与启用¶

Skill 需要通过支持 SKILL.md 格式的环境（如 Cursor、Codex CLI、Claude Code）安装。具体安装方式请参考官方地址：

https://api.skillhub.cn/user_28a3fa40/pll-designer

安装后，在对话中提及上述关键词即可触发参数计算功能。

典型用法¶

场景一：正向计算¶

用户输入：

设计一个带宽为 50Hz、阻尼比为 0.7 的 PLL，计算 PI 参数 KPLLp 和 KPLLi。

Skill 返回：
- KPLLp：[计算结果]
- KPLLi：[计算结果]

场景二：反向验证¶

用户输入：

已知 KPLLp = 10.5，KPLLi = 0.8，反推闭环带宽和阻尼比。

Skill 返回：
- 闭环带宽：[计算结果]
- 阻尼比：[计算结果]

适用场景与注意¶

适用场景¶

• 电力电子系统中的 PLL 设计
• 新能源发电系统（如光伏、风电）的并网控制
• 需要快速验证 PI 参数性能的调试过程
• 教学与学习 PLL 设计的开发者

注意事项¶

• Skill 仅提供参数计算功能，不涉及 PLL 的电路实现或仿真
• 计算结果需结合实际系统进行验证
• 需确保输入参数（带宽、阻尼比）在合理范围内

结尾¶

锁相环参数整定是电力电子控制设计的核心环节。这个 Skill 提供了双向参数计算能力，帮助开发者快速确定或验证 PI 控制器参数。对于需要频繁进行 PLL 设计和调试的开发者，可以节省大量手动计算时间。官方地址：https://api.skillhub.cn/user_28a3fa40/pll-designer