Truto Operator 是 Truto 平台助手（Platform Assistant）使用的运维技能，用于在仪表盘内通过管理 API 检查并修改客户的实时 Truto 工作区。它是一组自适应排查手册，面向运维人员实际执行的工作：接收模糊报告、界定范围、在正确的层面（proxy、unified、sync、webhook 或 account）定位根因，并在复现原因后提出最小范围的安全变更。
用途
该技能用于处理客户报告的模糊问题，例如“Salesforce 不工作”“同步坏了”“数据丢失”“连接中断”，需要先界定范围再行动。也用于特定层面失败时的根因分析：/proxy/… 错误、/unified/… 错误或数据错误、同步任务失败或卡住、Webhook 未送达、账户失效。此外还覆盖 MCP 工具调用报错或无返回、调查结束后需要修改配置/映射/账户、以及客户要求新建或扩展同步任务等场景。
主要能力
技能提供多个排查手册：P0 分诊与范围界定，将模糊报告转化为层面、范围和症状并路由；P1 安全的管理变更，定义写入路径、读写分类、范围选择和最小差异原则；P2 调试代理 API 错误；P3 调试统一 API 与映射问题；P4 调试同步任务；P5 调试 Webhook 送达；P6 诊断集成账户；P7 创建或生成同步任务；P8 调试 MCP 工具调用。此外还有错误与证据模型文档，说明 truto_is_remote_error、truto_error_insight 键、状态码语义、速率限制、重试规则和日志映射。
使用方式
所有步骤通过管理元工具完成，包括 list_api_operations、describe_api_operation、call_platform_api、query_tool_result、get_capabilities、read_platform_resource。不确定参数或请求体结构时，应使用 describe_api_operation 查询实时契约，而非猜测。call_platform_api 支持 fields 参数添加响应字段，支持 jsonata 内联投影或过滤结果。大响应（约 16k 字符以上）返回 handle_id，需用 query_tool_result 读取。读取已安装的集成和连接应使用 GET /environment-integration 或 GET /integrated-account，而非全局目录 GET /integration。
适用场景
适用于 Truto 平台助手在仪表盘内进行运维排查和变更。不适用于编写客户应用代码（应使用 truto 技能）、运行终端命令（应使用 truto-cli）、从供应商文档创建新集成（应使用 truto-integrations-build）或嵌入连接 UI（应使用 truto-link-sdk）。workflow、daemon-job 和 batch-job 层面目前没有 v1 排查手册。
限制
读操作立即执行无需审批；敏感读（路径含 token、secret、OAuth、环境变量等段）需要审批且不会被记住；写操作和破坏性操作需要用户审批；受限接口（/assistant、/auth、/link-token、/session-token、/magic-link）被直接阻止，任何审批都无法运行。安全写入可被记住（重复相同调用时自动批准），但敏感读、DELETE 和批量删除永不记住。审批卡片仅显示方法、路径和类型徽章，不显示请求体或差异，因此需要在对话中说明具体变更内容。技能强调基于证据分支、充分即停、不凭惯性写入，并要求在提出变更前先阅读相关文档。