app-verification
Create or maintain a project-local skill and feature map for exercising user-visible behavior through the repository's existing verification tools. Use when setting up Paved in a repository with a runnable application, or when its verification guide is missing or stale.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- app-verification
- description
- Create or maintain a project-local skill and feature map for exercising user-visible behavior through the repository's existing verification tools. Use when setting up Paved in a repository with a runnable application, or when its verification guide is missing or stale.
02 资源文件 1
- 参考文档references/project-skill-layout.md2.7 KB
03 SKILL.md 正文
<!-- Generated by Paved plugin paved@2.29.0 from core.testing.app-verification@0.2.0; edit Paved Core instead. -->
Application verification
When to use
Create a project-specific verification skill during Paved initialization when repository evidence shows a runnable user-facing application or command-line interface, when a person asks for one, or when an existing guide needs an update. This skill records how to reach user-visible behavior and what observable result proves it.
Required context
Read the verification profile and the repository's own files. Use the feature map, product context and technology context when they help locate behavior or its entry points. Treat unconfirmed facts as unknown.
Preconditions
- Paved is initializing the repository, or the user asked to create or update the guide.
- Paved is initialized and the working tree is known.
- The repository has a runnable user-facing application or command-line interface.
If the repository has no such interface, explain that and stop.
Procedure
- Inspect project documentation, configuration, routes or commands, tests and the
.paved/project/feature-map/. Identify a small first set of three to five important user-visible features; include all features when the interface is smaller. Cite the repository paths that establish each entry point. Usecontext-discoverywhen those sources do not explain where a user-visible flow starts. - Find the exact existing launch, readiness, interaction, evidence and cleanup methods.
Prefer configured verification checks and project Tool implementations. Resolve each
Tool and check its permissions, environment and preconditions before use. The optional
core.runtime.start,core.runtime.inspect,core.runtime.stopandcore.browser.interactTools may help when compatible implementations are available. Never invent a command, use a production environment, or use personal data. - Create a project skill under
.paved/skills/verify-<app>/withSKILL.md,skill.yamlandreferences/features.md. Use the output structure inreferences/project-skill-layout.md. Keep the skill and map project-owned; do not replace an existing human-edited guide. If a matching guide already exists, propose specific edits and preserve unrelated content. - Mark each claim in the feature map as
observedonly when supported by source or documentation; otherwise leave it unknown. For launch and interaction instructions, distinguish commands found in project configuration from behavior actually exercised. Record the guide's coverage in the frontmatter ofreferences/features.md(schemas/verification-guide.schema.yaml): the feature-map ids and entry points it covers, user-visible features knowinglydeferred, and the SHA-256 of each feature-map document it was written from.paved doctorcompares that frontmatter with the feature map and reports drift; it never rewrites the guide. - If an existing configured check or Tool can safely exercise the app, verify one representative feature end to end, capture its result and clean up only resources this run created. Do not change application code to make the guide pass. If no usable harness exists, leave the skill explicitly marked as a draft and name the missing capability; never claim live verification.
- Check the generated files against the Paved skill contract and confirm the selected check passed before calling the guide ready. Summarize the mapped features, evidence, unknowns and any draft limitation.
Tools
Use configured verification checks and selected project Tool implementations. The
optional core.runtime.start, core.runtime.inspect, core.runtime.stop and
core.browser.interact Tools are usable only when their bindings resolve and their
policies allow the intended local or ephemeral run. Without a usable implementation,
write a draft guide and state what is missing; do not run a guessed command.
Rules
Follow core.quality.unknowns-stay-unknown and the Core instruction's Tool execution
boundary. Treat a guide as instructions, not evidence that its steps passed.
Verification
Require a runtime check when a configured harness can exercise the application. If no
runtime check or compatible Tool exists, the guide remains a draft and the verification
gap is reported.
Evidence
Include the diff and the result of one exercised feature when a usable harness exists. Attach the captured runtime artifact or check result. A draft records the missing capability instead of claiming a pass.
Completion criteria
- The project skill and feature map follow the referenced layout and preserve existing human-owned content.
- Every mapped entry point and result is grounded in repository evidence.
- One feature has a captured runtime result, or the guide is clearly marked as a draft with the missing capability recorded.
Failure modes
| Failure | Signal | Response |
|---|---|---|
| Guessed instructions | A command or route has no source in project files or configuration | Remove it or ask the user |
| No safe runtime path | No configured check or Tool can exercise the interface | Leave a draft and name the missing harness |
| Stale guide | A documented path no longer matches the source, or paved doctor reports PAVED_VERIFICATION_GUIDE_* |
Update only that claim, recheck it and record the new digests |
| Shared or sensitive state | A run would use production or personal data | Stop; ask for a safe local or ephemeral environment |
References
- references/project-skill-layout.md: the generated skill and feature-map contract.
Paved integration
Use the project-local Paved contract as the source of truth. Discover state with node "${CLAUDE_PLUGIN_ROOT}/scripts/paved.mjs" status --json, load only relevant .paved/project/ context, and invoke verification with node "${CLAUDE_PLUGIN_ROOT}/scripts/paved.mjs" verify --json. Always run it from the repository being worked on, never from the plugin directory. Do not edit generated integration files or bypass Paved lifecycle and ownership checks.
04 同仓库更多 Skills
sample-skill
Does a sample task. Use when a sample is needed.
unexplained-contract
Does a sample task. Use when a sample is needed.
shell-block
Does a sample task. Use when a sample is needed.
project-identifier
Does a sample task. Use when a sample is needed.
oversized
Does a sample task. Use when a sample is needed.
no-activation
Does a sample task.