Truc350/WebHomeStay / .agents/skills/plugin-cms
plugin-cms
UnverifiedTạo, sửa, kiểm thử và đóng gói plugin Laravel CMS với manifest, lifecycle, routes, admin console, widget, schema, hook, shortcode, asset, migration và permission; tách đúng trang quản lý trong admin menu khỏi trang cấu hình trong khu vực Plugins.
CMS Plugin Builder
Mở rộng C:\xampp\htdocs\cms bằng plugin tự chứa trong plugins/{slug}. Giữ logic/chức năng trong plugin, không sửa core/theme chỉ để phục vụ một plugin.
Workflow
- Đọc lifecycle-structure.md để xác định scope, slug, cấu trúc và lifecycle.
- Đọc manifest-routes.md trước khi viết manifest/routes/permission.
- Nếu có widget, đọc widgets-settings.md; nếu có admin lớn, đọc admin-console.md.
- Đọc data-migrations.md cho dữ liệu riêng và frontend-hooks-shortcodes.md cho frontend, hook hoặc shortcode. Nếu plugin có bất kỳ giao diện nào, bắt buộc đọc localization.md.
- Đọc assets-package.md, rồi chạy validation.md trước khi handoff.
Non-Negotiable
- Bắt buộc có
plugins/{slug}/plugin.json; plugin active mới đăng ký route/view/widget/hook/asset. - Dùng registry/manifest cho menu, permission và route; không sửa sidebar/core auth chỉ để vá điều hướng của một plugin.
admin_menuchỉ mở trang nghiệp vụ/quản lý độc lập trong admin panel; trang này không dùngadmin.plugins._sidebar.settings_routelà lối vào cấu hình chi tiết từ nút Cấu hình và sidebar Danh sách plugin; sidebar này chỉ xuất hiện trong khu vực cấu hình plugin và không mở route nghiệp vụ.- Không tạo tab nội bộ nối trang quản lý với trang cấu hình. Giữ hai luồng điều hướng độc lập.
- Giữ widget fields trong
settings_schema; console cấu hình chỉ giữ plugin-wide settings và resource cấu hình, còn CRUD/workflow nghiệp vụ nằm ở trang quản lý. - Deactivate không xóa data; migration/update phải bảo toàn dữ liệu.
- Plugin self-contained dùng
plugin-assets/{slug}, không phụ thuộc theme cụ thể. - Plugin có giao diện frontend hoặc admin phải tự chứa ít nhất hai locale
vivàen;vilà mặc định và fallback. Không đặt chuỗi nghiệp vụ của plugin trong bộ dịch theme. Chỉ bổ sung locale khác khi theme/yêu cầu cụ thể cần đến. - Giữ locale qua GET, POST, validation và redirect; không chấp nhận giao diện chỉ dịch menu hoặc tiêu đề trong khi nội dung còn hard-code.
- Escape dữ liệu, CSRF form, giới hạn query, prefix CSS/JS và chống boot trùng.
- Đóng ZIP không chứa cache, vendor, node_modules, path máy dev hoặc theme cũ.
Handoff
Báo path/plugin state, admin route, widget/shortcode/hook, migration, asset, lệnh kiểm tra và ZIP nếu có.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |