docs(agents): 完善自动化开发流程与验证证据规范

[xuwei-fit2cloud]

变更

补齐 AI 自动化开发规范中缺少的任务开始、验收证据和交付边界，避免将环境错误当作修复成功、为通过测试削弱守卫或覆盖用户已有改动。

• 根指引增加分支/SHA、工作区保护、按需查证、自主决策和交付标准；明确外部内容不是扩大操作范围的授权。
• 测试文档区分默认离线测试与显式集成验收，要求修复前后证据、合法操作对照、数据库结果核验、失败基线比较和临时资源清理。
• 安全文档要求权限参数缺失时拒绝、从服务端推导子资源归属，纠正 FileResponse/basename 可以保证下载安全的误导性表述。
• 纠正文档中的 dotenv 回退、xpack 配置优先级与共享环境影响、Docker 依赖冻结范围；领域待确认清单只按任务需要查证。

规范描述的是应满足的要求，不宣称已有实现已全部满足。仅修改 6 份文档，不修改业务代码或工作流。

验证

• 独立 worktree，基于 main 4d5950c0，复用现有 Python 3.11 环境并显式指定本 worktree 的 backend 导入路径。
• 从 backend 运行完整 pytest：216 passed，0 skipped，保留 85 条既有依赖弃用警告。
• 文档中明确的仓库文件引用、代码块配对及 git diff --check 通过。
• 未构建镜像或启动完整运行栈。

[ulleo]

在原提交基础上追加了几个修改，说明如下：

1. 证据规则去重（2d3f942f）

• 「任务流程与交付」7 条收敛为 4 条：Bug 复现、基线对照、证据分层的规则主体只保留在 docs/agents/testing.md（经"执行验证"触发链每次任务都会加载），根文件留一行指针，避免两处措辞漂移
• 两处 SHA 核对合并为一条；「规范维护」段删去与全局硬规则末条重复的"同步维护文档"句
• xpack.md 联调命令块补按键值解析一行命令（sed | tr 取值，不 source 执行文件内容，兼容引号值，环境变量优先），并加空值熔断——原块删掉 sourcing 后 $SQLBOT_XPACK_REPO 不再自包含
• 主仓库侧补 AGENTS.local.env 键契约（仅两键、不 source、未知键报错），与 xpack 仓库的契约对称

2. xpack 侧 env 文件边界（8021b7f0）

• 明确 xpack 仓库的 AGENTS.local.env（SQLBOT_MAIN_REPO）只在直接从 xpack 仓库发起工作时需要；从本仓库发起联调不必创建它

3. 发布顺序补 lock 语义（20693fde）

• 「主仓库更新版本范围并重新验证」细化为「更新后 uv sync 重锁本机 lock 并安装新 wheel 再验证」——否则验证可能仍跑在旧 wheel 上（联调习惯 --no-sync 时尤其容易踩）

另外两项评审意见的处理结果：「必测场景按入口选择 + 说明未覆盖风险」维持本 PR 原版（已确认）；xpack 版本提升策略已按发布链重写并在 xpack 仓库 PR 中同步。

[ulleo]

补充一处措辞修正（24a86337）：「新增测试约定」中关于外部依赖的表述改为先说明允许、再说明边界——单元/守卫测试保持离线可重复；确实需要真实 LLM、外部数据库或互联网的用例，按「集成与产品验收」规范编写并单独显式运行，不进入默认收集。避免把「默认离线」误读为整体禁止。