microsoft--webwright
wehub-resource-sync
63 行
2.8 KiB
Markdown
63 行
2.8 KiB
Markdown
---
|
||
description: Craft a reusable Webwright CLI tool by parameterizing a web task.
|
||
argument-hint: <natural-language web task with concrete values>
|
||
---
|
||
|
||
You are operating as the Webwright agent in **CLI tool mode**. First read
|
||
the `SKILL.md` of the `webwright` skill (the parent directory of this
|
||
`commands/` folder) and the `reference/cli_tool_mode.md` next to it,
|
||
then parameterize the following task so the resulting `final_script.py`
|
||
can be re-run later with different argument values:
|
||
|
||
$ARGUMENTS
|
||
|
||
Steps:
|
||
|
||
1. **Identify parameters.** Extract every requirement the user could
|
||
plausibly vary (search terms, locations, dates, filter values, etc.).
|
||
Items truly fixed for the site (start URL, site name, selector
|
||
strategy) are NOT parameters — keep them hard-coded.
|
||
|
||
2. **Write `plan.md`.** Add a `# Parameters` table with columns
|
||
`name | type | source phrase | default | allowed/format`, plus the
|
||
usual `# Critical Points` checklist. Defaults must equal the
|
||
concrete task values so `python final_script.py` (no args) reproduces
|
||
the task.
|
||
|
||
3. **Author `final_script.py`** in a fresh `final_runs/run_<id>/`:
|
||
- One reusable function named after the task domain
|
||
(e.g. `def search_<domain>(arg_a, arg_b, ...): ...`).
|
||
- Google-style docstring with summary, full `Args:` block (name, type,
|
||
meaning, format/units, default), and `Returns:`.
|
||
- `argparse` CLI under `if __name__ == "__main__":` whose flags
|
||
exactly mirror the function arguments and whose defaults equal the
|
||
concrete task values.
|
||
- **Side-effect-free at import time** — no browser launch, no network
|
||
call, no file write at module top-level.
|
||
- First log line after reset must be
|
||
`step 0 params: <name>=<value> <name>=<value> ...`.
|
||
- Same instrumentation as default mode: viewport 1280×1800, headless
|
||
local Firefox, no `full_page=True`, screenshots and final datum
|
||
saved into the run folder.
|
||
|
||
4. **Reproduce the task with no arguments.** Run
|
||
`python final_runs/run_<id>/final_script.py` and confirm it succeeds
|
||
end-to-end.
|
||
|
||
5. **Import-safety smoke test.** Load the module in a separate Python
|
||
process and confirm no browser is launched and the reusable function
|
||
is importable.
|
||
|
||
6. **Self-verify** every critical point against the saved screenshots
|
||
and the action log (replaces `self_reflection`). If any CP fails,
|
||
diagnose, fix the script (preserving the CLI shape), re-run inside
|
||
`final_runs/run_<id+1>/`, and re-verify.
|
||
|
||
7. **Show the user `--help`.** End by running
|
||
`python final_runs/run_<id>/final_script.py --help` and reporting
|
||
both the final datum and the help text so the user knows how to call
|
||
the tool again with different arguments.
|
||
|
||
Refer to `reference/cli_tool_mode.md` for the complete contract and
|
||
`reference/playwright_patterns.md` for the Playwright skeleton.
|