SuperAPI AI 工具集

php

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:为编写、审查、重构 PHP 代码提供统一的语言约定与现代惯用法,基线为 PHP 8.5+,不保留旧版本兼容,除非项目明确要求。

主要能力:每个文件以 declare(strict_types=1) 开头;公共 API 边界全部标注类型,使用联合、交叉、DNF 类型,单类型可空优先用 ?T,联合中 null 放最后;类常量与属性均需类型,callable 属性用 Closure。用枚举替代裸字符串/整数伪枚举,backed enum 用于与 JSON、数据库、API 交互,from() 抛异常、tryFrom() 返回 null。类方面强调显式可见性、构造器提升、readonly 属性与类、非对称可见性、属性钩子,组合优于继承,接口定义契约,#[Override] 标注覆写。函数提倡早返回、单一职责、命名参数、match 替代 switch、8.5 管道操作符与一等可调用语法。错误处理要求捕获最窄异常类型,仅在应用边界捕获 Throwable,链式保留原因,自定义异常继承 RuntimeException 或 LogicException。数组用短语法与 array_map/filter/reduce 等函数式转换。打包以 composer.json 为唯一事实来源,依赖用 ^ 约束,PSR-4 自动加载,应用提交锁文件、库不提交。格式遵循 PER-CS:4 空格缩进、类与方法大括号换行、控制结构同行、多行结构尾随逗号、修饰符顺序为 abstract/final、可见性、static、readonly。

使用方式:编写代码时静默应用全部约定,不逐条叙述;审查时直接指出违规并给出修正,不做说教。代码导航必须使用已配置的 Intelephense LSP 工具(goToDefinition、findReferences、hover、documentSymbol、workspaceSymbol、goToImplementation、incomingCalls、outgoingCalls),Grep/Glob 仅用于注释、字符串、日志、TODO、配置值、环境变量、文件名模式、URL 与错误文本等非 PHP 标识符内容;派生子代理探索代码库时同样要求使用 LSP。与 coding 技能(负责工作流)和 phpunit 技能(负责测试约定)同时生效。

适用场景:PHP 项目的日常开发、代码评审、重构与规范落地。

限制:资料未提供具体安装命令、收费方式、支持平台与效果数据;引用文件位于 ${CLAUDE_SKILL_DIR}/references/ 下的 typing.md、oop.md、concurrency.md、packaging.md。