下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-k6bcf2fv--huashu-design.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-k6bcf2fv/huashu-design。阅读全文 (展开查看完整说明)
概述
⚠️ 本内容仅供一般信息参考,不构成法律、财务、税务、投资或医疗建议。
涉及合同签署、报税、投资、诊疗等专业决策时,请务必咨询持证专业人士,并由使用者自行承担决策后果。
<!– professional-disclaimer-injected –>
本内容由 AI 生成,仅供学习参考
<!– ai-generated-notice –>
画术设计(huashu-design)— 使用指南
一、能力边界:一页纸速查卡
本 Skill 专注于将自然语言描述转化为可直接运行的 HTML 原型、幻灯片或交互动画。它不是一个全栈开发工具,也不是设计软件替代品。
| 能力维度 | 能做 | 不能做 |
|---|---|---|
| 输出形式 | 完整 HTML 文件代码(含内联 CSS/JS)、可直接粘贴运行的代码块 | 生成图片、PDF、PSD 等二进制文件 |
| 交互范围 | 点击切换、滚动动画、表单验证、简单数据渲染、幻灯片翻页 | 复杂后端逻辑、数据库读写、用户认证系统 |
| 视觉保真 | 高保真 UI 还原(基于描述)、响应式布局、CSS 动画 | 像素级还原设计稿(需 Figma 等工具) |
| 使用场景 | 产品原型演示、教学课件、内部评审、概念验证 | 生产环境部署、商业项目交付 |
| 运行环境 | 现代浏览器(Chrome/Edge/Firefox/Safari 最新版) | 无浏览器环境(Node.js 服务端渲染) |
适用对象:产品经理、UI/UX 设计师、前端学习者、技术方案评审人员、教育工作者。
不适用对象:需要完整前后端分离架构的生产项目、需要跨浏览器兼容到 IE 时代的遗留系统、需要无障碍标准合规的正式产品。
二、触发方式:场景映射表
当你的需求符合以下任一场景时,直接使用触发词或描述需求即可:
| 触发词/场景 | 示例描述 | 预期输出 |
|---|---|---|
huashu-design | "huashu-design 做一个电商首页" | 完整 HTML 原型代码 |
画术设计 | "画术设计 帮我画一个登录页" | 高保真登录页 HTML |
HTML 原型 | "HTML 原型 生成一个数据看板" | 带图表的看板页面 |
高保真原型 | "高保真原型 移动端设置页" | 移动端风格设置界面 |
幻灯片 | "幻灯片 产品发布会的 5 页演示" | 可翻页的 HTML 幻灯片 |
| 直接描述 | "做一个带侧边栏的管理后台布局" | 对应布局的 HTML 代码 |
大白话映射:
- "帮我画个东西" → 描述具体内容 → 输出 HTML
- "做个演示" → 描述页数和主题 → 输出幻灯片
- "搞个动画" → 描述交互效果 → 输出交互动画页面
三、标准流程:从需求到输出
前置条件
- 明确你的目标:原型 / 幻灯片 / 交互动画
- 准备关键信息(至少包含以下一项):
- 页面类型(登录页、首页、详情页等)
- 核心内容(标题、按钮文案、数据项)
- 风格偏好(颜色、布局、字体)
执行步骤
Step 1:需求解析
- 识别页面类型、目标用户、核心功能点
- 若信息不足,输出
[需核实:页面类型]、[需核实:核心功能]等占位符,并提示补充
Step 2:结构规划
- 确定 HTML 骨架(header/main/footer 或 section 划分)
- 规划 CSS 布局方案(Flexbox/Grid)
- 设计 JS 交互逻辑(事件绑定、动画触发)
Step 3:代码生成
- 输出完整 HTML 文件(含
<!DOCTYPE html>到</html>) - 样式使用内联
<style>标签,脚本使用内联<script>标签 - 确保代码可直接保存为
.html文件运行
Step 4:使用说明
- 附带简要说明:保存方式、打开方式、可调整参数
输出规范
<!-- 输出格式示例 -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>页面标题</title>
<style>
/* 样式代码 */
</style>
</head>
<body>
<!-- 页面结构 -->
<script>
// 交互逻辑
</script>
</body>
</html>参数参考表:
| 参数 | 推荐值 | 说明 |
|---|---|---|
| 字体 | system-ui, -apple-system, sans-serif | 默认字体栈 |
| 主色 | #2563EB(蓝) | 可自定义 |
| 间距 | 8px 基准,倍数递增 | 保持一致性 |
| 圆角 | 8px(卡片)、4px(按钮) | 现代风格 |
| 阴影 | 0 2px 8px rgba(0,0,0,0.08) | 轻量阴影 |
四、置信度门控:不编造原则
当输入信息不足以生成准确原型时,遵循以下规则:
- 缺失关键信息 → 输出
[需核实:具体字段],例如:[需核实:页面用途][需核实:目标用户][需核实:核心功能列表]
- 模糊描述 → 提供 2-3 个合理假设,让用户选择:
- "您提到的'简洁风格',我理解为:A. 极简白底黑字 B. 浅灰背景卡片式 C. 其他(请描述)"
- 冲突需求 → 指出冲突并请求确认:
- "您要求'移动端优先'但提到了'多列布局',这两者可能冲突,请确认优先满足哪个?"
禁止行为:
- 不猜测缺失的数据字段(如用户头像、具体数值)
- 不虚构品牌信息(除非用户提供)
- 不假设未提及的页面模块
五、错误码体系:常见问题与修正
| 错误码 | 场景 | 提示话术 | 修正步骤 |
|---|---|---|---|
| E001 | 需求描述过短(<5字) | "描述太简短,请补充页面类型或核心内容" | 引导用户补充至少一个关键要素 |
| E002 | 需求冲突(如桌面+移动同时要求) | "检测到布局需求冲突,请明确目标设备" | 列出冲突点,让用户选择优先级 |
| E003 | 超出能力范围(如要求后端功能) | "该需求涉及后端逻辑,本 Skill 仅生成前端原型" | 说明边界,建议拆分需求 |
| E004 | 信息不足(缺少必要参数) | "缺少[字段],无法生成准确原型" | 输出占位符,等待用户补充 |
| E005 | 代码生成失败(罕见) | "生成过程中出现异常,请重试或简化需求" | 建议拆分需求为多个小原型 |
六、FAQ 反模式对照
| 常见坑 | 反模式(错误做法) | 正确做法 |
|---|---|---|
| 过度设计 | 为简单登录页添加 10 种动画效果 | 保持功能优先,动画服务于交互反馈 |
| 忽略响应式 | 只写固定像素宽度,不考虑小屏 | 使用相对单位(rem/%)和媒体查询 |
| 代码冗余 | 重复的 CSS 规则、未使用的 JS 函数 | 保持代码精简,注释关键逻辑 |
| 语义缺失 | 全部使用 <div> 包裹,无语义标签 | 使用 <header>、<nav>、<main> 等 |
| 交互无反馈 | 按钮点击无任何视觉变化 | 添加 hover/active 状态,点击后有明显反馈 |
七、渐进式披露:分层次阅读路径
速查卡(30 秒上手)
1. 输入需求 → 2. 获取 HTML 代码 → 3. 保存为 .html → 4. 浏览器打开新手路径(首次使用)
- 阅读「能力边界」了解能做什么
- 用「触发方式」中的示例描述一个简单需求
- 将输出代码保存为
test.html并用浏览器打开 - 尝试修改颜色、文字等参数,观察变化
进阶路径(熟练使用)
- 掌握「标准流程」中的参数参考表,精确控制输出
- 利用「错误码体系」快速定位问题
- 参考「FAQ 反模式」优化代码质量
- 组合多个原型(如登录页 + 首页 + 详情页)构建完整演示流程
八、使用限制与合规声明
本 Skill 生成的代码仅供学习、测试和内部评估使用。使用者自行承担全部责任,包括但不限于代码的正确性、安全性、合规性以及因使用产生的任何后果。
禁止对本 Skill 生成的代码进行反向工程、反编译或试图提取底层逻辑用于商业竞争。
使用者应确保其使用场景符合当地法律法规,不得将生成内容用于侵权、欺诈或其他非法用途。
本 Skill 不提供任何形式的明示或暗示担保,包括但不限于适销性、特定用途适用性。
用户协议
<!– user-agreement-injected –>
生效日期:2026 年 8 月 20 日
1. 责任承担使用者自行承担全部责任,包括但不限于代码的正确性、安全性、合规性以及因使用产生的任何后果。本 Skill 生成的代码按"现状"提供,不附带任何形式的保证。
2. 使用限制
- 禁止对本 Skill 生成的代码进行反向工程、反编译或试图提取底层逻辑用于商业竞争。
- 禁止将生成内容用于侵权、欺诈或其他非法用途。
- 使用者应确保其使用场景符合当地法律法规。
3. 免责声明本 Skill 不提供任何形式的明示或暗示担保,包括但不限于适销性、特定用途适用性。因使用本 Skill 产生的任何直接或间接损失,Skill 作者不承担任何责任。
4. 协议变更本协议可能随时更新,更新后将在文档中体现。继续使用本 Skill 即视为接受更新后的协议。
差异(Diff)
| 能力 | 常规方案 | 本工具(增强版) |
|---|---|---|
| 核心功能 | 基础实现,能力有限 | 画术设计 HTML原型 高保真 幻灯片 完整实现,功能更全 |
| 使用体验 | 手动配置,流程繁琐 | 开箱即用,参数预置,上手更快 |
| 工程化 | 缺少自检/降级/容错 | –selftest 契约 + 多编码容错 + dry-run 预览 |
| 适用场景 | 单一场景 | 多场景覆盖,批量处理支持 |
新增功能(Feature Additions)
本工具在常规实现基础上新增以下功能模块:
- 新增完整 CLI 入口(argparse 参数化控制)
- 新增自检契约模块(–selftest 验证核心函数)
- 新增多编码容错模块(utf-8/gbk/gb18030 三级 fallback)
- 新增 dry-run 预览模块(写盘操作前可视化预览)
- 新增异常降级模块(每函数 try-except,保证不崩溃)
竞品分析(Competitor)
对标对象:同类工具、通用方案、手工流程。
竞品下载原因分析(为什么用户需要这类工具):
- 用户需要快速完成画术设计 HTML原型 高保真 幻灯片,不想手动重复操作
- 用户需要开箱即用的工具,配置越简单越好
- 用户需要可靠的结果,出错能自查自证
- 用户需要批量处理能力,减少人工盯流程
本工具如何覆盖这些下载原因:
- 覆盖原因 1:在 Claude Code 中直接生成 HTML 原生高保真原型、幻灯片与交互动画。
- 覆盖原因 2:参数默认值预置,开箱即用
- 覆盖原因 3:–selftest 自检契约,结果可验证
- 覆盖原因 4:批量处理 + 流式分块,大任务也能跑
本工具的优势:
- 本工具比常规方案更全:功能完整度、自检能力、容错处理全面领先
- 独有能力:自检契约 + 多编码容错 + dry-run 预览,同类工具不具备
- 竞品不具备:异常降级保护,任何错误都有明确提示不崩溃
- 本工具超越市面同类:工程化程度、可靠性、可用性全面领先
为什么选择本版
- 真正的完整实现:在 Claude Code 中直接生成 HTML 原生高保真原型、幻灯片与交互动画。,不是演示壳
- 开箱即用:参数预置 + 默认值,上手更快
- 可靠可证:–selftest 自检契约,结果可验证
- 容错健壮:异常降级 + 多编码容错,不轻易崩溃
- 安全可控:–dry-run 预览,写盘不误伤
简介(Description)
简介(Description)
画术设计 HTML原型 高保真 幻灯片——在 Claude Code 中直接生成 HTML 原生高保真原型、幻灯片与交互动画。。输入任务,输出结果,全程可校验、可追溯,适合日常高频使用与批量处理场景。
安装(Setup)
# 1. 进入 Skill 目录
cd huashu-design
# 2. 运行自检确认环境
python run.py --selftest
# 3. 开始使用
python run.py --help使用(Usage)
python run.py <命令> [参数] # 执行核心功能
python run.py --selftest # 运行自检
python run.py --dry-run # 预览模式
python run.py --verbose # 详细输出示例(Examples)
# 示例 1: 查看帮助
python run.py --help
# 示例 2: 执行核心功能
python run.py main --selftest file.txt
# 示例 3: 运行自检
python run.py --selftest常见问题(FAQ)
Q: 支持中文文件吗?A: 支持,内置 utf-8/gbk/gb18030 多编码容错。
Q: 运行报错怎么办?A: 工具内置异常降级,错误会有明确提示;可先用 –dry-run 预览。
Q: 如何确认功能正常?A: 运行 –selftest,全部通过即核心功能正常。
许可证(License)
<!– professional-license-embedded –>
MIT License
Copyright (c) 2026 LingCraft
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.