初始化本地仓库

.windsurf/skills/backend-enum/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: backend-enum
+description: 枚举规范，继承 IEnum 接口，支持 label()/tryFrom() 模式
+globs:
+  - "app/enum/**/*.php"
+  - "app/**/enum/**/*.php"
+---
+
+## 文件位置
+
+```
+app/enum/{module}/{Name}Enum.php
+```
+
+## 代码模板
+
+```php
+<?php
+
+namespace app\enum\{module};
+
+use core\interface\IEnum;
+
+enum {Name}Enum: int implements IEnum
+{
+    case ACTIVE = 1;
+    case INACTIVE = 0;
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::ACTIVE   => '启用',
+            self::INACTIVE => '禁用',
+        };
+    }
+}
+```
+
+## 关键约定
+
+- 所有枚举实现 `core\interface\IEnum` 接口
+- 枚举使用 PHP 8.1+ native enum，backed by int 或 string
+- 必须实现 `label()` 方法返回中文描述
+- 枚举值一旦发布不可修改（只能追加）
+- 模型字段转换使用 `$casts` 中的 `EnumsCast`
+
+## 检查清单
+
+- [ ] 是否实现 IEnum 接口
+- [ ] 是否包含 label() 方法
+- [ ] 枚举值是否稳定（发布后不改）
+- [ ] 命名空间是否正确