Rules Tracker

Other

追踪规则/准则/约束的触发、遵循与违反情况,用于量化弱模型对 AGENTS.md 中各项规则的执行质量。每完成一个任务后自动生成遵循率报告。适用于开发、学习、数据整理等任务的自我审查。

Install

openclaw skills install rules-tracker

Rules Tracker Skill

追踪你的规则遵循情况,生成执行报告。

核心功能

  1. 自动追踪:任务完成后记录每条规则的执行情况
  2. 遵循率统计:计算各规则组的遵循百分比
  3. 问题诊断:识别高频违反的规则,提供改进建议
  4. 历史回顾:累积数据,分析趋势

使用方式

触发追踪(任务结束时)

使用此 skill 追踪规则遵循情况。

关键规则列表

需要追踪的规则分为以下几组:

规则组包含规则权重
Hard Rules禁止假设、必须查证、标注推断、确认修改
编程准则最小改动、Token预算、先目标后动作
OpenCode安全禁止sed、git switch、上下文恢复
弱模型适配不确定就问、小步迭代、展示证据

手动标记(在任务执行中)

当违反规则时,立刻记录:

[规则违反] {规则ID}: {违反原因}
例如:[规则违反] HR-2: 没有查证就下结论

当遵循规则时,可以记录:

[规则遵循] {规则ID}: {说明}
例如:[规则遵循] GS-1: 已备份关键文件

生成报告

任务完成后,运行追踪报告:

# 规则遵循报告

## 概览
- 触发规则数:X
- 遵循次数:Y
- 违反次数:Z
- 遵循率:Y/(Y+Z)*100%

## 规则详情
| 规则ID | 规则名 | 触发 | 遵循 | 违反 | 遵循率 |
|--------|--------|------|------|------|--------|
| HR-1 | 禁止假设 | X | Y | Z | W% |

## 问题诊断
违反次数最多的规则:
1. {规则ID} - {次数}次
2. {规则ID} - {次数}次

## 改进建议
- 针对高频违反规则...

规则ID速查表

Hard Rules (HR-*)

ID规则说明
HR-1禁止假设不得凭空编造
HR-2必须查证信息不足先查证或询问
HR-3标注推断推断必须标注"[推断]"
HR-4确认修改依据不足先确认
HR-5勿忘备份关键文件先备份
HR-6诚实输出禁止伪造结果

编程准则 (PG-*)

ID规则说明
PG-1最小改动只改必须的
PG-2先目标后动作先写目标再执行
PG-3上下文恢复从上下文恢复
PG-4Token预算控制在8K内
PG-5闭环验证验证后再汇报
PG-6大声失败不确定就说不知道

OpenCode安全 (OC-*)

ID规则说明
OC-1禁止sed不用sed做替换
OC-2禁止stdout重定向不cmd>file
OC-3git用switch用git switch
OC-4Write前Read已存在文件先Read
OC-5逐文件审核改完立即自检

弱模型适配 (WM-*)

ID规则说明
WM-1不确定就问小事自主,大事问
WM-2每步确认复杂任务确认
WM-3小步迭代每次少改
WM-4展示证据给代码/文件证据

数据存储

追踪数据保存在:

  • memory/rules-tracker-{YYYY-MM-DD}.json

自动触发

可在以下时机自动生成报告:

  • 每天 heartbeat 时
  • 任务完成标志词时
  • 用户要求时

改进AGENTS.md的依据

通过追踪数据发现问题:

问题类型数据指标改进方向
高频违背违反次数TOP3简化或强化该规则
从未触发0触发可能是冗余删除或合并
矛盾规则两规则同时触发明确优先级
Token浪费规则6超8K调整预算

常见矛盾规则

矛盾说明
WM-1 vs WM-2"不确定就问"vs"每步确认" → 区分大小事
PG-2 vs PG-5"先目标后动作"vs"闭环验证" → 先确认目标再验证
  • 此 skill 不会被强制执行,需要你在执行任务���主动标记
  • 遵循率只是辅助指标,不是考核标准
  • 目的是帮助识别薄弱环节,持续改进 AGENTS.md