Repository navigation
docs(skill): clarify observation and overlay recovery - #564
Open
Wang-Zephyr wants to merge 1 commit into
Open
Wang-Zephyr wants to merge 1 commit into
Wang-Zephyr wants to merge 1 commit into
Conversation
Wang-Zephyr
marked this pull request as ready for review
November 3, 2026 15:40
Wang-Zephyr
force-pushed
the
docs/observation-overlay-recovery
branch
from
November 17, 2026 08:17
c2a6475 to
5ed9eb9
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds recovery guidance for the sync/retry loop and extension-overlay obstruction reported in #551, in both the universal CLI skill and the DSH plugin skill.
kind: "unchanged". After a failed/refused untargeted attempt, synchronize and reconsider the returned evidence.observationIdneeds an upgrade and skill reload; repeating sync cannot repair it.Could not clear the extension overlay from the click point, explain the temporary Control hints workaround, reinspection of the intended target, and the distinction from site masks reported by VOM.This documents recovery; it does not fix the overlay hit-testing defect or close #551. The original issue's baseline-only receipt rule is not reproduced by the current implementation.
Validation
node scripts/check-skill-bundles.mjsnode --test scripts/check-skill-bundles.test.mjs— 6 passednode scripts/check-crate-skill.mjsgit diff --checkpnpm --filter @browser-skill/extension exec vitest run src/cooperation/target-policy.test.ts src/content/__tests__/overlay-controller.test.ts src/tools/vom/__tests__/capture.test.ts --maxWorkers=2— 107 passedDocumentation only: 14 lines added across four references. No production code changes or live-browser reproduction claimed.