pbl_agent_runtime/skill/SKILL.md

pbl_agent_runtime 模块技能（自动生成骨架 + 人工补充）

定位

Designer/Critic Agent 运行时与 fail-closed 工具裁决（M4a/M4b）

挂载

from pbl_agent_runtime.init import load_pbl_agent_runtime → load_pbl_agent_runtime()（应用 app/pbls.py init() 中按序调用）

数据表（6 张）

• pbl_agent_def：Agent 定义（Designer/Critic）
• pbl_tool_registry：工具注册表（13 启用 / 9 禁用含 pbl.publish）
• pbl_agent_trace：Agent 执行轨迹（第28章 7 要素）
• pbl_agent_tool_call：工具调用明细（服务端裁决留痕）
• pbl_approval：人工审批单（14.2 四类，无绕过路径）
• pbl_llm_call_log：LLM 调用日志（超时/重试/限流/兜底留痕）

契约接口（10 个，路径 /pbl_agent_runtime/api/<name>.dspy）

• pbl_agent_designer_run
• pbl_agent_critic_run
• pbl_agent_trace_write
• pbl_agent_trace_list
• pbl_tool_registry_list
• pbl_tool_registry_save
• pbl_tool_adjudicate
• pbl_approval_create
• pbl_approval_decide
• pbl_approval_list

陷阱

• 库名一律 ServerEnv().get_module_dbname('pbl_agent_runtime')，禁止硬编码 DBNAME。
• sqlor 只有 C/U/D/R/I/sqlExe；查询走 pbl_common.api 的 q_all/q_one（已适配）。
• 所有读写强制带 tenant_id（pbl_common.api.tenant_id()），缺失即 fail-closed 报错。
• 新增契约需同步三处：api.py 定义 + init.py 导出 + init.py env 注册 + scripts/load_path.py 路径。