当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
运维安全规范。当用户执行系统级命令(sysctl、iptables、systemctl、Docker 配置、数据库 DDL) 或进行服务器运维操作时触发。包含命令风险说明模板、回滚方案要求、问题排查原则、Docker/Cloudflare/数据库场景规则等。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
防止因不完整的操作导致系统故障。
在给出任何系统级命令(sysctl、firewalld、iptables、systemctl 等)之前,必须先说明:
| 项目 | 说明 |
|---|---|
| 影响范围 | 这个命令会影响什么(网络、Docker、服务等) |
| 风险等级 | 高/中/低 |
| 回滚方案 | 完整的回滚步骤,包括所有依赖服务的重启 |
| 需要重启的服务 | 明确列出 |
回滚方案必须包含以下步骤,缺一不可:
| 步骤 | 说明 | 示例 |
|---|---|---|
| 1. 恢复配置 | 删除或还原配置文件 | rm -f /etc/sysctl.d/99-xxx.conf |
| 2. 重载配置 | 重新加载系统配置 | sysctl --system |
| 3. 重启服务 | 重启所有受影响的服务 | systemctl restart docker |
| 4. 恢复应用 | 重启依赖的应用 | docker-compose up -d |
| 5. 验证恢复 | 确认服务正常 | curl -I http://127.0.0.1:80 |
如果 A 配置导致问题:
修改以下配置后,必须提示重启 Docker:
执行以下操作前必须提示备份:
| 禁止 | 说明 |
|---|---|
| ❌ 问题未解决时改其他配置 | 不要扩散问题 |
| ❌ 不完整的回滚方案 | 必须包含服务重启步骤 |
| ❌ 无风险说明的系统命令 | 必须先说明再执行 |
| ❌ 未经确认执行高风险命令 | 必须等用户确认 |
| ❌ 同时修改多个配置 | 一次一个,验证后再下一个 |
| 等级 | 定义 | 示例 |
|---|---|---|
| 高 | 可能导致服务中断、数据丢失 | 内核参数、防火墙、数据库DDL |
| 中 | 可能影响部分功能 | 应用配置、环境变量 |
| 低 | 影响范围小,易回滚 | 日志级别、非核心配置 |
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Bash 脚本与系统命令规范。禁止行尾注释,强制使用 tee/heredoc 写入,提升命令执行的可维护性。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.