Evidence Anchor

SKILL.md

# evidence-anchor Skill

**版本：** v1.0  
**创建日期：** 2026-04-26  
**来源：** Agent 记忆补强两层方法论验证  

---

## 用途

标准化定义和验收"证据锚点"，确保长期记忆不是"口头记忆"，而是可验证、可回溯、可复用的资产。

---

## 适用场景

- 项目记忆需要沉淀证据
- 结果闭环型记忆写入
- 跨 agent 交接时需要统一证据口径
- 定期复盘时需要验证历史结论

---

## 证据分级

### Level 1：直接证据（最强）

**定义：** 可直接验证项目状态/结果的原始证据。

**示例：**
| 类型 | 示例 |
|------|------|
| 线上验证 | `https://example.com/` 返回 200 OK |
| 文件路径 | `/opt/xxx/app/current/index.html` |
| 配置路径 | `/etc/nginx/conf.d/xxx.conf` |
| Commit hash | `abc123def` |
| CI 日志 | `GitHub Actions Run #456` |
| 部署时间戳 | `YYYY-MM-DD HH:MM TZ` |
| 签署文件 | `projects/xxx-contract-signed.pdf` |
| 银行流水 | `bank-statement-YYYY-MM.pdf` |

**验收标准：**
- 路径/URL 可直接访问或查验
- 时间戳精确到日（最好到时分）
- 文件真实存在且内容匹配

---

### Level 2：间接证据（中等）

**定义：** 可佐证项目进展，但不能直接证明结果的证据。

**示例：**
| 类型 | 示例 |
|------|------|
| 设计文档 | `projects/xxx-design.md` |
| 会议纪要 | `meetings/2026-04-16-xxx.md` |
| 方案草稿 | `projects/xxx-plan-v0.md` |
| 工作卡 | `xxx-work-card.md` |
| 基线文件 | `xxx.baseline.js` |

**验收标准：**
- 文档真实存在
- 内容与所述项目相关
- 有明确创建/修改日期

**使用限制：**
- 不能单独支撑 DONE 状态
- 可支撑 PARTIAL 状态（设计已完成，实施未启动）

---

### Level 3：引用证据（最弱）

**定义：** 对他人陈述/记忆的引用，不能独立验证。

**示例：**
| 类型 | 示例 |
|------|------|
| 记忆引用 | `memory/2026-04-16.md` 中的记录 |
| 口头确认 | "用户说已经完成了" |
| 二手转述 | "听某某说部署好了" |

**验收标准：**
- 引用路径明确
- 原始来源可追溯

**使用限制：**
- 不能单独作为项目状态证据
- 仅可作为辅助佐证
- 优先追 Level 1/2 证据

---

## 证据锚点定义规范

### 标准格式

每条证据锚点应包含：

```markdown
- **证据类型**：[线上验证/文件路径/配置路径/日志记录/签署文件/其他]
- **证据路径**：[具体路径或 URL]
- **验证方式**：[如何查验该证据]
- **证据结论**：[该证据支撑什么结论]
```

### 示例

#### 示例 1：官网修复证据（脱敏版）
```markdown
- **证据类型**：线上验证 + 文件路径
- **证据路径**：
  - `https://example.com/` 返回 200 OK
  - `/opt/xxx/app/current/index.html`
  - `/etc/nginx/conf.d/xxx.conf`
- **验证方式**：
  - curl 线上 URL
  - SSH 登录服务器查看文件
  - readback Nginx 配置
- **证据结论**：官网主链路已恢复，Nginx 配置已修复
```

#### 示例 2：部署项目证据（脱敏版）
```markdown
- **证据类型**：文件路径 + 健康检查
- **证据路径**：
  - `/opt/xxx/docker-compose.yml`
  - `/health` 端点返回 200
- **验证方式**：
  - SSH 查看部署文件
  - curl https://example.com/health
- **证据结论**：部署骨架已落地，健康检查可用
```

#### 示例 3：融资项目证据（脱敏版）
```markdown
- **证据类型**：文档路径 + 许可记录
- **证据路径**：
  - `projects/xxx-finance.md`
  - 许可记录（YYYY-MM-DD 取得）
