AI 开发与验证交付
约 744 字大约 2 分钟
2026-10-16
平台开发以当前分支源码和仓库规则为事实来源。公开文档说明方法，具体环境和凭据由授权渠道提供。
让 AI 取得正确上下文
在平台主仓根目录打开开发工具，先读取根 AGENTS.md，再读取后端、前端或部署作用域规则。按任务使用仓内已有 Skills：
| 任务 | 应读取的入口 |
|---|---|
| Go API/RPC、数据库、任务和消息 | backend-dev |
| 平台 Web/mobile 页面 | web-frontend-skill |
| 调用平台 API 与业务联调 | ur-api 及其业务子专题 |
| 构建、发布、回滚和环境排障 | ur-deploy |
平台开发使用平台仓自己的技能；ur-kit 技能面向独立应用，不能替代平台模块约束。不必把整套内部技能正文复制到公开站点。
可以这样描述需求：
先阅读根 AGENTS 和本次模块规则，确认所属服务、接口及兼容影响。先复现问题或定义验收条件，再修改代码、生成物与必要文档；只执行受影响验证，报告真实结果。
选择验证范围
- 后端业务修改补对应集成测试，覆盖有效请求、无权身份、跨企业/项目及依赖失败。
- 数据模型检查空库、升级和重复迁移；并发逻辑检查重复消息、冲突和重启恢复。
- 前端优先运行相关测试及单个应用构建；登录、路由与项目切换变化做针对性浏览器验收。
- 合同变化检查生成稳定性、SDK 消费者和 apilegacy 的受影响协议。
从主仓根目录选择目标命令，例如：
bash shell/resource-guard.sh status
bash shell/resource-guard.sh run --profile heavy -- bash -c 'cd backend && go test ./things/service/dmsvr/internal/logic/projectmanage/...'
cd apps/web
pnpm run build --filter=iot全量构建、多应用、镜像及完整联调按仓库统一位置路由执行。共享开发机不自建第二套缓存，不为一次失败跨节点重复构建，不停止归属不明的进程。
发布准备
提交前检查 diff、生成物、业务文档与 Changeset，写明数据库、数据、配置、接口、部署和手工注意事项。通过功能分支与 MR 交付，记录已经运行的命令与结果。
远程发布前阅读目标环境说明，核实运行方式、版本、数据迁移与回滚条件。测试优先本机隔离环境；不使用历史测试环境地址作为通用教程默认值。
交付中分别说明代码、测试、MR、镜像和部署状态。模拟平台、真实平台、真实设备的验收分别记录，跳过不能写成通过。源码已经合并不代表工具已经正式发行，也不代表目标环境已经升级。
更新日志
2026/10/16 19:46
查看所有更新日志
b3b4d-docs(平台开发): 恢复有效专题并更新当前实现示例于badbc-docs(开发导航): 隔离平台与应用的翻页顺序于1a4a7-docs(开发指南): 重建平台与应用开发路线于