메뉴
shelken/home-ops 项目的目录结构与资源组织规范。在涉及该项目的文件放置、模块拆分、资源归属判断时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when 部署/更新 VPS 或 sakamoto
Kubernetes 事故取证流程。Use when 服务离线但没告警、升级后异常、K8s 应用/入口/备份链路失败、Gatus/Prometheus/Alertmanager 异常、Envoy Gateway 403/GeoIP/RBAC 异常、audit log 追溯手动操作、router-dns-proxy 延迟/失败、外部访问抖动，或需要统一时间线定位故障断点。
在 home-ops 仓库中为 k3s 集群新增服务的完整流程：设计→创建代码→提交审查→部署观测。按 Flux GitOps 双层结构（infra.yml 与 apps.yml）组织文件与依赖。使用当用户要求部署新应用、添加新服务、补齐 app 目录资源时。
在 containers 仓库创建无后端轻量前端应用，并串起 home-ops GitOps 部署流程。Use when 用户要求创建简单应用、轻量前端服务、小工具、展示页、SPA、simple-service，或提到“复制模板到 apps 并部署”。
从 home-ops 的 Docker Compose 服务补齐 Gatus outside 健康检查，并选择轻量、可从集群内验证的探测方式。Use when 用户要求对比 compose 与 Gatus、补充 outside endpoints、检查集群外 VPS/sakamoto 服务监控、或调整 Gatus health check 轻量化。
当用户提到审核 PR、review PR、检查开放 PR、判断升级能否合并时使用。逐个读取 PR 信息与首个评论，提炼亮点更新和破坏更新，对照当前仓库/集群配置判断是否需要同步变更，并给出简洁结论与代码引用。
| name | home-ops-conventions |
| description | shelken/home-ops 项目的目录结构与资源组织规范。在涉及该项目的文件放置、模块拆分、资源归属判断时使用。 |
谁负责干这件事，相关文件就放谁那里。
不看文件是什么类型，不看文件依赖哪个技术栈。只看这个文件是为谁服务的。
例：zte-mifi-healer 负责恢复外网连通性，它的告警规则就放在 zte-mifi-healer/app/ 里，不管这条规则在技术上属于 Prometheus 还是 Gatus。
每个 app 固定两层：
<app-name>/
├── ks.yaml # Flux 入口，被上层管理
└── app/ # 该 app 的所有资源
├── kustomization.yaml
├── helmrelease.yaml
├── externalsecret.yaml
└── ...