- **验证方式**：
  - 读取项目文档
  - 查验许可编号/官方记录
- **证据结论**：融资方案已形成，许可已落地，银行贷款未见落地证据
```

---

## 证据验收流程

### Step 1：识别证据类型
```
判断证据属于：
- Level 1（直接证据）
- Level 2（间接证据）
- Level 3（引用证据）
```

### Step 2：验证证据有效性
```
检查：
- 路径/URL 是否真实存在
- 内容是否与所述匹配
- 日期是否在合理范围内
- 是否有篡改/过期风险
```

### Step 3：判断证据支撑力
```
对照状态判断：
- DONE：需要 Level 1 证据支撑关键阶段
- PARTIAL：Level 1 + Level 2 混合
- BLOCKED：只有 Level 2/3 或无证据
```

### Step 4：写入记忆
```
按标准格式写入：
- 证据类型
- 证据路径
- 验证方式
- 证据结论
```

### Step 5：定期复核
```
建议每 1-3 个月复核：
- 线上 URL 是否仍可达
- 文件是否仍存在于路径
- 配置是否仍生效
- 是否有新证据可补充
```

---

## 证据与状态映射

| 项目状态 | 必需证据 | 可选证据 |
|----------|----------|----------|
| **DONE** | Level 1 证据支撑所有关键阶段 | Level 2 辅助说明设计/背景 |
| **PARTIAL** | Level 1 证据支撑已落地阶段 + Level 2 说明未落地阶段 | Level 3 引用记忆 |
| **BLOCKED** | Level 2 证明任务已接收 + Level 3 说明阻塞原因 | - |

---

## 常见陷阱

### 陷阱 1：只有文档没有实施证据
**表现：** 只有 `xxx-plan.md`，没有部署/签署/上线证据

**解法：** 明确标注"设计已完成，实施未启动"，状态最多报 PARTIAL

### 陷阱 2：证据路径模糊
**表现：** "服务器上有"、"应该部署了"

**解法：** 强制要求具体路径，如 `/opt/xxx/app/current`

### 陷阱 3：用 Level 3 撑 DONE
**表现：** 只有"听某某说完成了"，没有 Level 1 证据

**解法：** 降级为 PARTIAL/BLOCKED，直到拿到 Level 1 证据

### 陷阱 4：证据过期未更新
**表现：** URL 已 404、文件已删除、配置已覆盖

**解法：** 定期复核，证据失效时同步更新记忆状态

---

## 证据锚点模板

### 模板 1：线上服务证据
```markdown
- **证据类型**：线上验证
- **证据路径**：`https://[domain]/[path]`
- **验证方式**：curl / browser 访问
- **预期结果**：返回 [状态码] / 显示 [内容]
- **证据结论**：[支撑什么结论]
```

### 模板 2：服务器文件证据
```markdown
- **证据类型**：文件路径
- **证据路径**：`/path/to/file`
- **验证方式**：SSH 登录 + cat/ls
- **预期结果**：文件存在，内容包含 [关键信息]
- **证据结论**：[支撑什么结论]
```

### 模板 3：配置证据
```markdown
- **证据类型**：配置路径
- **证据路径**：`/path/to/config.conf`
- **验证方式**：readback 配置文件
- **预期结果**：配置包含 [关键规则]
- **证据结论**：[支撑什么结论]
```

### 模板 4：日志证据
```markdown
- **证据类型**：日志记录
- **证据路径**：`memory/YYYY-MM-DD.md` 或 `logs/xxx.log`
- **验证方式**：读取日志文件
- **预期结果**：日志包含 [关键事件/时间戳]
- **证据结论**：[支撑什么结论]
```

---

## 相关 Skill

- `memory-backfill` - 记忆补强标准化流程
- `result-closure-memory` - 结果闭环型记忆写入规范
- `taskflow` - 任务流管理

---

## 维护者

- 创建者：小强（qiang）
- 创建日期：2026-04-26
- 来源项目：Agent 记忆补强两层方法论验证

---

## 变更日志

| 版本 | 日期 | 变更内容 |
|------|------|----------|
| v1.0 | 2026-04-26 | 初始版本，基于 4 位 agent 验证通过 |