← 返回 Skills 市场
jiangwill2023

Evidence Anchor

作者 jiangwill2023 · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ✓ 安全检测通过
74
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install 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 证据

证据锚点定义规范

标准格式

每条证据锚点应包含:

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

示例

示例 1:官网修复证据(脱敏版)

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

示例 2:部署项目证据(脱敏版)

- **证据类型**:文件路径 + 健康检查
- **证据路径**:
  - `/opt/xxx/docker-compose.yml`
  - `/health` 端点返回 200
- **验证方式**:
  - SSH 查看部署文件
  - curl https://example.com/health
- **证据结论**:部署骨架已落地,健康检查可用

示例 3:融资项目证据(脱敏版)

- **证据类型**:文档路径 + 许可记录
- **证据路径**:
  - `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:线上服务证据

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

模板 2:服务器文件证据

- **证据类型**:文件路径
- **证据路径**:`/path/to/file`
- **验证方式**:SSH 登录 + cat/ls
- **预期结果**:文件存在,内容包含 [关键信息]
- **证据结论**:[支撑什么结论]

模板 3:配置证据

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

模板 4:日志证据

- **证据类型**:日志记录
- **证据路径**:`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 验证通过
安全使用建议
This skill is a documentation and verification template (benign and coherent), but before installing or using it: 1) Confirm where and how the agent will obtain SSH credentials, API keys, or file system access — do not place sensitive keys into an unreviewed environment. 2) Limit the agent's permissions (use least privilege) so it can verify only the systems/paths you expect. 3) Audit what the agent will write into its memory—avoid storing raw sensitive artifacts (bank statements, private keys); prefer redacted summaries or hashes. 4) Test the workflow in a safe environment first (non-production server) to ensure it performs only expected checks (curl/ls/cat) and does not transmit data to unexpected endpoints. 5) If you require stronger guarantees, ask the maintainer to declare required credentials and add explicit guidance about redaction, retention, and outbound transmission policies.
功能分析
Type: OpenClaw Skill Name: evidence-anchor Version: 2.0.0 The 'evidence-anchor' skill is a documentation and methodology framework designed to help AI agents standardize how they verify and record evidence for task completion. It defines a hierarchy of evidence (Direct, Indirect, Reference) and provides templates for documenting verification steps like checking file paths, URLs, and logs. The content in SKILL.md is purely instructional and lacks any malicious code, data exfiltration logic, or harmful prompt injections.
能力评估
Purpose & Capability
The name/description (standardizing evidence anchors for verifiable, traceable memory) aligns with the SKILL.md content: templates and step-by-step verification for URLs, file paths, configs, logs, commits, timestamps, etc. The examples and acceptance criteria are consistent with the stated purpose.
Instruction Scope
The SKILL.md explicitly tells an agent to verify evidence by actions such as curl-ing endpoints, SSH-ing into servers, reading files/configs, and writing evidence into memory. Those actions are appropriate for the skill's goal, but they require access to systems and may expose sensitive data. The skill does not itself enumerate how those accesses/credentials are supplied or any limits on what to read or transmit.
Install Mechanism
This is an instruction-only skill with no install steps, binaries, or code to download. No install-related risk is present.
Credentials
The skill declares no required environment variables or credentials, yet many verification steps imply needing SSH keys, service credentials, or network access to private URLs and files (e.g., bank statements, /opt/ paths, /etc configs). That omission is not necessarily malicious but is an important operational gap: the user must ensure appropriate and least-privilege access is provided and that sensitive artifacts are handled carefully.
Persistence & Privilege
Flags are default (not always:true). The skill does instruct writing standardized evidence into memory (explicit part of the workflow), which is expected for this purpose. Autonomous invocation is allowed by platform default; there is no special elevated persistence requested by the skill itself.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install evidence-anchor
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /evidence-anchor 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.0
evidence-anchor 2.0.0 - Major documentation overhaul with a comprehensive, structured SKILL.md now provided. - Clear definitions and levels for "evidence anchors" established (Level 1: direct, Level 2: indirect, Level 3: referenced). - Standardized formats, templates, and acceptance criteria for evidence anchors introduced. - Detailed best practices, common pitfalls, and review workflows included. - Suitable use cases and evidence-to-status mapping explicitly outlined.
v1.0.0
- Initial release of the evidence-anchor skill. - Provides standardized definitions and templates for "evidence anchors" to ensure memory assets are verifiable, traceable, and reusable. - Introduces a 3-level evidence grading system for project documentation and validation. - Outlines scenarios, acceptance criteria, usage restrictions, and common pitfalls for evidence management. - Includes clear templates, acceptance workflows, and a regular review process for maintaining evidence credibility.
元数据
Slug evidence-anchor
版本 2.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Evidence Anchor 是什么?

标准化定义和验收项目证据锚点,确保长期记忆可验证、可追溯、可复用,支持多层级证据及定期复核流程。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 74 次。

如何安装 Evidence Anchor?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install evidence-anchor」即可一键安装,无需额外配置。

Evidence Anchor 是免费的吗?

是的,Evidence Anchor 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Evidence Anchor 支持哪些平台?

Evidence Anchor 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Evidence Anchor?

由 jiangwill2023(@jiangwill2023)开发并维护,当前版本 v2.0.0。

💬 留言讨论