外勤管理助手

它解决什么问题

外勤团队的状态常散落在飞书注册、管理员审批、提交量、复核结果和最新任务里。这个技能把 field-agent-ai 后端的成员与进度查询接入 Agent 回答，让管理者不必反复打开后台或导出表格，就能确认谁可以开展外勤、谁还待批准、提交了多少记录，以及最新任务进展。

技能如何工作

• 账号入口是飞书 Bot 注册：成员发送 /register name 或 注册 name，管理员批准后，查询才认可该成员。
• 查询脚本从运行时读取 AGENT_API_TOKEN。生产环境要在 Web 管理页创建 Skill Operator，并立即复制仅显示一次的 token；需要跨升级保留时，写入用户级配置，环境变量优先级更高。
• 查询结果包含成员账号状态、外勤记录总数、结果状态计数、复核状态计数和最新外勤记录。
• 结果解释：active 表示已批准且有效；pending 表示已通过飞书注册但仍需管理员批准；rejected 表示不能提交有效外勤记录。need_review 或 low_confidence 说明需要人工复核。
• 管理员通过审批或拒绝端点处理注册。向人回答时，用运营语言总结成员是否有效、提交数、最新任务/结果/下一步，以及是否有待复核记录。

适用边界与注意点

• 适合已有 field-agent-ai 后端、飞书注册流程和管理员审批流程的团队；它查询状态，不负责生成记录或绕过审批。
• 仅当部署域名变化，如本地开发或预发迁移，才覆盖 FIELD_AGENT_API_BASE_URL；只有边缘防火墙要求特定 User-Agent 时，才设置 FIELD_AGENT_USER_AGENT。
• 本地开发若没有全局 AGENT_API_TOKEN 且没有有效 Skill Operator，后端允许未认证访问；生产环境必须创建至少一个有效 Skill Operator 或设置全局 token。
• 不要向回答对象暴露原始 token 或内部请求头。