用途
Agent Runtime Governance 用于设计和审计带工具智能体系统的运行时控制,目标是让这类系统保持可预测、可观测且可安全运营。其治理范围覆盖使用工具、记忆、审批、子智能体、评估或外部系统的智能体。
该技能明确不适用于以下场景:通用漏洞扫描(应使用 security-scanner)、常规代码审查(应使用 review)、纯提示词优化(应使用 prompt-engineer)、MCP 实现细节(应使用 mcp-creator)。
主要能力
技能通过调度表提供多种治理模式:
- 空参数:显示治理模式及所需输入。
- design <system>:为新建或变更中的智能体系统定义运行时策略。
- audit <path-or-system>:审查现有的工具、审批、记忆、遥测和评估控制。
- permissions <agent-or-tools>:设计允许列表、拒绝列表、审批模式和升级规则。
- memory <agent-or-system>:定义记忆范围、保留、隐私和失效策略。
- evals <workflow>:规划回归、对抗和运行时验收评估循环。
- rollout <system>:定义分阶段发布、监控、回滚和操作员就绪控制。
- incident <failure-mode>:为智能体故障定义隔离和恢复控制。
- 自然语言描述:自动检测最接近的模式。
治理面包括:工具(哪些工具可读、写、花钱、部署、发消息或删除数据)、审批(哪些操作需要显式用户批准或人工审查)、记忆(可存储什么、存多久、范围多大)、状态(哪些是持久、可重放、幂等和可审计的)、遥测(哪些追踪、决策、工具调用和失败可观测)、评估(哪些场景可在发布前防止回归)、隔离(系统如何停止、回滚、隔离或安全降级)。
使用方式
技能采用渐进式披露:先阅读 SKILL.md 进行路由和控制面了解;设计或审计运行时控制面时阅读 references/control-matrix.md;涉及发布、回滚、监控或生产就绪时阅读 references/rollout-governance.md。除非路由重定向到其他技能,否则不加载安全、提示词或 MCP 实现相关参考。
工作流包括:定义智能体职责、用户、数据敏感性和外部影响;按能力清点工具(只读、写入、破坏性、财务、部署、消息、凭据访问、网络出口);将审批门映射到后果、可逆性和置信度;定义记忆范围、保留、脱敏和失效规则;要求对工具调用、决策、审批结果和失败进行遥测;围绕不安全工具使用、过期记忆、缺失审批和故障隔离构建评估;为影响真实用户、账户、凭据或外部系统的变更定义发布门、回滚标准和操作员证据;最终返回带负责人和执行点的治理矩阵。
输出格式为治理报告,包含系统、模式、风险层级、控制矩阵(面、当前、所需、执行、证据)、所需变更、评估与监控、发布与隔离等部分。
适用场景
适用于单个智能体或工作流、多个共享工具的智能体、平台级治理以及生产环境发布等不同规模场景。扩展策略为:单智能体或工作流产出一份控制矩阵和一套评估/监控;多智能体共享工具按工具后果和共享审批门分组;平台级治理先定义基线策略再按智能体类别设例外;生产发布增加分阶段发布、回滚、监控和负责人审查门。
限制
技能强调关键规则:在推荐自主性前按后果对工具分类;对不可逆、高成本、公开、凭据或破坏性操作要求显式审批;保持记忆范围狭窄并记录保留、脱敏和失效;要求对工具调用、审批、拒绝、失败和隔离操作进行遥测;为不安全工具使用、缺失审批、过期记忆和回滚行为添加评估;将策略与执行分离,指明执行每条规则的钩子、包装器、测试或运行时门;不替代 security-scanner、review、prompt-engineer 或 mcp-creator,超出运行时治理范围时路由到它们;没有发布、回滚和监控标准时不得将治理变更标记为就绪。
验证契约要求从技能目录运行 python scripts/check.py,完成标准为脚本退出码为 0、该技能目录下无 portable-CLI 违规、冒烟审查覆盖显式、隐式、发布和负控制提示。