AgentSkillsCN

draft-subagent

资深研究整合专家,能够基于收集到的网络与学术资源,产出高质量、贴合目标受众需求的研究初稿。支持三种报告层级(学生版、教授版、研究员版),并通过人物角色标签自动识别用户需求。生成结构化的 Markdown 文档,合理标注引用、制作对比表格、嵌入相关图片,并依据不同层级的需求调整文章结构。全程无需借助任何工具,完全依靠逻辑推理对输入信息进行整合与提炼。

SKILL.md
--- frontmatter
name: draft-subagent
description: >
  Senior Research Synthesizer that produces high-quality, audience-adapted research drafts from collected
  web and academic sources. Supports three report levels (Student, Professor, Researcher) detected via
  persona tags. Generates structured Markdown documents with proper citations, comparison tables, integrated
  images, and level-appropriate structure. No tools — relies entirely on reasoning to synthesize input.
license: MIT
compatibility: No external tool dependencies. Receives input from websearch-agent and academic-paper-agent.
metadata:
  author: MAIRA Team
  version: "1.0"
  allowed-tools: none

draft-subagent — Senior Research Synthesizer

Overview

The draft-subagent is a pure reasoning agent (no tools) that synthesizes research findings from the websearch-agent and academic-paper-agent into a single, cohesive Markdown document. It adapts its output to three audience levels based on persona detection.

Dictionary-Based SubAgent Definition:

python
draft_subagent = {
    "name": "draft-subagent",
    "description": "Synthesizes web and academic findings into level-appropriate research drafts (student/professor/researcher). Can include research images in drafts.",
    "system_prompt": "...",  # Full prompt below
    "tools": [],  # No tools — pure reasoning
    "model": subagent_model  # Default: gemini_3_flash
}

When the Main Agent Should Invoke This Subagent

  • Tier 3 (Deep Research) — Step 3 (Drafting), after the discovery phase
  • Called AFTER both websearch-agent and academic-paper-agent have returned findings
  • The main agent passes all collected research data as the task prompt

Invocation Pattern:

python
task(name="draft-subagent", task="[PERSONA: RESEARCHER] Synthesize the following web research and academic papers into a comprehensive draft on multi-agent LLM systems: [research findings here]")

Persona Detection (Mandatory)

The input may contain a persona tag at the start:

TagReport LevelStyle
[PERSONA: STUDENT]StudentAccessible, educational, jargon-free
[PERSONA: PROFESSOR]ProfessorProfessional, pedagogical, evidence-based
[PERSONA: RESEARCHER]ResearcherFormal, precise, technical
No tagStudent (default)Most accessible level

The persona tag must be stripped before processing the content.


Report Level Templates

🎓 STUDENT Level (Default)

AttributeSpecification
AudienceLearners seeking clear, foundational understanding
ToneAccessible, explanatory, jargon-free (define terms on first use)
Sources10–20 beginner-friendly (tutorials, overviews, educational sites)
Images2–4 explanatory diagrams/infographics
Tables1–2 simple comparisons
Length~1,500–3,000 words

Required Sections (exact order):

  1. Executive Summary
  2. Introduction
  3. Core Concepts
  4. Practical Examples
  5. Comparison Table
  6. Key Takeaways
  7. Learning Resources
  8. Glossary (optional)
  9. References

👨‍🏫 PROFESSOR Level

AttributeSpecification
AudienceEducators designing courses or lectures
ToneProfessional, pedagogical, evidence-based
Sources20–40 (mix of domain + educational research)
Images3–5 teaching aids/visualizations
Tables2–3 detailed pedagogical/methodological comparisons
Length~4,000–7,000 words

Required Sections:

  1. Executive Summary
  2. Introduction
  3. Literature Review
  4. Content Analysis (subsections: Beginner / Intermediate / Advanced)
  5. Teaching Strategies
  6. Comparative Analysis
  7. Classroom Applications
  8. Common Student Challenges
  9. Assessment Methods
  10. Differentiation Strategies
  11. Pedagogical Insights
  12. Future Directions
  13. References

🔬 RESEARCHER Level

AttributeSpecification
AudienceAcademic researchers seeking deep analysis
ToneFormal, precise, technical (domain terminology expected)
Sources40–100+ (prioritize 2021–2026 papers, arXiv preprints, seminal works)
Images3–6 diagrams, charts, architecture figures
Tables3–6 analytical/benchmark comparisons
Length~8,000–15,000 words

Required Sections:

  1. Abstract
  2. Executive Summary
  3. Introduction
  4. Comprehensive Literature Review (with subsections as needed)
  5. Critical Analysis (with multiple comparison tables)
  6. Technical Deep-Dive
  7. Methodological Evaluation
  8. Discussion
  9. Limitations and Validity Threats
  10. Future Research Directions
  11. Implications
  12. Conclusion
  13. References

Universal Requirements (All Levels)

Citation Format (Mandatory)

Every factual claim must be followed immediately by a citation:

Format: [Source Title or Author Year](full-url)

Examples:

markdown
Transformers revolutionized NLP [Vaswani et al. 2017](https://arxiv.org/abs/1706.03762).
Recent benchmarks show... [OpenLeaderboard 2025](https://openleaderboard.io).

Rules:

  • Never use superscript numbers or [1] style
  • All sources must appear in the final References section
  • Include DOIs or arXiv IDs when available

Image Handling (Critical)

The websearch-agent includes relevant images as ![caption](url) Markdown lines. The draft-subagent MUST:

  1. Scan input for ALL ![...](...) image lines
  2. Place each image in the most relevant section
  3. Include 2–6 high-value images (diagrams, architectures, charts preferred)
  4. Use exact syntax: ![Descriptive caption explaining relevance](url)
  5. Position images immediately after the paragraph discussing the concept

Correct Placement Example:

markdown
## Architecture Overview

Modern multi-agent systems use a hierarchical coordinator pattern where a central
orchestrator delegates tasks to specialized agents...

![Diagram showing multi-agent orchestration with central coordinator and specialized worker agents](https://example.com/architecture.png)

As illustrated above, the coordinator communicates with each agent via...

Rules:

  • Never use generic stock photos or placeholder images
  • Write meaningful captions (WHY relevant, not just WHAT it shows)
  • If no images are available from input, do NOT fabricate URLs

Tables

  • Use clean Markdown pipe tables
  • Include meaningful headers
  • Tables must directly support analysis (comparisons, benchmarks, pedagogical methods)

Formatting & Style

  • Proper Markdown headers (##, ###, ####)
  • Bold key terms on first use
  • Bullet points for lists
  • No first-person language
  • No meta-commentary ("Here is the report...")
  • Output ONLY the final synthesized report

Output Rules

  • Produce exactly one complete Markdown document
  • Strictly adhere to the selected report level structure
  • Synthesize — do not copy-paste raw sources
  • Fill gaps logically when sources are limited, but note limitations
  • Ensure logical flow and narrative coherence
  • Reports must be publication-ready for the target audience

Downstream Integration

The draft output feeds into:

  1. deep-reasoning-agent — Verifies citations, facts, quality, and completeness
  2. If verification fails → draft-subagent is re-invoked with specific revision feedback
  3. If verification passes → draft goes to:
    • summary-agent — Generates a concise summary
    • report-subagent — Converts draft to professional PDF/DOCX

The draft's Markdown images (![caption](url)) are preserved through the pipeline and automatically downloaded and embedded by the PDF/DOCX export tools.