doctor-bill-ops

Doctor Bill Ops

1. 调用边界

• 执行身份是 super_bill，品牌是贝尔 / Doctor Bill。
• 本 Skill 不能绕过主 Skill 的需求批准、风险确认、分支、独立测试和用户验收。
• 生产部署、权限提升、迁移、重启、回滚和修改用户级系统文件前必须说明影响并得到授权。
• 主 Skill「小改动快速通道」不适用于本领域：部署脚本、CI workflow、systemd 单元、健康检查和回滚逻辑的任何改动都必须走完整流程和独立验证。

2. 运维前检查

先检查并记录：

• OS、发行版、架构、用户、shell、时区和时间同步。
• sudo 权限、systemd 版本、user manager 和 linger。
• 项目目录、所有者、磁盘、端口、防火墙和反向代理。
• Git 分支、remote、工作树、部署用户和 SSH 配置。
• Python/uv/Node/Docker、数据库、Redis 和外部依赖。
• 如环境提供经批准的 SSH MCP，可用于连接服务器，但仍遵守主机校验、最小权限和生产授权。
• 当前服务、日志、健康接口、备份和回滚能力。

禁止：

• 未授权读取生产 .env、私钥和 secrets。
• 默认关闭 SSH host key、TLS 或防火墙验证。
• 覆盖服务器脏工作树。
• 将数据库迁移默认等同于安全操作。

3. systemd 选择

有 sudo

可安装 system service：

/etc/systemd/system/<service>.service
sudo systemctl daemon-reload
sudo systemctl enable --now <service>.service

无 sudo

优先 user service：

~/.config/systemd/user/<service>.service
systemctl --user daemon-reload
systemctl --user enable --now <service>.service

必须检查 user manager 和 linger：

loginctl show-user "$USER" -p Linger
systemctl --user status

如果退出登录后仍需运行，需要 linger。当前用户不能自行启用时，明确告诉用户由管理员执行：

sudo loginctl enable-linger <user>

禁止绕过权限或谎称 linger 已开启。

4. systemd 单元要求

模板见本 Skill 的 assets/systemd/，使用前必须替换占位符并按项目验证。

至少配置和说明：

• Description
• After / Wants
• User/Group（system service）
• WorkingDirectory
• EnvironmentFile
• ExecStart
• ExecReload（确有支持时）
• Restart
• RestartSec
• TimeoutStartSec
• TimeoutStopSec
• KillSignal
• StartLimitIntervalSec
• StartLimitBurst
• WantedBy

规则：

• ExecStart 使用绝对路径。
• EnvironmentFile 权限最小化，不把 secrets 写进 unit。
• user service 使用 WantedBy=default.target；system service 通常使用 multi-user.target。
• restart 阈值按应用启动时间和故障模式配置，不能无限快速重启。
• 服务必须正确处理 SIGTERM、停止接收、等待任务和关闭资源。

5. 启停、日志和健康检查

部署后至少执行：

systemctl [--user] status <service> --no-pager
journalctl [--user] -u <service> -n 200 --no-pager
curl --fail --show-error --max-time <seconds> <health-url>

健康检查区分：

• liveness：进程是否存活。
• readiness：数据库、Redis、关键依赖是否达到接流条件。