Communitygithub.com

tsumu-build-site(创建Tsumu网站)

设计技能。从零创建一个全新的、可编辑的Tsumu网站或着陆页,支持多页面、响应式和动画设计,并自动为用户提供一次性Tsumu导入链接。不用于修改现有网站。

tsumu-build-site(创建Tsumu网站) 是什么?

这是一个用于在Tsumu平台中创建全新、可编辑网站的专业设计技能。它采用两阶段工作流:首先进行自由设计,生成原创的网站概念和布局(包括信息架构、页面内容、排版、颜色和响应式行为),然后将该设计转换为原生的Tsumu SiteDoc格式。该技能支持多页面、响应式布局和动画,但不限于简单的模板替换,强调生成具有独特视觉识别和内容的网站。它适用于Tsumu MCP工具集,并严格遵循`stage_site_doc`生成的导入链接交付方式,确保链接保密且仅用于一次性导入。技能要求用户在设计之前先使用`get_site_doc_spec`参考规范,避免猜测数据结构。最终交付物是一个可编辑的Tsumu SiteDoc(JSON对象),并通过安全的私有导入链接交付给用户。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abshrimp/tsumu-mcp/tree/HEAD/plugins/claude/skills/tsumu-build-site

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

创建一个新的Tsumu网站

当用户要求在Tsumu中制作一个新网站时使用。交付物是一个真实、可编辑的Tsumu网站,不是设计描述、截图、HTML模拟或空网站。

交付物:一个私有的Tsumu导入链接

对于用户请求的新网站,stage_site_doc的成功结果会包含一个importUrl。这是请求者用于在Tsumu中打开生成的网站的交接工件。需提供该精确链接并附上构建内容的简要描述;无需额外请求该链接。该链接是私有的,不应复制到日志、无关上下文或第三方服务。切勿捏造或重构它。

分阶段的链接并非导入、发布或部署的证明。不得声称这些操作已发生。

选择工作流

  • 创建新网站: 直接使用stage_site_doc,即使没有关联现有网站。用户可以在MCP OAuth界面中授权仅创建新网站,无需站点连接代码。已有的已配对站点授权也可能支持创建新网站。
  • 改为编辑用户的现有网站: 激活tsumu-edit-site并使用配对的编辑器工具。不要复制现有网站或覆盖它。
  • 没有分阶段工具或未成功授权: 不要捏造URL。如果工件创建可用,则生成一个有效的可下载doc.json文件;否则解释缺失的能力以及可以做什么。
  • create_site用于在已配对的编辑器中创建一个浏览器本地的空站点。它不会上传完整的生成设计,需要重新配对新建的站点。不要将其作为stage_site_doc的替代品。

两阶段创建:自由设计,然后转换为Tsumu

第一阶段——在操作SiteDoc格式之前创建一个原创网站概念。 将用户的请求视为网站设计简报,而不是重新装饰示例JSON文档的指令。

  1. 确定网站的目的、受众、关键信息、页面、内容优先级和主要用户操作。对于模糊的请求(例如“创建一个漂亮的网站”),独立选择一个独特、合理的概念,而不是默认使用示例组合或提出不必要的问题。不要编造真实的地址、推荐语、产品声明或价格。
  2. 仿佛Tsumu节点模式不存在一样设计网站。 设计出原创的信息架构、逐页内容、章节构成、层级结构、排版、颜色、图像或图形元素、间距和响应式行为。避免机械地重复通用的英雄区/功能特性/推荐语/联系方式模板。
  3. 当工具和时间允许时,将完整设计草拟为独立的HTML/CSS原型(并附上清晰的交互说明)以自由探索布局。否则准备同样具体的页面和组件蓝图。这是中间设计工件,不是最终交付物,也不代表Tsumu可以通过stage_site_doc导入任意HTML。如果不可用,则不需要实时预览。
  4. 对照简报审视草稿:是否有可识别的视觉身份、可信的内容、有目的的章节、清晰的用户路径和移动端布局?在查阅示例SiteDoc布局之前完善它。

第二阶段——将该设计转换为原生的、可编辑的Tsumu SiteDoc。 现在才查阅get_site_doc_spec、模式指南和最小示例,以了解有效的数据形状,而不是决定网站的外观。使用Tsumu支持的原生元素、样式、资源和交互重新构建设计的页面和布局。保留中间设计独特的构成、排版、间距、内容和响应式意图,而不是将其简化为重新着色的示例。如果某个细节不受支持,则将其调整为最接近的有效可编辑表示形式,或披露限制;切勿发明模式字段。

