1实现原理 · 为什么它能做到
这是一个『生成器』skill：不直接验证，而是为仓库生成一个项目本地技能（.cursor/skills/verify-<app>/），让后续 agent 能以『冷启动、无人讲解』的方式驱动真实应用取证。
pstack/skills/create-verification-skill/SKILL.md
Every serious project needs a scripted way to drive the real app and prove behavior: launch it, exercise a feature the way a user would, and capture evidence. This skill generates that as a project-local skill (`.cursor/skills/verify-<app>/`) tailored to the repo.
注：读者定位被显式钉死：'You write the generator's output for the next agent, not for a human: it will be read cold, mid-task, by an agent that has never seen the app.'——生成物是一份给陌生 agent 的操作手册。
先访谈仓库而非用户：五个问题（Surface/Run/Drive/Observe/Isolate）全部优先从代码库自答，只有观察不到的才问人；现有 harness（Playwright/Cypress/expect/PTY/curl/debug port）优先于通用配方。
pstack/skills/create-verification-skill/SKILL.md
Answer these from the codebase and only ask the user what you cannot observe
注：Drive 题内给了递进选择：'Existing harnesses first — Playwright/Cypress specs, expect scripts, PTY helpers, curl-able endpoints, a debug port. Only then pick a generic recipe: browser/CDP for web and Electron, a tmux/PTY harness for CLI/TUI, plain HTTP for services.'
生成物有强制六段结构（Launch/Doctor/Drive/Evidence/Cleanup/Helpers），每段内容必须来自访谈实证、禁留占位符；frontmatter 缺失会导致技能不注册，被列为必写。
pstack/skills/create-verification-skill/SKILL.md
Write `.cursor/skills/verify-<app>/SKILL.md` with YAML frontmatter (`name: verify-<app>` and a `description` that names the app, the surface, and when to reach for it — without frontmatter the skill never registers) and these sections, each grounded in what the interview actually found (no placeholders left)
注：Doctor 定义是只读健康检查：'one read-only check that answers "is this instance worth driving?" — process up, right version/build, port owned by us, auth valid.'；Helpers 要求自带脚本可执行且调用方式写进正文：'A helper the reader has to reverse-engineer is not a helper.'
证据标准与 mock 边界被写成硬规则：必须走真实用户路径而非内部 setter/test-only 端点；同时捕获动作与结果状态；副作用（写文件/插行/发消息）与可见面一起核验；mock 只在生产边界已隔离外部系统时允许；dry-run/test 模式要实证其真的跳过而不是信名字。
pstack/skills/create-verification-skill/SKILL.md
exercise the real user path, not internal setters or test-only endpoints; capture the action and the resulting state, not just the final screen; verify side effects (files written, rows inserted, messages sent) alongside what's visible; mocks only where a production boundary already isolates the external system
注：dry-run 告诫原文：'some dry-runs still touch the network or open a browser.'——用观察（文件/网络/git refs）验证跳过行为，是典型的反轻信设计。
种子化 feature map：生成 features/README.md 索引 + 每用户功能一文件（首批 3-5 个，来自 routes/commands/menus/docs），形状照抄 references/feature-map-example/，固定四个 H2（Sub-features / How to get to it (user POV) / Driving it with <harness> / Gotchas），以用户视角写。
pstack/skills/create-verification-skill/SKILL.md
Follow the shape in [`references/feature-map-example/`](references/feature-map-example/), with a README index and one file per feature.
注：feature map 被定位为『repo 的持续维护验证源』：'a proof that drives one convenient entry point is incomplete when the map lists others.'——防只测最顺手的入口。
交付门禁=端到端实证：生成后必须亲自跑一遍生成技能（launch→doctor→驱动一个 feature→取证→cleanup），失败迭代也要跑 cleanup 防残留进程/端口；没跑过的生成物只是草稿。
pstack/skills/create-verification-skill/SKILL.md
A generated skill that was never executed is a draft, not a deliverable.
注：清理纪律：'Never kill by process name; kill what you started. Cleanup removes instances and scratch state, never the evidence'——并且 'After cleanup, confirm the evidence still exists at the named location — a cleanup that eats the proof fails this step.'
隔离纪律内建：Interview 的 Isolate 题评估双实例并行能力；不能安全并行时必须写进生成技能『拒绝双驱共享实例』，防污染用户真实会话。
pstack/skills/create-verification-skill/SKILL.md
If not, say so in the generated skill: refusing to double-drive a shared instance beats corrupting the user's session.
注：以『宁可拒跑不可破坏用户数据』为优先级；feature-map-example 的 baseline precondition（如 NOTES_DATA_DIR=/tmp/notes-verify-$RUN_ID）展示具体落地形态。
2核心能力
01任意语言/框架/平台的仓库访谈（Surface/Run/Drive/Observe/Isolate 五问，优先自答）
02生成带 frontmatter 的 verify-<app> 项目技能（六段结构、零占位符）
03feature map 种子化（README 索引 + 每功能一文件 + 四个固定 H2 + 用户 POV）
04真实路径取证标准（动作+状态+副作用三件套，mock/dry-run 边界显式化）
05端到端实证门禁：生成技能须自己完整跑通一次才算交付
06隔离与清理纪律（拒绝双驱共享实例、kill what you started、证据免于清理）
07维护循环衔接（交棒 /maintain-verification-skill）
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | 无固定第三方 CLI；harness 按仓库访谈结果选定（Playwright/Cypress/expect/curl/tmux/PTY/browser CDP 等，均为宿主工具或仓库既有依赖） |
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 信任仓库提供的启动/驱动信息：恶意或损坏的 repo（package scripts/README/Makefile）可诱导 agent 执行任意本地命令；Doctor 只读检查与『先修后生成』是仅有的防线。 — injection_surface：仓库内容作为访谈输入被信任
- 端到端实证会真实启动并驱动目标应用：若隔离纪律执行不到位（共享实例、未用独立数据目录），可能触碰用户真实数据/会话。 — skill 已内建 'refusing to double-drive a shared instance beats corrupting the user's session'，依赖 agent 执行
- 生成物二次传播风险：verify skill 内容是对仓库的归纳，被投毒仓库会生成带误导步骤的技能，影响后续所有验证会话。 — 供应链式风险，skill 无法自防 [INFERENCE]
风险提醒：蓝色，知晓即可。接触面=本地仓库读写与本地进程：访谈读代码、生成物写入项目 .cursor/skills/verify-<app>/、端到端实证会启动 repo 自身命令并用宿主 harness 驱动应用、cleanup 清理自己创建的实例/脚手架（kill what you started，非任意删除）；无自带脚本、无网络外发、无凭证读取。注意点：对仓库提供的启动命令的信任边界、以及驱动真实 app 时的数据隔离（skill 已内建纪律），均属宿主权限约束下的本地操作。
5第二遍独立确认
- [ok] 纯 prompt 生成器、无自带脚本 — 目录仅 SKILL.md + references/feature-map-example/{README,create-note,search}.md；skill 自身无可执行代码。
- [ok] 五问访谈与『先仓库后用户』 — 'Answer these from the codebase and only ask the user what you cannot observe' 原文在；五问标题逐字齐全（含 Isolate 双实例题）。
- [ok] 生成技能六段结构 + frontmatter 必写 — Launch/Doctor/Drive/Evidence/Cleanup/Helpers 六段均以 '- **X:**' 形式存在；'without frontmatter the skill never registers' 原文在。
- [ok] 证据标准/mock/dry-run 边界 — 真实用户路径、副作用核验、mock 边界句逐字存在；'some dry-runs still touch the network or open a browser.' 原文在。
- [ok] feature map 契约（四 H2 + 用户 POV + 3-5 起步） — 四 H2 名称原文在；example 三个文件均按 README→功能文件的索引关系组织，create-note.md 与 search.md 各含四 H2 与 Preconditions。
- [ok] 端到端实证门禁与清理纪律 — 'A generated skill that was never executed is a draft, not a deliverable.'、'Never kill by process name; kill what you started.'、'a cleanup that eats the proof fails this step' 均逐字存在。
- [ok] 外部依赖清单（动态 harness） — 无固定第三方；harness 列表（Playwright/Cypress/expect/curl/debug port/tmux/PTY/CDP/HTTP）是候选配方而非强制依赖，已在条目中限定表述。
- [ok] 无凭证/无固定外发 — 全文无密钥/token/env 读取指令；Interview 提及 env vars/auth 仅作为『要记录的运行前提』，不是采集动作。
6结论
适合：适合任何『需要脚本化证明 UI/CLI/service 行为』的仓库（web/桌面/CLI/API/库），尤其是多 agent 并行、无人值守或新人接手的项目；适合验收流程想从『口头声称』升级为『可重跑取证』的团队；与 poteto-mode 家族『先证明再交付』的纪律天然配合。
不适合：不适合不打算维护 feature map 的一次性脚本场景（map 需随 app 变化保鲜，否则会教错步骤）；不适合验证产物必须留给人类评审而非 agent 冷读的团队（生成物文风面向 agent）；不适合不允许启动真实应用/无 harness 环境（纯静态分析任务应另选）；对运行期零外部工具要求的环境，端到端实证门禁可能无法满足。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-09
方式 A · 人下载镜像包下载 create-verification-skill.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentb679c7c74e03480f…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库cursor / cursor/plugins
原始 GitHubcursor/plugins ↗
Stars7221
最近推送2026-09-09
本 skill commit
df3fb154fb许可仓库根无统一 LICENSE（GitHub API license 为 null）；该 skill 随 pstack 插件分发，插件自带 pstack/LICENSE（MIT，Copyright (c) 2026 Lauren Tan）
本站信息
收录日期2026-09-06
分类基础工具与工作流
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。