技术实践

腾讯云TDSQL团队精简编码Harness指令与角色

智能体系统上下文与知识上下文工程Agent 动作执行与治理Agent Harness智能体互操作协议MCP

概述

腾讯云 TDSQL 团队对部门的 harness 框架 tdsql-harness 做了一轮彻底 refactor:根指令删掉 61%,skills 砍掉 40%,agent 从 10 个减到 6 个,根指令剩余 6,400 字符。删除判据为可直接逐行执行的问句——「一个没有本次会话记忆的 agent 读到这一行,行为会怎么变?答不出来就删」,据此必然出局的三类是元评论(「这里以前出过 bug」「这条规则是因为某某才加的」等不含动作、且会主动削弱边界强制力的内容)、自我辩护(解释本 skill 存在理由、写给人看的句子)与防御性否定(为澄清而写的否定句会把被否定的概念引入上下文)。 目录结构、架构概览、技术栈描述等可通过读代码发现的内容也一并删除,理由是避免制造第二个事实来源。保留下来的四类内容是:什么算做完(成功判据与验收)、哪里必须停下来找人(gate 与升级条件)、状态放在哪(跨 session 恢复的约定)、什么不能自己做(不可逆动作的授权边界)。表达层面,团队只把 MUST/NEVER 类绝对措辞留给真正的不变量——commit、push、MR 合入、deploy、workspace 之外的删除,并规定 subagent 永久不得执行其中任何一项,其余全部改写为判据。 验收强调机械可判定(测试变绿、产物存在、diff 为空、命令 exit 0)。L2 层则通过 MCP 工具、封装脚本与固化操作流程,让 Agent 获得查询工作项、触发流水线、登录测试集群拉日志、把评审意见处理完再回写状态的操作能力。