메뉴
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 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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.
| 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.