AgentSkillsCN

contact-discovery-from-documents

当智能体需要为特定领域或系统查找具体的联系信息或负责人时，此技能会遍历可用文档（PDF、配置文件、邮件），以定位相关的联系详情、组织架构图或职责分配。它能解析结构化的文档以提取联系人表格，搜索基于角色的关键字，并提取与特定职责相关的邮箱地址与姓名。触发条件包括“查找联系人”、“负责人”、“团队成员”、“谁负责”、“邮箱地址”、“联系信息”、“PDF分析”、“文档搜索”、“基于角色的查询”。

SKILL.md
--- frontmatter
name: contact-discovery-from-documents
description: When the agent needs to find specific contact information or responsible personnel for a particular domain or system. This skill searches through available documents (PDFs, config files, emails) to locate relevant contact details, organizational charts, or responsibility assignments. It can parse structured documents for contact tables, search for role-based keywords, and extract email addresses and names associated with specific responsibilities. Triggers include 'find contact', 'responsible person', 'team member', 'who manages', 'email address', 'contact information', 'PDF analysis', 'document search', 'role-based lookup'.

Skill: Contact Discovery from Documents

Purpose

Find contact information (names, emails, roles) for specific responsibilities by searching and analyzing available documents, emails, and configuration files.

Core Workflow

  1. •Understand the Search Target: Clarify the role, responsibility, or system you need a contact for (e.g., "cluster management," "network administrator," "billing department").
  2. •Search Across Available Sources:
    • •Emails: Use emails-search_emails with relevant keywords (role, system name, department).
    • •Filesystem: Use filesystem-search_files and filesystem-list_directory to locate documents (PDFs, text files, configs) in common workspace areas.
    • •PDFs: For PDF files, use pdf-tools-read_pdf_pages to extract and analyze text, especially looking for structured sections like contact tables or responsibility matrices.
    • •Config Files: Read relevant configuration files (YAML, JSON, text) that may contain admin or contact metadata.
  3. •Analyze and Extract: Parse the found content. Look for:
    • •Name-Email-Role patterns (e.g., "Stephen Mitchell - stephen_mitchell@mcp.com - Kubernetes cluster").
    • •Section headers like "Contact", "Support Team", "Responsibilities".
    • •Keywords adjacent to email addresses.
  4. •Verify and Use: Confirm the extracted contact is the most relevant match for the requested responsibility before using it (e.g., sending an email).

Key Techniques from Trajectory

  • •Role-Based Keyword Search: Start with broad role searches ("cluster management", "cluster admin", "infrastructure", "kubernetes").
  • •Document Discovery: If emails are empty, explore the filesystem (/workspace/dumps/workspace) for organizational documents (guidelines, configs).
  • •PDF Table Parsing: The skill successfully parsed a multi-page PDF (CS Lab Management Guidelines.pdf), identified a "Lab Support Team" table on page 3, and extracted the specific contact ("Stephen Mitchell") matching the "Cluster & Computing Resources" responsibility.
  • •Fallback Patterns: When direct email searches fail, proceed to document search and analysis.

Output

The primary output is a verified contact (name and email address) for the requested responsibility, ready to be used in subsequent actions (e.g., composing and sending a notification email).