← Về thư mục
📄 / / profiles / r-and-d / raw_evidence / OpenAI4S / skills / evidence-walkthrough / README_zh.md

evidence-walkthrough(证据走查)

一次可作为参考的完整研究流程:固定的数据库查询 → 本地分析 → 带 lineage 的 版本化产物 → 一个能在干净环境里校验的证据包。

适用于首次运行的示范、作为基准用例(输入固定,两次运行才可比),或者当一个 结果需要交给当时不在场的人时。

用接收方的方式校验导出的包,不需要 daemon:

openai4s verify-package <session>.openai4s-session.zip

通过表示这个包是完整未被篡改的,而不是"来源可信"——具体校验了什么、没有 校验什么,见 openai4s/evidence.py。

配方本身在 SKILL.md。

安装

一个 Skill 就是一个文件目录,所谓安装,就是把这个目录复制到 Agent 会去读的地方。有 Node 18+、且 PATH 上有 git(npm 靠它解析 github: 形式的包名)即可,无需先克隆仓库:

npx github:PKU-YuanGroup/OpenAI4S install evidence-walkthrough --target claude

--target claude 写入 ~/.claude/skills,claude-project 写入 ./.claude/skills,openai4s 写入 <data_dir>/user-skills,--dir <path> 则写到你指定的任意位置。往目标写任何东西之前,都会先打印解析出的绝对路径;--dry-run 到此为止,不再写入。重装时,若目标副本被你改过、或者不是它自己装的,就拒绝覆盖;uninstall 也只删除它自己写过的文件。对于 npm 发布版中包含的配方,可用 npx @pku-yuangroup/openai4s-skills install evidence-walkthrough --target claude 安装发布版本。npm 目录可能与当前仓库不同。

没有 Node 时,直接取这个目录——需要 .zip 上传时再打包。tarball 是整个仓库(超过 100 MB),下面这条管道是 POSIX shell(macOS、Linux、WSL)写法,只解出这一个目录:

curl -L https://codeload.github.com/PKU-YuanGroup/OpenAI4S/tar.gz/refs/heads/main \
  | tar -xz --strip-components=2 OpenAI4S-main/skills/evidence-walkthrough
python3 -m zipfile -c evidence-walkthrough.zip evidence-walkthrough

同一份内容的图形界面版本是点击下载整个仓库 zip 包,Windows 上也走这条路:解压后把 skills/evidence-walkthrough/ 拷出来即可(unzip main.zip 'OpenAI4S-main/skills/evidence-walkthrough/*' 只解这一个目录)。如果你本来就在跑 OpenAI4S,那这里没有任何东西需要安装——wheel 自带全部内置 Skill,且内置 Skill 优先于 <data_dir>/user-skills 里的同名副本。目标目录、来源记录,以及安装器拒绝去做的那些事:tools/skills-installer/。