1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | build-evidence-map-github-awesome-copilot |
| 作者/维护者 | GitHub（仓库 github/awesome-copilot，贡献者 alsoleg89） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/build-evidence-map |
| 许可证 | MIT（来自 GitHub API，仓库级） |
| GitHub Stars | 合集仓库整体 39,114（来自 GitHub API）；该数字属整个 awesome-copilot 合集，不代表本技能自身热度 |
| Forks | 合集仓库整体约 4,900+（同上，不代表本技能） |
| 最新版本 | 无独立版本号；SKILL.md 于 2026-08-05 合并进仓库后未再变动（来自 GitHub API 提交历史） |
| 安装方式 | 复制 skills/build-evidence-map/（含 scripts/validate.mjs、scripts/contract.mjs、references/ 两份参考文档）到 agent 的 skills 目录 |
2. 功能介绍与亮点
Build Evidence Map 是一套把“一个有争议的判断”转化为可携带、可审计的证据图谱的工作流。它不是简单地把结论写成一段话，而是强制把推理拆成四类节点——position（当前结论，全图仅一个）、claim（中间论点）、evidence（一条来源的忠实陈述）、unknown（可能改变结论的未知项），并用 supports / contradicts / qualifies / missing 四种带说明的边把它们连起来。核心设计原则是不删除反对证据——即使结论最终成立，与结论相悖的证据也要保留并标注“为什么没有推翻结论”，而不是被折叠进一句话总结里消失。
产出物是一份 UTF-8 JSON（.doubt.json），并附带零依赖的本地校验脚本 validate.mjs——只用 Node.js 内置模块（无需联网、无需 npm），对图谱做完整性检查（每个证据节点必须有来源与可核对的摘录、每个非结论节点必须有路径通向结论、图中不能有重复边或环等），通过后打印一份 64 位的校验回执。技能明确要求联网核实来源快照必须获得用户显式许可才能执行，且校验回执不能靠人工编造或“看起来有效”来冒充。整份仓库快照检查未发现任何要求执行未授权操作的可疑指令。
3. 适用场景
固定分类：内容创作与知识管理。适用于存在分歧或需要留痕的判断场景——技术选型评审、研究结论综合、提案评审、任何“事后可能被追问’当初为什么这么判断’“的决策。受益人群：需要为决策过程负责的技术负责人、研究人员、审阅提案的团队成员，尤其是那些决策会被后续审计或复盘的场合。
4. 跨 Agent 兼容性
- Claude Code：原生支持——标准 SKILL.md 格式，复制到 skills 目录即可被发现调用 ✅
- Codex CLI：不会自动发现
~/.codex/skills下的技能，需要在对话中显式引用 SKILL.md 路径才能触发 ⚠️ 需适配 - OpenClaw：未获取到该平台对本技能的直接验证信息 ❓ 未验证
- Hermes Agent：未获取到该平台对本技能的直接验证信息 ❓ 未验证
5. 推荐理由
多数“核查/评审”类技能把结论直接吐给用户，看不到过程；Build Evidence Map 反过来把过程本身做成了产出物——一份任何人都能打开检视的证据图谱，谁支持、谁反对、还缺什么信息，一目了然，且有本地脚本兜底校验图谱本身没有结构性缺陷（孤立节点、循环推理等）。对需要为决策留痕、或团队协作评审同一个有争议判断的场景，这比一段散文式总结更难蒙混过关、也更容易被下一个人接手复核。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 GitHub 为公认一线厂商官方出品（本技能收录于其官方维护的 awesome-copilot 仓库）；未检索到该子技能自身的独立第三方评价或采用数据 |
| 可用性 | 8 | 工作流步骤清晰、附完整参考文档（证据分级、图谱 schema）与零依赖校验脚本；需要 Node.js 18+ 运行环境，属少量配置；2026-08-05 合并后维护记录稳定 |
| 安全性 | 9 | 校验脚本仅使用 Node.js 内置模块（crypto/fs/path/url），无外部依赖、无网络调用；联网核实来源快照的步骤要求用户显式授权才能执行，SKILL.md 与脚本中未发现可疑指令；License 明确 |
综合评分（三项均值）：8.0
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| doublecheck-github-awesome-copilot | AI 生成文本的三层事实核查流程 | 面向“检查一段已写好的文字是否有事实错误”，产出是逐句置信度标注的核查报告；Build Evidence Map 面向“一个有争议的判断本身该如何被结构化论证”，产出是可复用的证据图谱而非文本核查报告，SKILL.md 中也明确建议简单事实核查场景改用 doublecheck |
| differential-review-trailofbits-skills | 安全领域的差异化代码审查 | 聚焦代码变更前后的安全差异对比，不涉及非代码类判断的证据留痕 |
| adversarial-reviewer-alirezarezvaniclaudeskills | 对抗性挑错单篇内容 | 输出是对一份内容的挑刺意见，不产出可校验、可复用的结构化证据图谱 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。其加入 awesome-copilot 仓库的提交经过仓库自动化贡献者信誉核查与代码风险扫描，均无高危发现，但这是仓库准入流程的记录，不构成独立用户评价。
9. 其他补充
无。
10. 安装使用方式
- 从 https://github.com/github/awesome-copilot/tree/main/skills/build-evidence-map 下载
SKILL.md、scripts/（validate.mjs、contract.mjs）、references/（evidence-ladder.md、map-schema.md）整套文件 - 放入所用 agent 的 skills 目录（如 Claude Code 的
.claude/skills/build-evidence-map/） - 需要 Node.js 18 及以上版本用于运行本地校验脚本
node <skill-directory>/scripts/validate.mjs decision.doubt.json - 渲染 JSON 为 HTML 视图需额外安装第三方包
doubt-ai@0.8.0，技能本身不会隐式安装或执行该包 - 联网核实来源快照（
doubt verify）是可选步骤，需用户显式授权后才执行，不会被自动触发
11. 注意事项
- 本技能不是简单的事实核查工具，投入产出比取决于判断本身是否值得投入结构化证据留痕的成本，简单事实核查建议改用同仓库的 doublecheck
- 渲染 HTML 视图依赖外部包
doubt-ai@0.8.0，若未安装该包则只能保留 JSON 格式的证据图谱 - 联网核实来源快照功能需要用户主动授权触发，默认不会自动联网