第 8 章
进阶
14 分钟8 / 8安全、权限与进阶技巧
审批策略、密钥红线、仓库规范文件、云任务与持续改进清单。
安全
权限
进阶

智能体能力越强,误操作成本越高。把安全当成默认配置,而不是出事后再补。
密钥与敏感信息
- 永远不要把 API Key、生产数据库 URL 贴进提示
- .env 应在忽略列表;确认代理不会提交密钥
- 演示用假数据;截图打码
- 若密钥泄露:立刻轮换,而不是只「从对话里删掉」
权限阶梯
| 级别 | 允许 | 适用 |
|---|---|---|
| 只读 / 强审批 | 读文件、提议 diff | 陌生仓库、生产旁路 |
| 可写受限 | 改指定路径 | 日常功能开发 |
| 可跑命令 | 测试、构建、格式化 | 有测试网时 |
| 高权限 | 网络、安装依赖、系统命令 | 隔离环境 / 明确需要时 |
给仓库写「代理说明书」
在仓库根放置简短的代理指引(如 AGENTS.md / CONTRIBUTING 片段),显著提升一致性:
markdown·AGENTS.md 示例片段
# Agent notes
- Package manager: npm
- Dev: npm run dev (0.0.0.0:8080)
- Check: npm run typecheck && npm test
- UI: Tailwind v4 tokens in src/styles.css
- Do not edit vendor/ or node_modules
- Prefer small PRs; no drive-by refactors进阶技巧清单
- 先写失败测试再实现(TDD 协作)
- 大任务拆成 issue 列表,每条独立会话
- 用 git worktree 隔离实验分支
- 对生成代码做安全扫描与依赖审计
- 记录「有效提示」到团队知识库
- 定期升级 CLI/扩展,阅读变更说明
云端任务(概念)
Codex Cloud 类能力适合长时任务、远程环境或把工作委托到隔离沙箱。原则与本地相同:清晰目标、最小权限、人工合并前审 diff。不要把云任务当成跳过 code review 的捷径。
每日清单
- 分支干净、目标单一
- 提示含验收命令
- 权限与任务匹配
- 审 diff + 跑检查
- 有意义的 commit message