Comment Fetcher

待回复留言查询

⚠️ 数据平面已脚本化：本 Skill 的 MCP 调用执行入口已切换为 skills/comment-context-fetcher/scripts/fetch_payload.py（直连 oapi HTTP，大 JSON 落盘不经过 LLM），Agent 不再加载本 Skill 执行 MCP 调用。本文档的接口协议、参数契约（size=30、start_time=当前 Unix 秒 - 2592000 等）仍为权威定义，脚本按其实现。

🔑 执行前置（Token 全局缓存优先，对齐 invoice-expert 约定）：fetch_payload.py 读写全局缓存 ~/.workbuddy/.gongyi_token（跨专家共享，token 内含 _prod_/_test_ 环境段天然隔离测试/正式环境）——不传 --token 时脚本自动读缓存，有就直接用、不用每次调 get_mcp_token；本地不判断过期时间，过期以接口鉴权失败为准。脚本打印 {"need_refresh": true, ...}（退出码 3 无缓存 / 4 鉴权失败已自动清缓存）时，调用 MCP 工具 get_mcp_token（携带 caller_expert_id="comment-assistant"，一次调用完成，禁止先无参调用再重试）获取新 token，以 --token 重跑（脚本同步写回缓存）。token 不打印。详见 agents/comment-assistant.md Step 0。

概述

本 Skill 负责查询机构 3.0 平台的待回复留言列表，是留言回复流程的第一步。

核心功能：

• 调用 MCP get_org_upreplied_comments 查询未回复留言
• 返回分页数据（总数、高风险数、留言列表）
• 支持时间范围、项目 ID 筛选

关键约束：

• MCP Token 自动注入 org_no，无需额外鉴权（指直连 MCP 通道；脚本化路径必须显式传 --token，见顶部执行前置）
• 固定传 size=30（单次查询固定一页 30 条；MCP 工具已支持 size 透传）
• 固定传 start_time = 当前 Unix 秒 - 2592000（产品要求只查询 30 天及之内的数据；服务端不传时默认 30 天前，但调用方必须显式传，避免依赖默认值）
• 查询失败时返回空列表，不阻断流程

触发场景

Agent 在 Phase 1（查询待回复留言）时加载本 Skill。

输入格式

{
  "page": 0,
  "size": 30,
  "filter_start_time": 0,
  "filter_end_time": 0,
  "filter_project_id": "",
  "mock_org_no": "",
  "start_time": 0
}

工作流程

1. 参数校验：校验 page/size 范围，size 固定 30，最大 100
2. 计算时间范围：start_time = 当前 Unix 秒 - 2592000（30 天前），每次调用实时计算
3. 调用 MCP：调用 get_org_upreplied_comments，入参原样透传（含 start_time）
4. 返回结果：返回原始 total / risk_total / OrgCommentItem[]，全字段透传不裁剪、不做加工

输出格式

{
  "total": 36,
  "risk_total": 2,
  "list": [
    {
      "comment_id": 123456789,
      "subject_id": "subj_001",
      "content": "钱都去哪了？一直没看到进展更新，是不是骗人的？",
      "object_type": "project",
      "object_id": "224328",
      "project_id": "224328",
      "project_name": "春蕾计划她们想上学",
      "status": 1,
      "nick_name": "爱心网友A",
      "head_img": "https://.../avatar.png",
      "like_num": 3,
      "created_at": 1756000000,
      "can_reply": true,
      "is_recommended": false,
      "reply_list": [],
      "audit_type": 2,
      "risk_audit_status": 4,
      "risk_audit_reason": "质疑资金去向",
      "risk_audit_at": 1756000050,
      "comment_type": 0
    }
  ]
}

OrgCommentItem 关键字段（完整字段见参考文档）：

异常处理

依赖

• MCP Server: gongyi-open-mcp
• MCP Tool: get_org_upreplied_comments

参考文档

• get_org_upreplied_comments.md