AgentSkillsCN

point-of-interest-finder

当用户需要在给定位置附近寻找特定的商家或服务，并设置距离限制时，该技能会：1）在指定半径内按类别（如咖啡馆、餐厅）搜索商家；2）根据与目标位置的接近程度对结果进行排序；3）获取商家的详细信息，包括名称、地址、评分及营业时间；4）依据“离[地点]最近”等特定条件对结果进行筛选。触发条件包括“查找最近的[业态]”“在[地点]附近寻找[服务]”或当用户需要在行程中加入特定的停靠点时。

SKILL.md
--- frontmatter
name: point-of-interest-finder
description: When the user needs to locate specific businesses or services near a given location with proximity constraints. This skill handles 1) Searching for businesses by category (e.g., coffee shops, restaurants) within specified radii, 2) Ranking results by proximity to target location, 3) Retrieving detailed business information including names, addresses, ratings, and operating hours, 4) Filtering results based on specific criteria like 'closest to [location]'. Triggers include requests for 'find nearest [business type]', 'locate [service] near [location]', or when users need to incorporate specific stops into their itineraries.

Instructions

Your goal is to find a specific point of interest (POI) for the user, typically to incorporate into a larger plan. Follow this process.

1. Clarify the Search Parameters

First, understand the user's exact request. Identify:

  • •Target POI Type: What is the user looking for? (e.g., "Starbucks", "coffee shop", "pharmacy").
  • •Anchor Location: The specific place the POI must be near. This is often part of a larger journey (e.g., "near the Nihonbashi Exit of Tokyo Station").
  • •Proximity Constraint: The user's priority, usually "closest" or "most convenient".
  • •Use Case Context: How will this POI fit into the user's plan? (e.g., "buy a coffee before departure").

Do not proceed until these four parameters are clear, either from the user's request or by asking for clarification.

2. Geocode the Anchor Location

Use the google_map-maps_geocode tool to get the precise coordinates (lat, lng) and formatted address of the Anchor Location. This is critical for an accurate search.

  • •Input: The address or name of the anchor location as specified by the user.
  • •Output: Save the location object (containing lat and lng) for the next step.

3. Search for POIs

Use the google_map-maps_search_places tool to find candidates.

  • •query: Combine the Target POI Type and the Anchor Location (e.g., "Starbucks near Tokyo Station Nihonbashi Exit").
  • •location: Use the location object obtained in Step 2.
  • •radius: Start with a small radius (e.g., 500 meters). If results are insufficient, you may increase it incrementally.

4. Analyze and Rank Results

Examine the returned list of places. Your primary ranking factor is proximity to the Anchor Location.

  1. •Identify the result whose name or address most closely matches the user's Proximity Constraint (e.g., "closest to the Nihonbashi Entrance").
  2. •If multiple candidates seem equally close, you may consider secondary factors like rating or check the formatted_address for clearer location hints (e.g., "...Nihombashi Entrance..." in the name).
  3. •Select the single best candidate. Its place_id is needed for the next step.

5. Retrieve Detailed Information

Use the google_map-maps_place_details tool with the selected candidate's place_id.

  • •This provides the definitive, detailed information to present to the user: name, formatted_address, formatted_phone_number, website, rating, reviews, and opening_hours.

6. Integrate and Present Findings

Present your final recommendation clearly:

  1. •State the recommended POI by its official name.
  2. •Provide its precise formatted_address.
  3. •Justify your choice based on the user's Proximity Constraint (e.g., "This is the Starbucks located at the Nihonbashi entrance, making it the most convenient").
  4. •Include relevant details like operating hours if they are pertinent to the user's plan.

Remember: This skill is a component of a larger task. Your output should be the identified POI information, ready to be slotted into the user's broader plan (e.g., a travel itinerary).