agent-self-governance

Agent Self-Governance 是一套专为自主AI代理设计的自我治理与风险防护框架，通过五大核心协议解决AI在长期运行中的常见失效模式。该技能基于数据库级别的可靠性理念构建，完全依赖Python标准库实现，确保零外部依赖和完全的本地数据主权。

核心用法涵盖五个互补协议：WAL（Write-Ahead Log）要求代理在响应前先写入关键记忆，支持会话恢复和上下文持久化；VBR（Verify Before Reporting）强制在声明任务完成前执行实际验证命令，消除幻觉导致的虚假完成；ADL（Anti-Divergence Limit）监控并防止代理人格漂移，检测过度谄媚或被动行为；VFM（Value-For-Money）追踪token消耗与任务价值的比率，防止预算浪费；IKL（Infrastructure Knowledge Logging）确保基础设施发现立即持久化，防止"我会记住"的反模式。

显著优点在于其架构的简洁性与安全性。所有数据存储于本地~/clawd/memory/目录，无网络传输风险；纯标准库实现消除了供应链攻击面；WAL的预写机制确保关键决策在响应前已持久化，有效防止上下文截断导致的失忆；VBR的验证闭环消除了AI幻觉导致的虚假完成声明；ADL通过量化评分机制主动维护人格一致性。

潜在缺点主要源于其T3来源属性与功能边界。作为个人开发者作品，缺乏企业级维护背书；VBR协议虽设30秒超时，但仍使用shell=True执行外部命令，需严格管控输入源；纯本地存储设计虽保障隐私，却阻碍了多设备状态同步；JSON日志缺乏损坏容错机制，异常文件可能导致读取失败。

适合目标群体包括构建长期运行AI代理的开发者、需要高可靠性自动化工作流的运维团队、以及关注AI成本效益的极客用户。特别适用于对话窗口有限但需保持长期上下文、或需要严格行为一致性的专业场景。

使用风险方面，需警惕VBR验证命令的注入风险，务必确保传入命令来自可信源；本地存储依赖用户自行备份，磁盘损坏将导致历史记录永久丢失；ADL的漂移检测依赖规则匹配，可能产生误判；此外，该框架缺乏分布式锁机制，不适合多并发代理同时写入同一WAL文件的场景。