description: "Research phase orchestrator: Conversational Query Expansion" version: "1.0"

/seo-research-query

Purpose

Executes Phase D: Conversational Query Expansion. It takes the highly filtered and approved keywords from Phase C (keywords.json) and expands them into natural, conversational AI queries (RAG Fan-out). Sử dụng LLM kết hợp với chân dung độc giả (Persona) để phóng tác các từ khóa SEO cốt lõi thành các câu hỏi hội thoại dài mà người dùng thực tế sẽ hỏi ChatGPT, Perplexity, Gemini, v.v.

Đầu ra là bộ từ khóa hội thoại đầy đủ (harvested-queries.json), sẵn sàng cho bước Phân cụm & Gán ý định (/seo-research-clustering).

Skills Activated (up to 10)

Prerequisites

• Yêu cầu cấu hình dự án project.json đã có sẵn.
• Yêu cầu audience.json và keywords.json đã hoàn tất (từ /seo-research-keywords).

Sub-Agent Coordination

• Primary Executor: @[topical-authority-planner] (generates conversational queries and long-tail expansions)
• Co-owner: @[search-intent-profiler] (classifies long-tail user intent patterns)

Execution Flow

Step 1: Init Context

• Nạp cấu hình từ .seo/project.json, .seo/data/audience.json và đặc biệt là danh sách từ khóa sạch từ .seo/data/keywords.json.

Step 2: Conversational Query Generation (RAG Fan-out)

• LLM sử dụng danh sách Persona làm la bàn, kết hợp với các mẫu AI Prompt từ kỹ năng seo-prompt-research để phóng tác các từ khóa SEO truyền thống thành các Conversational Queries (câu hỏi hội thoại tự nhiên, nhiều vế, hỏi đáp đa chiều).
• Quá trình này được thực hiện qua kịch bản Python mở rộng để đảm bảo sinh ra số lượng lớn queries cho từng từ khóa gốc.
• Lệnh: python .agents/skills/seo-plan/scripts/hybrid_query_harvester.py {domain} --action expand_conversational
• Output chính: .seo/data/harvested-queries.json.

Step 3: Workflow Finalization

• Cập nhật project.json.workflow_checkpoint với {workflow: "seo-research-query", status: "completed"}.

💡 Không cần PAUSE Gate tại đây vì tiến trình này thuần túy là mở rộng dữ liệu tự động từ bộ keyword đã duyệt. Orchestrator sẽ báo cáo và chuyển thẳng sang /seo-research-clustering.

Final Dashboard

Trình bày báo cáo tổng kết (Final Dashboard) bằng Markdown trực quan, hướng người dùng (user-facing) và cung cấp thông tin chi tiết về tập dữ liệu vừa tạo. Tránh dùng hộp ASCII khô khan. Sử dụng template sau:

# 🎯 Báo cáo Conversational Queries — `{domain}`

**Trạng thái**: Hoàn tất phóng tác truy vấn hội thoại (RAG Fan-out)

## 📊 Tổng quan Truy vấn

Từ danh sách keyword gốc, hệ thống đã dùng Persona để phóng tác thành các câu hỏi hội thoại tự nhiên:

- **🔑 Tổng số truy vấn (Queries) sinh ra**: **{total}** truy vấn đa chiều
- *(Trích xuất 3-5 truy vấn tiêu biểu để hiển thị, ví dụ: "Tại sao công ty nên đầu tư dịch vụ SEO thay vì chạy Ads?")*

## 🔍 Mục đích 

Bộ truy vấn hội thoại này phản ánh chính xác cách người dùng sẽ hỏi các AI Search Engine (ChatGPT, Perplexity, Google AI Overviews). Dữ liệu này sẽ là xương sống để xây dựng cấu trúc bài viết (Heading) siêu cạnh tranh.

## 📁 Dữ liệu & Lưu trữ

- **Cơ sở dữ liệu Queries**: `.seo/data/harvested-queries.json`
- **Dấu thời gian**: {thời gian hoàn tất}

---

💡 **Bước tiếp theo (Next Step):**
Hãy chạy lệnh sau để gom cụm ngữ nghĩa:
👉 `/seo-research-clustering` (Vector Clustering)