针对 WellCMS 3.0 开发“婚车插件”,最快的方法确实是用 Claude Code + 官方 Skill 直接“生成”脚手架。但既然你要“分析源文件”,我们先拆解一下官方代码结构,让你知道该让 AI 看哪些文件来学习写法,然后直接给出一条龙生成指令。

🧐 第一步:先分析官方源码(找样板)

既然官方 Skill 已经内置,你可以先让 Claude 分析以下3个关键源文件,让它学习 WellCMS 的插件标准写法(直接在 Claude 对话里 @ 引用文件):

1. 查看现有插件示例:去 plugin/ 目录下看有没有官方示例插件(如 plugin/demo/),重点关注:
   · 目录结构(必须有 config/, controller/, model/, view/, lang/)
   · plugin.json 的元数据格式
2. 查看基类源码:
   · app/Controller/BaseController.php(控制器必须继承这个)
   · app/Model/BaseModel.php(模型必须继承这个)
3. 查看路由注册方式:route/api.php 或 route/web.php,确认是元数据驱动还是手动注册。

---

⚡️ 第二步:直接用 AI 生成全量代码(最快路径)

分析完源文件后,你不需要手动写一行代码。直接在项目目录启动 claude,然后粘贴下面这段超级指令(已深度结合官方 Skill 铁律):

“请根据 .claude/skills/wellcms_development 的规范,开发一个完整的『婚车租赁插件』,插件名暂定 CarRental。要求如下:

1. 数据模型:创建 wc_car(车辆表:品牌、型号、颜色、座位数、日租金、主图)、wc_car_order(订单表:车辆ID、用户ID、用车日期、租用天数、联系人、电话、总价、状态pending/confirmed/completed/canceled)。
2. 后台功能(控制器在 admin/ 下):车辆增删改查(带图片上传)、订单列表与状态流转。
3. 前台功能(控制器在 index/ 下):车辆列表页(分页)、详情页、在线下单提交(需校验日期是否被占用)。
4. 路由:按 WellCMS 元数据方式注册,前后台分离,权限校验按官方标准。
5. 响应:统一使用 ResponseFormatter,禁止直接 echo。
6. 输出要求:先输出六要素规格文档(Spec),确认无误后再批量生成全部 PHP 文件和 SQL 建表语句。”

---

🚀 第三步:执行与调试

1. AI 会先出 Spec:你确认业务逻辑无误后,回复 “确认,开始生成代码”。
2. 自动落盘:Claude Code 会根据 Skill 的铁律,直接在 plugin/CarRental/ 下生成完整的 MVC 结构、路由配置、语言包和 SQL 文件。
3. 微调:如果生成后某个细节不对(比如分页写法),直接在对话里说“把车辆列表的分页改为 paginate(15)”,AI 会精准修改对应文件。

💡 给你的特别提示(避坑)

· 图片处理:官方 Skill 可能没有自带上传类,生成代码后,记得让 AI 补充“使用 WellCMS 的 File::upload() 方法处理图片”。
· 日期冲突校验:订单逻辑涉及并发,生成后务必让 AI 检查“是否利用了 $this->db->lock() 或事务机制”,避免同一辆车同一天被重复预定。

先跑一遍这条指令,如果生成时 AI 报“找不到某个基类”,直接复制报错贴回对话,AI 会立刻分析 app/ 下的源文件并修正调用路径。放胆试,这套组合拳最省力!🎉