docs(agents): 区分应用运行凭据与 Agent 操作账号
避免排障时把管理账号写进应用配置,操作账号只从本工程授权来源按需读取。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
0f7115205d
commit
245b8c9a81
2 files changed
+17
No files matched your search
@@ -37,3 +37,19 @@
|
||||
|
||||
- **WHEN** 提交涉及 Web 或小程序界面的 PR
|
||||
- **THEN** PR 或关联 OpenSpec SHALL 声明遵循的 UI 规范文档路径
|
||||
|
||||
### Requirement: 运行凭据与 Agent 操作凭据分离
|
||||
|
||||
应用运行凭据 SHALL 继续由对应应用的 `.env`、配置文件或部署环境注入管理,包括数据库、Redis、MinIO、业务微信接口及应用签名或加密密钥。现有 `backend/.env`、`backend/.env.production`、`deploy/docker/.env` 等来源按实际环境使用,不为统一账号保存位置而迁移或复制其中的值。
|
||||
|
||||
工程根目录 `.local/secrets/access.json` SHALL 仅用于 Agent 操作账号,如服务器 SSH、GitHub/Gitea 仓库管理及 Figma 平台访问;它不是应用运行配置源,不接入业务代码或容器启动配置。可用的 MCP、OAuth、CLI 会话继续复用,不为填文件重复索要密码。应用排障按需读取原运行配置,不使用平台管理账号替换应用身份。
|
||||
|
||||
Agent 使用操作账号前 SHALL 核对当前工程、服务用途、环境和任务授权,只读取所需字段;服务器测试与生产账号分开。该文件不纳入 Git、镜像、交付包或更新器,目录权限为 `700`、文件为 `600`(macOS/Linux);不得在聊天、日志或工单回显真实值。worktree 缺文件时仅核对并复用同仓库主工作目录的已授权来源,不能跨工程搜集或自动回退生产。
|
||||
|
||||
#### Scenario: 应用数据库认证失败
|
||||
- **WHEN** 后端连接数据库失败,而操作账号文件中有其他管理账号
|
||||
- **THEN** 核对后端实际加载的环境配置及其账号,不把管理账号写入运行配置,也不改为读取操作账号文件。
|
||||
|
||||
#### Scenario: Agent 访问仓库或设计平台
|
||||
- **WHEN** 已授权任务需要 Gitea、GitHub 或 Figma 身份认证
|
||||
- **THEN** 优先复用可用工具会话;需要账号时从本工程操作账号来源按需读取,仅缺失或无效时补充,不改动应用运行配置。
|
||||
Reference in new issue
Block a user