Skip to content
mapleluvrPublic

About

Testing strategy exploration and reusable project-local recipes for Pi coding agents.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

veripaka

veripaka

version: 0.1.0-alpha.1 Node.js 24 Skills and scripts

快速开始 | 使用例 | 更多示例 | 文档

- 赋能 Agent 于山重水复处 -

Agent 从实际使用软件开始,根据用途和反馈形成流程,将流程中稳定的部分编写成可调整的普通源码。以后直接运行这些步骤,取得截图、日志、响应或生成文件,与选定的参照比较。Agent 和用户可以根据运行结果理解变化、继续编写操作或调整流程,省去重新安排步骤、逐次调用工具和整理结果的劳动。

veripaka 提供编写指导、脚本运行、过程记录、独立参照和比较接口。具体操作可以复用已有的浏览器工具、命令、API、SDK 或测试框架,脚本直接调用它们。

veripaka 面向不同的 Agent 宿主。能加载 Skill 并调用脚本的 Agent,就可以使用这些设施;core 和 CLI 也可以独立调用。具体工具和权限由任务与宿主提供,Pi 是下面的一种接入示例。

从一次操作到重复使用

例如,Agent 实际操作一个设置页面,可能会:

  1. 打开页面,保存初始截图;
  2. 修改主题并保存,再取得操作后的截图。

这段流程值得再次使用时,将操作(打开网页、修改主题)、等待条件和截图参数(位置)写进脚本,并在文档中说明输入、依赖与清理方式。

修改页面代码后,再次运行同一流程时:截图比较显示保存按钮的颜色发生了变化。Agent 结合这次修改的目的理解它;也可以同时读取设置值,了解软件的状态。比较结果和相关材料一并保留,供之后回看。

重复运行时,稳定步骤由脚本直接执行,需要理解和调整的部分留给 Agent 或人。一次活动也可以先留下经历,等后续工作需要时再补充自动化。

快速开始

构建并安装

需要 Node.js 24.x 与 npm。从公开仓库取得源码,生成本地安装包:

git clone https://github.com/mapleluvr/veripaka.git
cd veripaka
npm ci
npm pack

npm pack 会先构建,再生成 veripaka-0.1.0-alpha.1.tgz。进入要使用 veripaka 的项目目录,安装生成的包;将路径替换为本机实际位置:

npm install --save-dev --ignore-scripts /absolute/path/to/veripaka/veripaka-0.1.0-alpha.1.tgz

在 Agent 中使用

在支持 Skill 的 Agent 中,按宿主的加载方式读取 node_modules/veripaka/skills/veripaka/SKILL.md,并提供脚本执行能力。加载后,交付要开展的实际工作。例如:

体验这个项目的设置功能,留下操作和观察记录;将值得重复的流程保存为脚本,方便以后重跑和比较。

以 Pi 为例,在目标项目目录启动:

pi --skill ./node_modules/veripaka/skills/veripaka/SKILL.md

Pi 会话中可以使用 /skill:veripaka <委托> 显式展开正文;其他宿主采用各自的 Skill 加载与调用方式。

保留这项工作需要的浏览器、桌面或其他工具,并按任务授权使用。Skill 帮助 Agent 展开操作、选择观察方式,并将值得复用的部分整理为脚本。正文与配套参考见 Skill 指导。

写自己的流程

安装包也提供独立的自动化接口。在目标项目目录,用 CLI 创建一个脚本起点:

node node_modules/veripaka/dist/src/cli/main.js flow new docs/verification/flows/example

生成的 flow.mjs 是一个只保存输入的 JavaScript 起点。补入实际操作后,以 flow run 执行;检查取得的材料,用 reference create 选取参照,再用 compare 比较后续运行。activity inspect 和 activity export 用于检查和选定导出文件。

脚本通过 veripaka/core 保存步骤与输出,循环、分支、等待和工具调用都在源码中。已有 probe 或 test script 可以只采用需要的记录接口。采集与比较可以分开执行:保存好截图后,换一种算法重新比较,无需再次操作软件。

API、命令和文件约定见自动化说明,其他安装方式见构建与安装指南。

使用例

以下演示从 veripaka 仓库根目录运行,展示自带流程的操作与产物。

附带的 HTTP 设置流程演示如何操作、采集、选择参照和比较。它读取初始设置、保存主题、重新读取,再关闭并新建服务实例,读取保存后的状态。服务使用独立的临时数据,结束时清理,响应文件保留在运行目录。

node examples/backend/automation/settings-flow.mjs --output .veripaka/activities/settings-first --save-reference .veripaka/references/settings-v1
node examples/backend/automation/settings-flow.mjs --output .veripaka/activities/settings-second --reference .veripaka/references/settings-v1 --theme light

第一次写入默认的 dark,并保存一份独立参照。第二次改为写入 light,与该参照比较。查看第二次运行的 summary.json、capture/artifacts/ 和 comparison/artifacts/comparison.json,可以看到保存响应、保存后读取和重启后读取的三处变化。

这次变化来自有意更换输入。换成软件版本变化时,也可以沿用同样的操作与比较方式,结合开发任务解释结果。

每次运行使用新的输出目录,参照也另存为独立副本。重复尝试上述命令时,请更换目录名。.veripaka/ 的本地输出由本仓库的 .gitignore 排除;分享记录或提交参照前,检查其中的敏感内容。

完整操作见 HTTP 示例。浏览器示例展示真实页面操作、截图及独立运行的图像比较,需要本机 Chrome 或 Chromium。

继续使用

可复用脚本、说明和长期参照可以放在项目的 docs/verification/,本地运行材料放在 .veripaka/。记录保留输入、步骤、输出及比较条件,便于另一个会话理解和继续。调整流程或参照时,留下变化的理由。

需要检查明确要求时,可以调用已有测试,也可以使用 veripaka 的 Recipe 与冻结验证命令;相应的准备、运行和结果说明见验证指南。

GUI 操作也可以通过 PWCU 包装为命名、参数化的程序调用,再供脚本使用。两个项目的分工及接入方式见与 PWCU 一起使用。

仓库布局

  • src/core/、src/cli/:自动化 SDK 与命令入口。
  • skills/:Agent 指导、参考和 launcher。
  • examples/:HTTP、浏览器及明确验证的运行示例。
  • tests/、scripts/:回归与安装检查。
  • docs/:工作入口、当前预期、使用说明、历史变更和实施记录;后续变更使用源码仓库中的 openspec/。

参与开发可运行 npm run typecheck 和 npm test;构建、打包及检查约定见开发说明。

About

Testing strategy exploration and reusable project-local recipes for Pi coding agents.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages