# Project Monitoring Boundary

> 项目监控边界规范 — 每个项目独立监控自己，跨项目数据流单独建入/出站监控

- Skill: `openclaw-cn-dev/project-monitoring-boundary` (Agent Skill)
- Install (CLI): `npx get-skill add openclaw-cn-dev/project-monitoring-boundary`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openclaw-cn-dev/project-monitoring-boundary/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: openclaw-cn-dev (https://skillmd.com/u/openclaw-cn-dev)
- Updated: 2026-11-14
- Page: https://skillmd.com/skills/openclaw-cn-dev/project-monitoring-boundary

---


# 项目监控边界规范（华哥 2026-06-15 明确要求）

## 核心原则

**每个项目独立监控自己。跨项目数据流单独建入站/出站监控。**

绝对禁止把"项目A → 项目B 的数据流"做成一个跨项目监控任务 —— 它既不是项目A的内部健康，也不是项目B的内部健康，问题定位时责任不清。

## 当前架构（2026-06-15）

| 监控对象 | Cron Job ID | 频率 | 负责内容 |
|---------|------------|------|---------|
| **FindEra 自身健康** | `35a45d2f7355` | */5 | research-backend 容器、中转站 pending、API、磁盘 |
| **RKR 知识库自身** | `1262b15958f4` | */15 | 容器、Celery、向量库、图谱、GBrain |
| **RKR 入站数据流** | `8290659f8b28` | */10 | 入站速率、failed、celery 队列、API Key 活跃度 |

**已禁用**：`15bfb50f1313` FindEra自动同步RKR知识库（2026-06-15 15:05 paused，跨项目混淆）

## 设计规则

### 每个 cron 任务的 prompt 必须明确写

1. **角色定位表** —— 三栏：监控对象/谁负责/不归你管
2. **检查清单** —— 只列自己项目范围内的检查项
3. **汇报规则** —— 明确"只汇报 X 的状态，绝不提及 Y"
4. **关键提醒** —— 明确"不要调 Y 的 API / 不要重启 Y 的容器"

### 数据流归属原则

- 推送方（数据出口）出问题 → 推方项目监控报警
- 接收方（数据入口）出问题 → 收方项目监控报警
- 数据流本身（速率/积压/失败）→ 在**收方入口**建监控（数据"已经推过来但没正常入库"是收方问题）

## 当前涉及跨项目数据流的两个项目

```
FindEra（推送方）
  ↓ X-API-Key 认证
  POST /api/v1/external/documents
  ↓
RKR 知识库（接收方）
```

- FindEra 自己的健康 → `35a45d2f7355`
- RKR 自己的健康 → `1262b15958f4`
- FindEra 推到 RKR 的数据流 → `8290659f8b28`（RKR 入口端）

## 验证清单（每次新加跨项目监控前）

- [ ] 这个任务名是否清晰表明它属于哪个项目？
- [ ] prompt 里是否明确"不归你管"的边界？
- [ ] 检查项是否只触碰自己项目的资产？
- [ ] 异常告警里是否只包含本项目指标？

