wordpress-router

Tổng quan về skill wordpress-router

wordpress-router là một skill phân loại nhanh cho WordPress, giúp agent xác định loại repo thật nhanh và chọn đúng workflow tiếp theo trước khi sửa gì đó. Skill này hữu ích nhất khi yêu cầu của người dùng còn rộng hoặc codebase có thể là plugin, classic theme, block theme, gói Gutenberg, bản checkout WordPress core, hoặc repo full site.

Skill này dùng để làm gì

Skill wordpress-router dùng để điều hướng, không phải để chỉnh sửa. Nhiệm vụ của nó là giảm việc đoán mò ở giai đoạn đầu bằng cách xác định loại repo, công cụ sẵn có, các bài test có khả năng liên quan, và domain skill phù hợp nhất để dùng tiếp theo.

Ai nên cài đặt

Hãy cài wordpress-router nếu bạn thường xuyên làm việc trong các codebase WordPress và cần agent quyết định nên xem repo như blocks, theme.json, REST, WP-CLI, security, testing, hay release packaging work. Skill này đặc biệt hữu ích cho việc điều phối agent trên các repo WordPress pha trộn nhiều kiểu.

Vì sao nó quan trọng

Nếu không có router, agent rất dễ nhảy vào sai mô hình tư duy: dùng logic classic theme cho block theme, giả định đây là plugin trong khi thực ra là site repo, hoặc sửa đổi chung chung thay vì đi theo đúng workflow WordPress. Skill này thêm một bước phân loại thực tế, giúp chất lượng prompt ở bước sau tốt hơn và giảm nguy cơ tạo ra thay đổi không cần thiết.

Cách dùng skill wordpress-router

Cài đặt và tìm đường quyết định

Hãy dùng đúng đường dẫn cài đặt đã được tài liệu hóa cho skill wordpress-router, rồi bắt đầu với SKILL.md. Repo cũng trỏ tới references/decision-tree.md, đây là phần đọc tiếp theo hữu ích nhất cho các quyết định routing.

Cung cấp đúng đầu vào cho skill

Skill wordpress-router hoạt động tốt nhất khi bạn cung cấp:

• thư mục gốc của repo hoặc working directory hiện tại,
• mục đích thực sự của người dùng,
• các ràng buộc về phiên bản như mục tiêu WordPress hoặc yêu cầu WP.com,
• mọi giới hạn cứng về tooling, quy trình release, hoặc testing.

Một yêu cầu yếu kiểu “fix this WordPress repo” sẽ khó được routing chính xác. Một yêu cầu mạnh hơn sẽ là: “Đây là một repo wp-content; hãy xác định liệu nên xử lý nó theo workflow block theme hay plugin, rồi lập kế hoạch đường đi an toàn nhất cho một thay đổi template với bộ test hiện có.”

Workflow gợi ý cho lần dùng đầu tiên

1. Chạy bước triage dự án được mô tả trong SKILL.md.
2. Đọc kết quả triage để xác định loại dự án, tooling, và độ phủ test.
3. Mở references/decision-tree.md để ánh xạ ý định sang workflow tiếp theo.
4. Áp dụng quy ước của repo trước khi sửa, đặc biệt là các lệnh build và test hiện có.

Cần kiểm tra gì trước trong repo

Với hướng dẫn wordpress-router, hãy ưu tiên:

• SKILL.md để nắm quy trình routing và các guardrail,
• references/decision-tree.md để routing theo ý định,
• mọi tài liệu riêng của repo chỉ sau khi bạn đã biết loại dự án.

Thứ tự này quan trọng vì skill được thiết kế để thu hẹp đường đi trước khi bạn đi kiểm tra những phần còn lại.

Câu hỏi thường gặp về skill wordpress-router

wordpress-router có thay thế các domain skill không?

Không. Đây là skill quyết định ở lớp đầu vào cho Agent Orchestration. Nó giúp chọn workflow WordPress phù hợp, nhưng không thay thế skill về block, theme, plugin, hoặc testing sau khi repo đã được phân loại.

Khi nào không nên dùng wordpress-router?

Hãy bỏ qua nó khi nhiệm vụ đã hẹp và rõ, chẳng hạn như sửa một file cụ thể trong một workflow đã xác định rõ. Skill này ít giá trị hơn khi không có sự mơ hồ về routing.

Cài wordpress-router có đáng cho người mới không?

Có, nếu người mới có khả năng phải làm việc trên nhiều loại repo WordPress khác nhau. Nó cho điểm bắt đầu an toàn hơn một prompt chung chung, nhưng vẫn cần người dùng nêu rõ ý định và ràng buộc.

Nó tốt hơn prompt thuần túy ở điểm nào?

Một prompt thuần túy có thể chỉ yêu cầu thay đổi; còn wordpress-router trước hết hỏi đây là hệ thống WordPress kiểu gì và workflow nào nên chi phối thay đổi đó. Bước phân loại bổ sung này là lợi thế chính của skill wordpress-router.

Cách cải thiện skill wordpress-router

Nêu rõ ý định hơn, không chỉ nêu tác vụ

Đầu vào tốt nhất sẽ gọi tên kết quả mong muốn và bối cảnh repo. Ví dụ, thay vì nói “make it faster,” hãy nói: “đây là repo plugin WordPress; hãy xác định liệu công việc performance nên đi theo workflow plugin, REST hay block, rồi đề xuất điểm khởi đầu an toàn nhất.”

Thêm các ràng buộc ảnh hưởng đến routing

Skill này hoạt động tốt hơn khi bạn nêu rõ mục tiêu phiên bản WordPress, yêu cầu release, và giới hạn tooling. Những chi tiết này giúp nó quyết định liệu repo nên được xem là core, site, theme, plugin, hay work theo hướng Gutenberg.

Chú ý các kiểu lỗi thường gặp

Vấn đề phổ biến nhất là thiếu ngữ cảnh. Nếu agent không xác định được đang làm việc với block theme, classic theme, plugin, hay site repo, workflow tiếp theo có thể bị sai. Một kiểu lỗi khác là bỏ qua decision tree rồi nhảy thẳng vào sửa mã.

Lặp lại sau lần phân loại đầu tiên

Sau lượt đầu, hãy yêu cầu agent nhắc lại:

• loại repo,
• skill downstream có khả năng dùng tiếp,
• các file đã dùng để đưa ra quyết định,
• điểm không chắc chắn còn mở.

Cách này giúp wordpress-router hữu ích hơn cho Agent Orchestration vì bạn có thể sửa lại lộ trình trước khi bắt đầu thay đổi mã.