write-operations.md 2.7 KB

写操作工具(mcp__gateway__fwhops__*)

只在勾选了 fwhops 服务的配置中提供。每次调用都会弹出审批卡片,由用户确认后才执行;被拒绝时停止该操作,按用户给出的原因调整,不要换个方式绕过。

工具以服务账号身份执行,业务系统中记录的操作人是“AI 助手”,不是当前用户。

工具 用途 规则
feedback_create 在 Plane 创建问题反馈 / 需求 调用前先向用户摘要标题、类型(bug / feature)、优先级和描述;描述中写清背景、复现步骤或期望效果
tou_template_save 新增或更新测试服 TOU 模版 只支持测试服;先按 tou-template.md 的规则构建并自检(时段覆盖整天、日类型成对、数值类型正确),向用户摘要“新增/更新、模版名、地区、策略与关键时段”,保存后用 mcp__gateway__fwh__tou_template_get(env=test)回读核对
site_info_refresh 触发站点信息表从 FWH 平台重新同步 见下方“站点信息同步”

站点信息同步

同步在主服务后台执行,耗时可能超过 1.5 小时;site_info_refresh 立即返回,不等同步完成。

  1. 先查状态:调用只读工具 mcp__gateway__fwh__site_info_sync_status(无需审批),按 state 处理:
    • syncing:同步进行中,不要触发,告诉用户已进行多久,之后再用本工具查看;
    • stale:超过 6 小时未完成,疑似中断(如主服务重启)。向用户说明情况,用户确认后才用 force=true 重新触发;
    • idle 且最近一次成功同步在 24 小时内(advice 会说明):数据较新,告诉用户数据截至 lastSuccess.completedAt,一般无需同步;用户坚持要最新数据时用 force=true;
    • idle 且超过 24 小时、上次失败,或 never:可以触发。
  2. 再触发:调用 site_info_refresh。工具会再次检查状态,按返回的 action 回复:triggered(已触发)、tracking(同步中,未重复触发)、skipped_fresh / skipped_stale(未触发,原因见 message)。
  3. 跟踪:触发后告诉用户同步需要较长时间、完成后 site_search 才会更新;用户之后询问进度时用 site_info_sync_status 查看,不要在一轮对话中反复轮询。

通用规则:

  1. 调用前在回复中说明将要写入什么、写到哪个环境,再调用工具(审批卡片会同时显示参数)。
  2. 写操作失败时把错误原样告诉用户,不要自动重试。
  3. 没有这些工具时,告诉用户当前配置不支持修改数据,可以到 ToolBox 对应页面操作。