AgentSkillsCN

tutordex-platform-ops

TutorDex 统一技能，涵盖本仓库中的各类任务——编码、调试、部署、生产/预发布环境管理、Docker Compose 使用、日志处理、冒烟测试、监控运维、Supabase/PostgREST/RPC 集成、Grafana/Prometheus/Alertmanager 配置、数据库迁移、故障应急响应等。

SKILL.md
--- frontmatter
name: tutordex-platform-ops
description: TutorDex umbrella skill for anything in this repo (coding, debugging, deploy, prod/staging, docker compose, logs, smoke tests, monitoring, Supabase/PostgREST/RPC, Grafana/Prometheus/Alertmanager, migrations, incidents).

TutorDex Platform Ops

Use this skill when asked to deploy, monitor, debug incidents, or operate TutorDex environments.

Safety rules (default)

  • •Prefer staging unless explicitly told prod.
  • •For prod changes, require a runbook + rollback path.
  • •Never print secrets; do not echo env files.
  • •Use the repo runbooks in scripts/ops/* instead of ad-hoc docker commands.

Environment selection

  • •Use --env staging or --env prod for all ops scripts.
  • •Prod scripts require --yes (or TD_YES=yes).

Canonical runbooks

  • •Status: scripts/ops/status.sh --env staging|prod
  • •Deploy: scripts/ops/deploy.sh --env staging|prod [--yes]
  • •Rollback: scripts/ops/rollback.sh --env staging|prod --to=<git-ref> [--yes]
  • •Restart service: scripts/ops/restart.sh --env staging|prod --service=<name> [--yes]
  • •Logs: scripts/ops/logs.sh --env staging|prod [service] [--since=...]
  • •Smoke tests: scripts/ops/smoke.sh --env staging|prod

Data access standard (Supabase)

  • •Do not attempt to drive Supabase Studio UI.
  • •Prefer whitelisted RPCs (agent gateway) over arbitrary SQL.