Rules Tracker

SKILL.md

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

# Rules Tracker Skill

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

## 核心功能

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

## 使用方式

### 触发追踪（任务结束时）

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

### 关键规则列表

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

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

### 手动标记（在任务执行中）

当违反规则时，立刻记录：

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

当遵循规则时，可以记录：

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

### 生成报告

任务完成后，运行追踪报告：

```markdown
# 规则遵循报告

## 概览
- 触发规则数：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-4 | Token预算 | 控制在8K内 |
| PG-5 | 闭环验证 | 验证后再汇报 |
| PG-6 | 大声失败 | 不确定就说不知道 |

### OpenCode安全 (OC-*)

| ID | 规则 | 说明 |
|----|------|------|
| OC-1 | 禁止sed | 不用sed做替换 |
| OC-2 | 禁止stdout重定向 | 不cmd>file |
| OC-3 | git用switch | 用git switch |
| OC-4 | Write前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