基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/lukemcqueen/hermes-cortex --skill agent-collector-troubleshoot命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Cross-server agent health monitoring using binary status vectors — deploy health endpoints on each agent, poll from orchestrator, alert on state transitions.
Wire a self-hosted Langfuse instance to Hermes Agent — generate API keys, configure env vars, enable the bundled plugin, install SDK, and verify traces flow.
Use before enforcement code changes or shared-repo commits.
| name | agent-collector-troubleshoot |
| version | 1.0.0 |
| category | devops |
| description | Use when collectors can't send. Diagnoses bus, paths, crons. |
| platforms | ["linux","macos"] |
Run this checklist when agent-learning-collector --force produces no output,
no report appears in inbox_orchestrator, or the agent can't reach the orchestrator.
# Collector script
ls -la ~/.hermes-cortex/scripts/agent-learning-collector.py
python3 -m py_compile ~/.hermes-cortex/scripts/agent-learning-collector.py
# Session-mine
ls -la ~/.hermes/bin/session-mine
ls -la ~/.hermes-cortex/offline/session_mine.py
python3 -m py_compile ~/.hermes-cortex/offline/session_mine.py
If missing: bash ~/.hermes-cortex/scripts/cortex-update.sh
# Bus URL
grep -r "CORTEX_BUS_URL" ~/.hermes-cortex/cortex-bus.conf ~/hermes-cortex/.env 2>/dev/null
# Auth
grep -r "CORTEX_BUS_AUTH\|CORTEX_BASIC_AUTH" ~/.hermes-cortex/cortex-bus.conf 2>/dev/null
# Test
curl -sI "$(grep CORTEX_BUS_URL ~/.hermes-cortex/cortex-bus.conf 2>/dev/null | head -1 | cut -d= -f2)" | head -3
Required: HTTP 200 + auth creds. Missing = contact Moses.
hermes cron list | grep -E "agent-learning-collector|agent-session-mine"
Expected: Both exist, enabled: true. If missing, bash ~/.hermes-cortex/scripts/install-crons.sh.
Collector scans ~/brain/lessons/. Session-mine must write there.
grep "LESSONS" ~/.hermes-cortex/offline/session_mine.py
# Correct: HOME / "brain" / "lessons"
# Wrong: HOME / "brain" / "<hostname>" / "lessons"
If wrong: run cortex-update.sh to get the Jul 27 fix.
Make dirs:
mkdir -p ~/brain/lessons ~/brain/learnings/pending ~/brain/learnings/sent
python3 ~/.hermes-cortex/scripts/agent-learning-collector.py --dry-run # preview
python3 ~/.hermes-cortex/scripts/agent-learning-collector.py --force # send
Output: Sent: Learning Report: ... (msg_id=...). Silent = bus issue (Step 2).
mkdir -p ~/brain/learnings/pending
cat > ~/brain/learnings/pending/$(date +%Y%m%d)-test.md << 'EOF'
---
title: Pipeline test
type: discovery
---
Testing end-to-end. If received, pipeline is healthy.
EOF
python3 ~/.hermes-cortex/scripts/agent-learning-collector.py --force
Moves to ~/brain/learnings/sent/ after success.
cat ~/.hermes-cortex/state/agent-learning-collector-state.json
cat ~/.hermes-cortex/state/agent-session-mine-state.json
Expected: Valid JSON. If corrupt, delete and re-run.
python3 ~/.hermes-cortex/scripts/agent-session-mine-cron.py
cat ~/.hermes-cortex/state/agent-session-mine-state.json
# Should show: bootstrap_done: true
| Symptom | Cause | Fix |
|---|---|---|
--dry-run shows content, --force silent | No bus creds | Step 2 |
| Lesson count 0 | session_mine.py path | Step 4 |
session-mine: not found | Not deployed | cortex-update.sh |
| Collector silent | Already sent | Delete state, re-run |
| ModuleNotFoundError | PYTHONPATH | Export ~/.hermes-cortex/scripts |