受控代理

为AI子代理提供确定性验证+信誉评分。通过在更新代理评分前独立验证其声明，防止幻觉式成功（我完成了！）。

纯Python标准库——零外部依赖。

能力

可生成外部CLI（codex、openclaw、git、pytest）并发送HTTP HEAD请求。

适用场景

在以下情况下使用此技能：

• - 生成子代理并自动验证其输出
• 跨任务评分代理可靠性（基于EMA的信誉）
• 检测幻觉式成功——代理声称完成但文件缺失或测试失败
• 通过LLM委员会验证开放式任务（研究、分析、策略）
• 基于代理历史记录强制执行监督级别

快速入门

编码任务（确定性验证）

python
from governed_agents.contract import TaskContract
from governed_agents.orchestrator import GovernedOrchestrator

contract = TaskContract(
objective=添加JWT认证端点,
acceptance_criteria=[POST /api/auth 返回JWT, 测试通过],
requiredfiles=[api/auth.py, tests/testauth.py],
runtests=pytest tests/testauth.py -v,
)

g = GovernedOrchestrator(contract, model=openai/gpt-5.2-codex)

代理完成后：

开放式任务（三层流水线 + LLM委员会）

python
contract = TaskContract(
objective=编写认证模块的架构决策记录,
acceptance_criteria=[记录了权衡, 陈述了决策],
verification_mode=council,
task_type=analysis,
council_size=3,
)

g = GovernedOrchestrator(contract, model=openai/gpt-5.2-codex)
prompts = g.generatecounciltasks(worker_output)
result = g.recordcouncilverdict(rawrevieweroutputs)

→ 委员会：2/3 批准（评分=0.67，通过 ✅）

CLI生成（Codex / OpenClaw）

python
from governedagents.openclawwrapper import spawn_governed

contract = TaskContract(
objective=构建待办事项REST API,
acceptance_criteria=[CRUD端点正常工作, 测试通过],
requiredfiles=[api.py, tests/testapi.py],
)

默认使用Codex 5.3 CLI

或通过OpenClaw代理CLI：

验证模式

确定性验证（编码任务）

自动运行4道关卡——必须全部通过：

如果代理声称成功但任何关卡失败 → 评分覆盖为 -1.0（幻觉惩罚）。

委员会验证（开放式任务）

三层流水线，带短路机制：

1. 1. 结构关卡（<1秒）——字数、必需章节、无空章节
2. 基础关卡（5–30秒）——URL可达性、引用检查
3. LLM委员会（30–120秒）——N个独立评审员，多数投票

如果第1层失败 → 不调用LLM，即时结果，零成本。

信誉系统

R(t+1) = (1 − α) · R(t) + α · s(t), α = 0.3

监督级别

任务类型配置

预配置的关卡组合：

安装

bash
bash install.sh

→ 将 governedagents/ 复制到 $OPENCLAWWORKSPACE/governed_agents/

→ 运行验证套件（37个测试）

测试

bash
python3 -m pytest governedagents/testverification.py \
governedagents/testcouncil.py \
governedagents/testprofiles.py -v

37 通过