跳转到内容
关系图谱

verify-atlas(poteto 样例)

439 字 2 分钟

属性 8
repo
poteto_verification-skill-example
skill
verify-atlas
source
poteto_verification-skill-example/.cursor/skills/verify-atlas/SKILL.md
invoke
user
phase
verify
cost
mid
status
example
local
missing
一句话

一个虚构但结构完整的项目级验证技能样例:SKILL.md 负责 launch / doctor / drive / prove / cleanup,references/features/ 存行为级 feature map。

何时用 ​

  • 适合:想看 pstack-create-verification-skill 的产物长什么样;给大型桌面应用设计「技能加 feature map」的验证资产。
  • 不适合:直接拿去跑,Atlas、Harbor Labs、control-atlas 都是虚构的,驱动脚本 control-atlas.mjs 故意没有提供,文档只示范命令面。

怎么用 ​

text
node .cursor/skills/verify-atlas/control-atlas.mjs doctor
node .cursor/skills/verify-atlas/control-atlas.mjs new-session
node .cursor/skills/verify-atlas/control-atlas.mjs send "list open tasks in this project"
  1. 把改动匹配到一个或多个 feature 文件;跨会话、快捷键、拖拽时加读 multi-surface-journeys.md。
  2. 先跑 doctor:报 checkout 上下文、CDP 端口归属、watcher 存活、构建新鲜度,不新鲜不驱动。
  3. 分主流水:主工作区直连 9222 端口;隔离 checkout 每条命令带 --checkout,端口和 user-data-dir 按树派生。
  4. 按 feature 文件走遍每个可达入口,覆盖 success / cancel / error / empty / persistence 路径。
  5. 取证:截图、DOM 断言、clipboard、网络日志、reload 往返;扫尾用 cleanup --remove-checkout。
  6. 全量回归:按 features/README.md 从上到下走,以 multi-surface-journeys.md 收尾。

产出 ​

  • 一段能说服怀疑者的证据:触发动作和稳定终态在同一记录里;feature map 本身也是交付物,漂移随 UI 改动同 PR 修。

要点与坑 ​

  • 结构即重点:每个 feature 文件固定四个 H2,Sub-features、How to get to it (user POV)、Driving it with control-atlas、Gotchas;README 兼作全量回归顺序。
  • 证明标准:走真实用户路径(eval 只用来读状态,不直接调内部 handler);先 doctor;验证副作用不只看像素。
  • 维护交给 pstack-maintain-verification-skill;条目要短到不看源码就能跑,某段需要自己的前置条件时就拆文件。

关联 ​