html-communication

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

HTML communication

HTML沟通

Present something a human should read outside the terminal as one HTML file. This is not a landing page and not product UI.
将需要人类在终端之外阅读的内容生成为单个HTML文件。 这不是着陆页,也不是产品UI。

When

使用场景

Plans, specs, findings, comparisons, UI mocks. The word "plan" is often absent. If they just say "HTML", use this skill.
Do not use this for HTML that belongs in a repo.
适用于计划、规格说明、调查结果、对比分析、UI原型。通常不会明确提及“计划”一词。 如果用户仅提到“HTML”,即可使用本技能。 请勿将其用于代码仓库中的HTML文件。

Write

撰写要求

  • One self-contained HTML file. No external CSS/JS. Cap 512 KB.
  • Write it like a spec: headings, short paragraphs, lists, tables. Dark background, white text, high contrast. No hero / marketing chrome.
  • UI mocks: label them A, B, C. Lay them out for side-by-side comparison.
  • Keep the same output path across iterations so a later upload can reuse a stable URL once a host exists.
Default path:
text
~/.agents/artifacts/<short-kebab-name>.html
On a machine without
~/.agents
(e.g. a cloud VM), use
.artifacts/<short-kebab-name>.html
in the workspace instead and keep it out of git.
  • 生成单个独立的HTML文件,无外部CSS/JS,文件大小上限为512 KB。
  • 按照规格说明的格式撰写:包含标题、简短段落、列表、表格。采用深色背景、白色文字、高对比度。不要添加宣传性的头部/装饰元素。
  • UI原型:标记为A、B、C,并排布局以便对比。
  • 在迭代过程中保持输出路径一致,以便后续上传后可复用稳定的URL(当存在宿主时)。
默认路径:
text
~/.agents/artifacts/<short-kebab-name>.html
在没有
~/.agents
目录的机器上(如云端虚拟机),请改用工作区中的
.artifacts/<short-kebab-name>.html
,且不要将其纳入git版本控制。

Publish

发布步骤

  1. Write the file.
  2. If a public link is needed, use the
    file-upload
    skill. Never claim the document is hosted before that script succeeds.
  3. If
    FILE_HOST_URL
    is unset, return the
    file://
    path and say it is local.
  4. Do not open a browser unless the user asks. On a Mac with a display,
    open
    the local file only when they want to look at it here.
  5. Do not use a browser or web-search tool to "verify" the upload.
  1. 生成文件。
  2. 如果需要公开链接,请使用
    file-upload
    技能。在该脚本执行成功前,切勿声称文档已托管。
  3. 如果未设置
    FILE_HOST_URL
    ,则返回
    file://
    路径并说明这是本地文件。
  4. 除非用户要求,否则不要打开浏览器。在带有显示器的Mac设备上,仅当用户希望在此查看时,才使用
    open
    命令打开本地文件。
  5. 不要使用浏览器或网页搜索工具来“验证”上传是否成功。

Mocks

原型处理

When offering variants, stop after the HTML is ready. Wait for a choice like "C plus D plus A" before changing product code.
当提供多个变体时,生成HTML后暂停操作。等待用户做出类似“C加D加A”的选择后,再修改产品代码。