القائمة
Use when running the manual regression test suite before merging a PR — covers setup, which sections to always run, known pre-existing failures to skip, and the PR checklist.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Use when adding a new MCP tool to Claude in Safari — covers the full workflow from spec through implementation, tests, manifest updates, and PR creation.
Use when the Claude in Safari extension stops working after a code change, build, or Safari restart — specifically when the extension is missing from "Web Extension Background Pages", flashes and disappears, disappears from Safari Settings entirely, or make health fails with timeout.
استنادا إلى تصنيف SOC المهني
| name | regression-test |
| description | Use when running the manual regression test suite before merging a PR — covers setup, which sections to always run, known pre-existing failures to skip, and the PR checklist. |
Full test suite: docs/regression-tests.md. This skill covers what to run, what to skip, and how to confirm pass/fail.
make dev # build, launch, create dev.sock symlink
npm test && make test-swift # automated tests must pass first
Safari manual checks (cannot be automated):
These are fast and cover core infrastructure. Run for every PR:
| Section | What it covers |
|---|---|
| 1 | Automated test suite |
| 2 | Infrastructure (socket, tool registration) |
| 3 | Screenshot |
| 4 | Navigation |
| 5 | Page reading |
| 6 | Page interaction |
| Tool / Section | Symptom | Root cause |
|---|---|---|
Section 7 (javascript_tool) | "executeScript returned no result" | Safari MV2 doesn't await Promise return values from injected scripts — always null |
computer with read_page refs | "Element 'ref_N' not found" | accessibility-tree.js uses in-memory WeakRef map; computer.js needs data-claude-ref DOM attrs (set only by find.js). Must use find before computer(ref). |
file_upload on file:// pages | "No result from injected script" | Safari restricts executeScript on file:// pages. Use HTTP: python3 -m http.server 8765 --directory /tmp |
These are pre-existing bugs not introduced by the PR under test. Document them in the PR description but do not block merge.
Always run the section(s) for the feature being PR'd:
javascript_toolcomputer + findAt the end of docs/regression-tests.md there is a PR checklist. Copy it into the PR description before requesting review.
make send TOOL=<tool_name> ARGS='{"key": "value"}'
make send activates Safari automatically before each call. Use this, not mcp-test.py directly.