1871 字 7 分钟阅读
Agentic Coding 之运维指南
可直接复制作为运维仓库的
AGENTS.md模板使用。
运维 Agent 仓库
本文件为运维 Agent 仓库的设定指南,提供初始化、管理和运维的参考流程,帮助用户在遵循安全和权限要求的前提下高效管理运维任务。
仓库参考设计如下:
example/
├── README.md # 唯一总导航
├── AGENTS.md # 操作与授权规则
├── HOST.yaml # 主机登记和等级信息
├── secrets/ # 存放敏感信息和凭证,600 权限,补充 env 文件
├── history/ # 历史操作记录和归档,每一次操作都完整记录入内
│ ├── ops-20260101-001/
│ ├── ops-20260101-002/
│ └── ...
├── docs/ # 公共文档、协作资料、经验和历史资料
目录说明:
README.md:仓库总导航,提供整体说明和使用指南。AGENTS.md:定义和管理各类 Agent 的权限、操作规范和使用说明。HOST.yaml:记录主机的登记信息和等级。history/:存放历史操作记录和归档,每一次操作都完整记录,记录内容要包括执行过程到哪一步以及相关结果。docs/:存放公共文档、协作资料、经验和历史资料。
仓库 AGENTS.md
在仓库的根目录下,应存在 AGENTS.md 文件,用于定义和管理仓库中各类 Agent 的权限、操作规范和使用说明。该文件是运维 Agent 执行操作的重要依据,确保所有操作符合安全和权限要求。
原则底线
借助本仓库,做好一个高级工程师应尽的职责,负责本机与远程调查、配置、自动化开发和发布。共同原则遵循 AGENTS.md,本文件规定运维操作流程。
运维实施应遵循最小权限原则。对于可能产生重大风险的操作,需提前说明后果并取得用户确认。
实施方案要确保安全、可控、可回滚,并在执行前获得用户批准,对于对系统造成严重破坏的操作,必须向用户进行 question 双次确认。
在权限上,要求:
- 私密文件绝对禁止:不允许读取
*.pem、*.key、任意层级id_rsa/id_ed25519及secrets/** - 不允许破坏性操作:执行关机、重启、停机断电等破坏性指令,也不允许指定 mkfs、dd 等磁盘初始化、格式化的破坏性操作
- 危险命令模式禁止:递归执行、fork 炸弹、递归强删根目录或根下内容、切到根目录后删除、递归
chmod 000、递归chown根目录等危险操作
授权与主机等级
Local 指当前机器或仓库,按用户请求和项目约定操作,不使用主机等级。
Remote 指远程服务器目标,通常采用 ssh 进行连接,是较为常见的情况,分为 Low 和 High 两个等级,具体区别如下
| 等级 | 说明 | 只读侦查 | 写入变更 | 删除操作 |
|---|---|---|---|---|
| Low | 允许在任务范围内自主操作的普通运维环境 | 允许 | 允许 | 允许,但需用户授权,详见下方 |
| High | 用户或项目指定的重要环境,变更前需要确认。 | 允许 | 允许,但需用户授权 | 允许,但需用户批准,详见下方 |
等级登记在仓库下 HOSTS.yaml 文件中,记录每台主机的等级和相关信息,新建文件后可搜索仓库引入历史主机记录。
目标明确的只读连接、调查和验证均无需额外确认。DNS、数据库、重启等操作不会自动改变主机等级,但调查中需要修改系统时仍按写入处理。
对于 High 主机来说,任何写入变更都必须经过用户确认,且在执行前明确方案、影响和恢复办法,未经确认不得擅自操作,且即便用户允许,也不应执行破坏性质操作,仅可提供操作建议/指令和风险警告。
需要确认的情况
对于 High 目标而言,任何有歧义、执行中需扩大授权,或发现系统破坏、重要数据不可逆损失、管理连接失效等重大风险时,先说明具体后果,再取得用户确认方可考虑执行。
删除操作界定为两种:
- D0:批准后可删除的内容。
- D1:即使授权也不得删除的内容,即使用户明确批准也不予执行或展示删除方法,比如系统目录/分区/内核/引导、数据库 drop、批量关键数据、跨租户删除、绕过审计等。
对于 Low 主机 / Local 而言,删除在获得用户批准后即可执行,对于 High 主机而言,在获得用户许可后,需明确删除范围、影响和有无恢复方案,并在执行前再次取得用户确认后给出删除指令,不代为执行删除操作。
连接与主机管理
先确认机器、账户和执行位置,区分客户端、宿主与容器。优先沿用项目主机清单和 SSH 配置,名称冲突或无法唯一定位时询问,不试连猜测。
批量操作先明确目标集合。主机和跳板都要核实身份与信任,不通过关闭校验或删除冲突记录接受未知、变化的密钥。
| 操作 | 要求 |
|---|---|
| 添加主机 | 提供公钥、服务器指纹及来源、主机等级。说明登记位置,按授权完成接入,验证成功后登记。 |
| 删除登记 | 仅删除指定条目,不顺带撤销远端权限或清理共享 SSH 配置。 |
| 检查配置 | 说明检查的是本地配置还是实际连接,不把前者当作后者的证明。 |
| 测试连接 | 验证实际认证和远端身份。指定公钥时须证明使用该公钥,不能用旧连接复用代替。 |
使用环境已有的认证方式,不因失败擅自更换目标、身份或降低校验。网络采集的指纹不能自行证明服务器可信。
登记只保存必要信息,不进入公开配置归档。写前检查冲突,部分失败时说明哪些已完成,不把连接成功说成登记成功。
数据与凭证
删除前核对具体对象、递归范围及影响,不能把含糊的“清理”当作任意删除许可。
需要用户提供凭证时,将创建 600 文件,要求用户在终端自行填入,提前准备好凭证内容文件,等待用户填入,而非让用户创建。
运维和实施
在处理问题的过程中遵循:
调查-讨论循环直到明确问题和用户需求,调查充足,提高对话效率,减少对话轮次。- 形成方案,并向用户说明方案内容,寻求用户批准。
- 严格按照已批准的方案执行操作,确保安全、可控、可回滚,并在执行过程中持续与用户保持沟通。
- 方案实施后进行简短总结汇报。
本仓库不记录任何源码,运维不建立任何源码仓库,如有脚本存储、源码建设需求,可在对应现场建立,并保留 README.md 说明用途和内容。
绝不在本仓库内新建任何源码仓库,避免与远程现场出现分叉情况。
历史归档
所有操作记录应完整归档至 history/ 目录下,按任务归属登记入内,一个任务对应一个ops-xxx编号。
历史归档内容作为参考资料,但参考时一定要连接到对应现场做只读侦查,不以历史为唯一事实依据。