update global AGENTS with test updates, update browser-harness and artifact presenter for html view
This commit is contained in:
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: artifact-presenter
|
||||
description: Present any single local file the user needs to review, including documents, source, archives, PDFs, images, and videos, through mcat in a reusable Herdr pane. Also use for structured long-form reports, plans, ADRs, reviews, and summaries unless the user requests inline chat.
|
||||
description: Present local artifacts for review: use Browser Harness for interactive web artifacts, especially HTML, and mcat for non-web files, Markdown, and static source.
|
||||
---
|
||||
|
||||
# Artifact presenter
|
||||
|
||||
Present reviewable files and substantial generated content in a reusable terminal document pane instead of duplicating the complete artifact in chat.
|
||||
Present reviewable files and substantial generated content through the appropriate viewer instead of duplicating the complete artifact in chat.
|
||||
|
||||
## Choose the artifact
|
||||
|
||||
@@ -23,6 +23,11 @@ Treat an explicit destination and format as authoritative. For generated content
|
||||
|
||||
Keep ordinary explanations, code diffs, logs, multi-file comparisons, and user-requested inline responses in chat. Present a file only when it is a user-facing review artifact, not merely because the agent read it during investigation.
|
||||
|
||||
Choose the presentation path:
|
||||
|
||||
- **Interactive web artifacts, especially `.html`:** use the Browser Harness/Browser Use-backed workflow.
|
||||
- **Non-web files, Markdown, and static source:** use mcat in the reusable Herdr pane.
|
||||
|
||||
Completion criterion: select exactly one existing or generated artifact path before presentation.
|
||||
|
||||
## Prepare generated content
|
||||
@@ -31,11 +36,17 @@ Write the complete deliverable to the selected path. Keep it self-contained: the
|
||||
|
||||
Preserve repository documentation conventions. Creating a presentation artifact under `/tmp` does not authorize editing repository files when the request is otherwise read-only.
|
||||
|
||||
When presenting an existing file, pass the original file directly to mcat. Do not create a converted copy merely for display.
|
||||
When presenting an existing non-web file, pass the original file directly to mcat. Do not create a converted copy merely for display.
|
||||
|
||||
Completion criterion: the selected file exists and contains the complete review artifact.
|
||||
|
||||
## Present with mcat
|
||||
## Present interactive web artifacts
|
||||
|
||||
Load and follow the [`browser-harness`](../browser-harness/SKILL.md) skill. Open the local artifact URL in a real browser through the Browser Harness/Browser Use-backed workflow, then verify the browser target reports the artifact URL and page title. When normal Chrome attachment is unavailable, use browser-harness's documented local HTML fallback.
|
||||
|
||||
Completion criterion: the active browser target reports the local artifact URL and page title.
|
||||
|
||||
## Present non-web artifacts with mcat
|
||||
|
||||
Run the helper using its absolute path resolved from this skill directory:
|
||||
|
||||
@@ -57,7 +68,7 @@ mcat <input> --output html > <output.html>
|
||||
mcat <input> --output image > <output.png>
|
||||
```
|
||||
|
||||
Use an explicit output path and preserve the source file. Present the resulting single file through the helper when the user needs to review it.
|
||||
Use an explicit output path and preserve the source file. Present the resulting single file through the matching presentation path above when the user needs to review it.
|
||||
|
||||
## Respond concisely
|
||||
|
||||
@@ -65,6 +76,7 @@ Return:
|
||||
|
||||
- a one- to three-sentence result summary;
|
||||
- the artifact path;
|
||||
- whether the reusable mcat pane was opened or reused, or why presentation fell back to the file only.
|
||||
- for interactive web artifacts, that Browser Harness presented the artifact and verified its URL/title;
|
||||
- for other artifacts, whether the reusable mcat pane was opened or reused, or why presentation fell back to the file only.
|
||||
|
||||
Do not repeat the complete artifact in chat. Honor a later request to paste any section inline.
|
||||
|
||||
Reference in New Issue
Block a user