diff --git a/xiaoqu-agent-service/AGENTS.md b/xiaoqu-agent-service/AGENTS.md
index 4033162..f469d00 100644
--- a/xiaoqu-agent-service/AGENTS.md
+++ b/xiaoqu-agent-service/AGENTS.md
@@ -28,6 +28,11 @@
 ## 生产部署要点
 
 - `./deploy/deploy.sh remote-deploy`（SSH 别名 xiaoqu-prd，目录 /data/xiaoqu-agent-service）。
+- **测试环境（2026-11-07 王恒拍板：先在测试环境测，不直接动线上数据）**：本机即测试环境，
+  `./deploy/test-up.sh [--skip-build]` 一键构建/重启/刷 scope 绑定（dev profile，localhost:8088，
+  数据走内网 192.168.1.181 的 `*_d` dev 库，与生产隔离）。冒烟一律先在测试环境跑：
+  签 Token 用 `scopeCode=test`（「测试专用」scope，seed-dev.sql 已把所有 kind=write 工具绑到它），
+  验证通过后再走 remote-deploy 上生产；生产只留必要的只读核验，不做改派/作废类写冒烟。
 - **部署前必须先把 main 推 origin**：出现过本地 main 领先 origin 1 个修复提交、他人从 origin 构建部署导致生产跑到旧代码的情况（2026-09-22 paperuselog terms 结构 400）。
 - 新工具上线后必须幂等绑 prod scope（svc 库 MySQL，tool 表唯一标识列是 `name`；scope 表是 `agent_scope`）：**2026-11-07 起王恒新口径——所有工具默认绑研发专用 scope 6（code=code），现有 71 个工具已全部补绑；其他作用域不说明不分配**（此前惯例：hardware/district 系列绑 1/2/3/5，warehouse 系列绑 1/2/5）。
 - prod AK 的 Authorization 头值本身已含 "Bearer " 前缀，不要再拼。
diff --git a/xiaoqu-agent-service/sql/seed-dev.sql b/xiaoqu-agent-service/sql/seed-dev.sql
index d7bd610..d24efa2 100644
--- a/xiaoqu-agent-service/sql/seed-dev.sql
+++ b/xiaoqu-agent-service/sql/seed-dev.sql
@@ -100,6 +100,13 @@ SELECT s.id, t.id, 0 FROM agent_scope s JOIN tool t
 WHERE s.id = 1 AND t.name = 'agent.user.list.query'
   AND NOT EXISTS (SELECT 1 FROM scope_tool st WHERE st.scope_id = s.id AND st.tool_id = t.id);
 
+-- 写工具（kind=write）：dev 只绑「测试专用」(code='test')，对应 prod 口径"研发专用 scope"，
+-- 冒烟在测试环境用 code='test' 签用户 Token 即可。
+INSERT INTO scope_tool (scope_id, tool_id, create_id)
+SELECT s.id, t.id, 0 FROM agent_scope s JOIN tool t
+WHERE s.code = 'test' AND t.kind = 'write'
+  AND NOT EXISTS (SELECT 1 FROM scope_tool st WHERE st.scope_id = s.id AND st.tool_id = t.id);
+
 COMMIT;
 
 -- 校验