lavish-axi

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

lavish-axi

lavish-axi

Open an agent-generated HTML artifact in the browser as a review surface a human can annotate, then read that feedback back over a long poll.
在浏览器中打开由Agent生成的HTML制品作为审阅界面,供人工标注,随后通过长轮询读取反馈。

When to reach for it

适用场景

  • A plan, comparison, diagram, table, code view, report, prototype, or decision surface will be clearer as a page than as prose: build the HTML, then open it here.
  • Structured input from the user (choices, triage, scope) belongs in an artifact with the
    input
    playbook, not in a chat question.
  • Do NOT reach for it for a short textual answer, or when nobody is at a browser; answer in the conversation instead.
  • Sharing outside this machine is
    export
    (a portable file) or
    share
    (a hosted page), not the review server.
  • 当计划、对比、图表、表格、代码视图、报告、原型或决策界面以页面形式呈现比纯文本更清晰时:先构建HTML,再在此处打开。
  • 用户的结构化输入(选项分类、问题分流、范围界定)应使用
    input
    剧本集成到制品中,而非以聊天问题形式提出。
  • 请勿在仅需简短文本回答,或无人在浏览器前时使用此工具;直接在对话中回复即可。
  • 如需在本机外分享,应使用
    export
    (生成可移植文件)或
    share
    (托管页面),而非审阅服务器。

Workflows

工作流程

Build the artifact only after reading the current guidance; it is CLI-owned and installed skills go stale.
bash
lavish-axi design                  # design-direction priority, CDN snippet, playbook router
lavish-axi playbook                # list playbook ids
lavish-axi playbook plan           # focused guidance for the artifact you are about to write
Review loop - open, then wait for the human. The poll is silent by design; never kill it.
bash
lavish-axi .lavish/report.html                       # prints the session url
lavish-axi poll .lavish/report.html                  # blocks until feedback or session end
lavish-axi poll .lavish/report.html --agent-reply "fixed the pricing table"
Hand the artifact to someone who is not on this box.
bash
lavish-axi export .lavish/report.html --out /tmp/report-standalone.html
lavish-axi share .lavish/report.html --password "<pw>"   # third-party host, public without --password
Close out or recover.
bash
lavish-axi                          # live sessions, or an empty list
lavish-axi end .lavish/report.html  # agent-side end; a later plain open still works
lavish-axi stop                     # shut the background server down
仅在阅读当前指引后再构建制品;该工具由CLI维护,已安装的技能会过时。
bash
lavish-axi design                  # 设计方向优先级、CDN代码片段、剧本路由
lavish-axi playbook                # 列出剧本ID
lavish-axi playbook plan           # 为即将编写的制品提供针对性指引
审阅循环 - 打开页面,然后等待人工反馈。轮询默认静默运行;切勿终止它。
bash
lavish-axi .lavish/report.html                       # 打印会话URL
lavish-axi poll .lavish/report.html                  # 阻塞直至收到反馈或会话结束
lavish-axi poll .lavish/report.html --agent-reply "fixed the pricing table"
将制品发送给不在本机的人员。
bash
lavish-axi export .lavish/report.html --out /tmp/report-standalone.html
lavish-axi share .lavish/report.html --password "<pw>"   # 第三方托管,不添加--password则公开访问
结束会话或恢复操作。
bash
lavish-axi                          # 查看活跃会话,若无则显示空列表
lavish-axi end .lavish/report.html  # 从Agent端结束会话;之后仍可直接打开制品
lavish-axi stop                     # 关闭后台服务器

Conventions

约定规范

Write artifacts under
.lavish/
in the working directory unless the user names a place. Keep sibling assets in that same directory and reference them with relative paths; a leading
/
does not resolve.
Every response ends with
next_step
or
help:
hints; follow them rather than guessing the next command. Every command takes
--help
.
Detected layout issues never return the poll. They wait in the user's Layout issues inbox and arrive as an ordinary
layout-warnings
prompt only once the user queues them, so never edit the artifact to chase a layout issue the user did not send.
Run the poll in the foreground unless the harness has a tracked background job that provably wakes the same agent. Never
nohup
,
&
, or
disown
it. A killed poll loses nothing: re-run it.
A browser-side end refuses a later plain reopen; pass
--reopen
only when the user asks or something genuinely needs their eyes.
No global install required:
npx -y lavish-axi ...
runs every command above, and follow-up commands the CLI prints should be run that way too.
除非用户指定路径,否则在工作目录下的
.lavish/
文件夹中编写制品。 将关联资源放在同一目录下,并使用相对路径引用;开头的
/
无法解析。
每个响应都以
next_step
或
help:
提示结尾;请遵循这些提示,而非自行猜测下一步命令。 所有命令都支持
--help
参数。
检测到的布局问题不会通过轮询返回。它们会存入用户的布局问题收件箱,仅当用户将其排入队列后,才会以常规
layout-warnings
提示的形式送达,因此切勿在未收到用户发送的布局问题时就修改制品。
除非工具有可追踪的后台任务且能可靠唤醒同一Agent,否则请在前台运行轮询。切勿使用
nohup
、
&
或
disown
命令。终止轮询不会丢失任何内容:重新运行即可。
若用户在浏览器端结束会话,后续无法直接重新打开;仅当用户要求或确实需要其查看时,才添加
--reopen
参数。
无需全局安装:使用
npx -y lavish-axi ...
即可运行上述所有命令,CLI输出的后续命令也应以此方式执行。

Non-goals

非目标范畴

  • Not a design system reference:
    lavish-axi design
    and
    lavish-axi playbook <id>
    own that, and this file must never restate it.
  • Not a flag reference.
    --help
    is current; this skill is not.
  • share --unpublish
    does not delete a hosted page, it overwrites it. The URL still resolves.
  • No reverse conversion: whiteboard edits are applied by updating the Mermaid source, never by writing a scene file back.
  • 并非设计系统参考:设计系统相关内容由
    lavish-axi design
    和
    lavish-axi playbook <id>
    负责,本文档绝不应重述相关内容。
  • 并非参数参考。
    --help
    提供最新参数信息;本技能文档并非最新。
  • share --unpublish
    不会删除托管页面,而是覆盖它。URL仍可访问。
  • 不支持反向转换:白板编辑需通过更新Mermaid源文件来应用,切勿将场景文件写回。

Request

请求

$ARGUMENTS
If the request above is non-empty, the user invoked
/lavish-axi
explicitly - fetch the current CLI guidance, then build that artifact. If it is empty, infer what to visualize from the conversation.
$ARGUMENTS
若上述请求非空,则表示用户已显式调用
/lavish-axi
- 获取当前CLI指引,然后构建对应的制品。 若请求为空,则从对话内容推断需要可视化的内容。