原创性检查: 在分阶段之前将转换后的SiteDoc与第一阶段设计进行比较。如果最终站点本质上是修改了文字、颜色或图像的捆绑示例,则转换失败:重新设计结构和构成。如果用户明确要求特定模板,则遵循该请求。

将原始设计转换为SiteDoc

在构建任何SiteDoc之前: 调用只读MCP工具get_site_doc_spec并检查其guide和example。在规划好原始设计之后,但在创建任何SiteDoc页面、节点、样式、脚本或首次尝试stage_site_doc之前执行此操作。新建站点OAuth授权后即可获得参考。不要仅仅因为加载了Skill文本就跳过它;某些MCP客户端不会自动获取参考。如果规范工具不可用,则改为阅读references/site-doc.md和references/minimal-site.json。切勿猜测数据形状。

  1. 将第一阶段的网站页面映射、内容和构成转换为SiteDoc。不要从示例JSON开始并替换其副本或调色板。 指南和示例仅描述有效的属性和关系。对于高级功能,请查阅当前的Tsumu lib/types.ts、lib/presets.ts、lib/site-import-format.ts和skills/tsumu/references/site-doc.md(如果可以访问)。
  2. 构建一个完整的SiteDoc对象(而不是JSON字符串、HTML页面或压缩文件)。必需字段:schemaVersion: 1、非空的siteName、pages、pageOrder、nodes、assets。首页的slug为""。页面和节点的children引用节点ID;节点是可编辑的box、image等。文本和标题使用box.text,而不是虚构的heading节点。
  3. 创建与设计结构匹配的有意义的原生页面布局。为节点赋予合适的语义标签、样式和响应式覆盖。保留第一阶段的实际层级结构、间距、排版对比度、视觉强调和章节变化。检查导航目标、替代文本、对比度和移动行为。避免损坏的资源、空链接、占位符内容和屏幕外元素。
  4. 如果设计包含动画、脚本、组件或表单行为,请查阅确切的当前类型定义并仅实现支持的结构。脚本元素目标使用目标节点的HTML attrId,不是其SiteDoc节点ID;@self仅用于附加到元素的脚本。检查每个嵌套步骤和条件。不要发明运动或脚本属性,也不要将惰性按钮描述为功能性按钮。
  5. stage_site_doc仅接受完整的SiteDoc作为doc(序列化JSON最大12 MiB)。它不接受第一阶段HTML原型、ZIP或单独的二进制资源。尽可能使用assets: {},在合适时使用经过验证的外部图片,或在限制内使用小型嵌入式dataUrl资源。不要发明Tsumu存储路径。
  6. 对照原始设计检查生成的SiteDoc,而不是对照示例的美学标准。确保它保持完全可编辑且结构有效;如果转换丢失了独特的布局或内容,则在分阶段之前改进原生元素层级。

验证并交付

  • 在分阶段之前,将最终页面与第一阶段设计进行比较,并确认它们是忠实、独立构建的网站,而不是重新装饰的最小示例。保持设计中间件私有,除非用户要求;交付SiteDoc或导入链接作为最终结果。
  • 在分阶段之前,确保每个可见的设计声明都放置在nodes[id].styles.base.default或相关的响应式覆盖中,而不是虚构的style、css或className字段。实际的CSS声明值必须是字符串。检查ID、引用、无环树和导入规则。在工具允许的范围内检查页面层次结构、响应能力和请求的交互。除非您确实预览过,否则不要说自己预览了。
  • 调用stage_site_doc({ doc: <完整SiteDoc> });仅当用户请求特定的自托管Tsumu安装时才使用editorOrigin。
  • 成功的新网站交接包括工具的精确importUrl作为请求者的可点击链接,以及一个简短说明,即打开该链接会导入一个新的可编辑网站。该链接不是已发布网站的URL。
  • 如果失败,请说明实际错误,并避免声称网站已保存。不要用虚构的链接替换失败的工具操作,或悄悄切换到现有网站。
  • 该链接在其URL片段中包含私有访问令牌,有效期为一小时,并在Tsumu确认成功导入后被消耗。不要将其透露给他人。失败的导入可在临时五分钟声明租约到期后重试。

交接示例(仅作说明): “可编辑的咖啡馆网站已准备好导入。私有Tsumu导入链接下一小时内有效。”实际操作时,交接包括分阶段成功时工具生成的真实链接。

相关技能