Evidence Anchor

标准化定义和验收项目证据锚点，确保长期记忆可验证、可追溯、可复用，支持多层级证据及定期复核流程。

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：识别证据类型

text

判断证据属于：
- Level 1（直接证据）
- Level 2（间接证据）
- Level 3（引用证据）

Step 2：验证证据有效性

text

检查：
- 路径/URL 是否真实存在
- 内容是否与所述匹配
- 日期是否在合理范围内
- 是否有篡改/过期风险

Step 3：判断证据支撑力

text

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

Step 4：写入记忆

text

按标准格式写入：
- 证据类型
- 证据路径
- 验证方式
- 证据结论

Step 5：定期复核

text

建议每 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 验证通过