Skip to content

Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.

docs: add README.zh.md (Simplified Chinese translation) (#25)

CH849667148c493075ddfcf
diff --git a/README.md b/README.md
index d171ce1..e31d758 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,8 @@
# Effective HTML
+[简体中文](README.zh.md)
+
Focused agent skills for creating useful, self-contained HTML artifacts, from low-fidelity wireframes to working interactive prototypes.
## Fat artifacts + fat context
diff --git a/README.zh.md b/README.zh.md
new file mode 100644
index 0000000..166af92
--- /dev/null
+++ b/README.zh.md
@@ -0,0 +1,99 @@
+<p align="center">
+ <img src="./assets/effective-html-banner.png" width="1280" alt="Effective HTML by Plannotator:HTML 线框图、原型、图表和示意图">
+</p>
+
+# Effective HTML
+
+[English](README.md)
+
+一组用于创建实用、自包含 HTML 成果的专用智能体技能,覆盖从低保真线框图到可交互原型。
+
+## 完整成果 + 充分上下文
+
+现代模型能完成很多工作。给它们提供有用的参考资料,并用成果展示你的意图。HTML 几乎可以呈现任何内容,而且往往比大段文字更清楚。提示词只需指向包含上下文的成果、仓库和文件夹。
+
+> [!NOTE]
+> 不安装也能使用本仓库。先把它当作参考资料,需要时再安装为技能集。请参阅
+> [Effective HTML 指南](https://www.effectivehtml.com/)。
+
+https://github.com/user-attachments/assets/24306977-7f30-44c9-9bff-55f901d557b0
+
+<p align="center">
+ <a href="https://github.com/backnotprop/plannotator">
+ <img src="./star-plannotator.svg" width="340" alt="在 GitHub 上为 Plannotator 点星">
+ </a>
+</p>
+<p align="center">
+使用 <a href="https://github.com/backnotprop/plannotator">Plannotator</a> 渲染并标注本地 HTML。
+</p>
+
+## 技能参考
+
+本仓库包含六个可选技能,用于创建实用的视觉成果。
+
+| 技能 | 适用场景 |
+| --- | --- |
+| [`html`](skills/html/SKILL.md) | 处理范围较广的 HTML 请求、混合型成果、报告、说明文档、演示文稿、落地页和工具,并在需要时转交给专用技能 |
+| [`design-artifact`](skills/design-artifact/SKILL.md) | 为任何 HTML 成果提供贴合主题的创意方向,同时避免套用固定的视觉风格 |
+| [`html-wireframe`](skills/html-wireframe/SKILL.md) | 用低保真布局方案测试内容、层级、导航、流程和响应式结构 |
+| [`html-prototype`](skills/html-prototype/SKILL.md) | 创建包含真实状态、交互、键盘支持和响应式行为的可用原型 |
+| [`html-plan`](skills/html-plan/SKILL.md) | 创建计划、路线图、发布安排和实施步骤,同时保留源材料中的既定要求 |
+| [`html-diagram`](skills/html-diagram/SKILL.md) | 创建架构图、时序图、流程图、状态图、层级图、时间线图和系统图 |
+
+实用指南:[面向编程智能体的 HTML 线框图和原型](https://docs.plannotator.ai/learn/code-context/html-wireframes-and-prototypes-for-coding-agents)。
+
+## 安装
+
+当你希望智能体把这些参考资料作为可复用的工作流使用时,安装整个技能集:
+
+```bash
+npx skills add plannotator/effective-html
+```
+
+列出或安装单个技能:
+
+```bash
+npx skills add plannotator/effective-html --list
+npx skills add plannotator/effective-html --skill design-artifact
+npx skills add plannotator/effective-html --skill html-wireframe
+npx skills add plannotator/effective-html --skill html-prototype
+```
+
+### Claude Code 插件
+
+```text
+/plugin marketplace add plannotator/effective-html
+/plugin install plannotator-effective-html@effective-html
+```
+
+### Codex 插件
+
+```bash
+codex plugin marketplace add plannotator/effective-html
+codex plugin add plannotator-effective-html@effective-html
+```
+
+## 技能如何协作
+
+这些技能把创意自由和可靠性分开处理:
+
+- 视觉方向来自对话、项目、受众和主题。
+- `design-artifact` 提供可复用的设计流程,但不规定重复使用的视觉风格。
+- 线框图刻意保持未完成感,让评审者专注于结构。
+- 原型实现一条可信的流程及其相关状态。
+- 计划保留源材料中的既定要求。
+- 示意图会选择适合所表达关系的视觉模型和渲染方式。
+- 每项成果都应具备响应式布局和无障碍支持,能够独立运行,并在浏览器中完成验证。
+
+详细指导只放在需要它的地方。通用的 `html` 技能负责分配工作,`design-artifact` 提供可选的创意方向,专用技能负责各自的保真度和行为要求。每个技能也可以独立使用。
+
+本项目的灵感来自 Thariq Shihipar 的 [The unreasonable effectiveness of HTML](https://thariqs.github.io/html-effectiveness)。
+
+<p align="center">
+ <a href="https://github.com/plannotator/tot">
+ <img src="./use-tot.svg" width="300" alt="使用 tot 分享 HTML">
+ </a>
+</p>
+<p align="center">
+使用 <a href="https://github.com/plannotator/tot">tot</a> 为 HTML 文件创建可分享的链接。
+</p>