技能介绍

在开发本地生活或活动类 Agent 时，地点约束是绕不开的硬骨头。多数团队要面临两个现实：一是活动数据散落在不同接口，检索和详情往往分属两套体系；二是「创建活动」这种写入操作，对字段完整性、图片托管和鉴权方式的要求远高于普通查询。@user_c3d829cb/fore-act 要解决的问题很具体：在单次技能调用里，统一深圳地区的活动搜索、详情、行程查询与创建流程。

核心能力

该技能封装了四个 MCP 工具，覆盖活动的读写全链路。

search_activities：支持按关键词检索，排序策略会区分有无经纬度——有坐标时按距离升序，无坐标时按热度降序。
get_activity_detail：返回完整活动文档。注意它带有副作用：每次调用都会使 view_count 自增，Agent 不应在同一会话中对同一活动重复查询详情。
create_activity：创建活动，强制要求 X-API-Key 鉴权、封面 URL 以及解析后的坐标。系统自动填充 open=1 和 type="ai"。
list_activity_schedules：按活动 ID 返回行程列表，按 start_time 升序排列，不联表 guest。

关键工作流

技能区分两种创建模式，避免 Agent 在信息不全时盲目调用写入接口。

模式一（原子级交互）适用于单活动创建。Agent 会逐轮收集 API Key、封面、主题、地址，并自动调用 web_search 将地址解析为坐标。坐标确认后，再询问时间，最终在用户确认时只调用一次 create_activity。封面为必填项，若用户未提供图片或链接，技能会拒绝创建而非跳过。

模式二（批量创建）适用于「搜索近期大型活动并发布」这类请求。流程被设计为串行：先确认 Key，再搜索未来 30 天的活动候补（至少 3 个），为每个活动搜索封面和坐标，最后逐条顺序调用 create_activity。每完成一条都会输出进度，全部结束后给出汇总。

边界与注意点

坐标顺序：API 使用 GeoJSON 标准的 [lng, lat]（经度在前），与多数地图 SDK 的 [lat, lng] 相反，集成时需做转换。
封面必须可公网访问：后端会下载图片并转存到云存储，原 URL 不再保留。若下载失败，返回 errCode -3。
API Key 不缓存：每次创建都要重问用户，不存储、不复用，返回 403 即提示重新提供。
行程接口不联表：list_activity_schedules 只返回 guest_id，不含嘉宾昵称或头像，需要展示嘉宾信息时需另行查询用户表。
空行程属正常：新活动可能暂无行程，返回 [] 和 total: 0 时，应提示用户前往小程序查看，而非报错。