@estebanforge/pi-php-review

针对PHP 8.2+的Git代码差异审查工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@estebanforge/pi-php-review。
它的用途是:针对PHP 8.2+的Git代码差异审查工具
完整的 Skill 内容见:https://321skill.com/skills/estebanforge-pi-php-review/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请用pi-php-review工具分析我最近的Git提交diff。”,它会自动获取您的代码变更,并依据PHP 8.2+审查标准进行打分,指出不符合规范的代码位置,同时利用LLM生成修正后的代码建议,帮助您快速改进代码质量。

介绍

这个Skill是一个专为PHP代码审查设计的工具,它解决了开发者在代码审查中难以系统化、标准化地评估PHP代码质量的问题。它通过分析Git提交的代码差异,自动对照一个精心设计的PHP 8.2+审查标准(涵盖严格类型、错误处理、内置函数正确性和安全性四个方面,共16个条目)进行评分。

使用方式非常简单:您只需在Pi环境中安装此Skill,然后让它分析您的Git代码差异。它会自动将您的代码与标准中的“坏例子”和“好例子”进行比对,并利用大语言模型(LLM)的能力,为不符合标准的代码片段生成修正建议。

这个工具非常适合PHP开发团队、项目负责人或任何希望提升PHP代码库质量的开发者。它特别适用于希望在代码合并前快速识别潜在问题、遵循现代PHP最佳实践(尤其是PHP 8.2+特性)的团队。

使用建议是,将其作为代码提交前或Pull Request审查流程中的一个自动化检查环节。需要注意的是,它主要基于预设的规则和LLM的建议,不能完全替代人工的深度逻辑审查,对于复杂的业务逻辑或架构设计问题仍需开发者自行判断。

核心特点

与同类通用代码审查工具相比,它深度聚焦于PHP 8.2+的特定最佳实践,提供了一个结构化的、包含16个具体条目的审查标准(rubric),并且直接针对Git diff进行操作,能提供具体的修正代码片段。

注意事项

不适合审查非PHP代码、或需要深度理解复杂业务逻辑和架构设计的场景。

常见问题

这个工具支持哪些PHP版本?

主要针对PHP 8.2及以上版本的最佳实践进行审查。

它能审查整个项目还是只审查变更?

它专门用于审查Git提交产生的代码差异(diff),而非整个项目代码库。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/estebanforge-pi-php-review/raw/index.md 读取 @estebanforge/pi-php-review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。