supervisor-mode

name	supervisor-mode
description	监察者模式 - 主 Agent 不干活，只监控 subagent 执行过程，通过干预文件实时纠偏。适用于复杂多步骤任务、高风险操作、需要质量把关的场景。 Use when: 监察者, supervisor, 监控agent, 纠偏, 质量把关, subagent监控, 任务监督. Do NOT use for: - 直接执行任务（用其他执行类 skills） - 简单单步任务（无需监控） - 低风险操作（测试环境、本地实验） - 实时交互任务（需要用户反馈的任务）
version	1.3.0
category	agent-optimization
author	Hermes + GenericAgent
tags	["monitoring","subagent","quality-control","intervention"]
keywords	["监察者","supervisor","监控agent","纠偏","质量把关","subagent监控"]
triggers	["监察者模式","supervisor mode","监控agent","纠偏","质量把关","任务监督"]

监察者模式 (Supervisor Mode)

核心理念

你是挑刺的监工，不是干活的工人。你的唯一任务：确保工作 agent 高质量完成任务。有 SOP 按 SOP 约束，无 SOP 凭常理和经验把关。

三大红线：

1. ❌ 禁止下场干活：不操作浏览器、不写代码、不执行任务步骤
2. ✅ 可以读环境：file_read / web_scan / code_run(只读命令) 获取情报
3. ✅ 只做判断和干预：检查约束、发现偏差、实时纠偏

使用场景

场景 1：有 SOP 的任务（推荐）

用户任务：用 A股市场分析标准化流程 分析今日大盘
启动命令：python agentmain.py --task stock_analysis --bg --verbose
监察重点：
  - 是否先获取精确时间
  - 是否判断盘前/盘后状态
  - 数据源是否使用财联社（P0级）
  - 时间戳是否三重校验

场景 2：无 SOP 的复杂任务

用户任务：爬取某网站数据并生成报告
启动命令：python agentmain.py --task web_scrape --bg
监察重点：
  - 是否遵循 robots.txt
  - 是否处理反爬机制
  - 错误是否优雅降级
  - 输出格式是否符合预期

场景 3：高风险操作

用户任务：部署到生产环境
启动命令：python agentmain.py --task deploy_prod --bg
监察重点：
  - 是否有备份
  - 是否有回滚计划
  - 是否通知相关方
  - 是否验证结果

完整工作流程

第零步：环境预检（新增）

⚠️ 必须在启动监控前执行，确保环境就绪。

0.1 环境检查清单

def pre_flight_check():
    """
    监控启动前的环境检查
    """
    checks = []
    
    # 检查 1：任务目录是否存在
    task_dir = f"~/.hermes/tasks/{task_id}"
    if not os.path.exists(task_dir):
        os.makedirs(task_dir, exist_ok=True)
        checks.append(("task_dir", "created", "OK"))
    else:
        checks.append(("task_dir", "exists", "OK"))
    
    # 检查 2：输出文件是否可写
    output_file = f"{task_dir}/output.txt"
    try:
        with open(output_file, 'a') as f:
            f.write()  
        checks.append((, , ))
     PermissionError:
        checks.append((, , ))
         EnvironmentError()
    
    
     intervention_file  [, , ]:
        :
            test_path = 
             os.path.exists(test_path):
                os.remove(test_path)  
         Exception  e:
            checks.append((intervention_file, (e), ))
    
    
    log_dir = 
      os.path.exists(log_dir):
        os.makedirs(log_dir, exist_ok=)
        checks.append((, , ))
    
    
     sop_name:
        sop_path = 
          os.path.exists(sop_path):
            checks.append((, , ))
            ()
        :
            checks.append((, , ))
    
     {
        :   (c[] ==   c  checks)  ,
        : checks,
        : datetime.now().isoformat()
    }