Communitygithub.com

测验网站构建器

从自然语言创建、改进或部署移动优先的交互式测验网站:中文性格/角色匹配、生存/故事、优势测试、题库、确定性评分、可分享结果、验证、GitHub 源代码发布和 Cloudflare Pages 部署。当用户想要构建在线测试或测验时使用。默认不包含支付或卡密代码。

测验网站构建器 是什么?

该技能(SKILL.md)指导 AI 代理与用户协作或自动创建完整的、可部署的互动测验网站。它支持多种测验类型,包括性格/角色匹配、生存/互动故事和优势诊断,并确保结果确定且可分享。工作流程围绕用户共创(探索创意、设计测试、确定风格)或高效的“一键生成”模式展开,设计批准后可自主开发。该技能强制要求清晰的架构分离:由 GitHub 托管源代码,由 Cloudflare Pages 处理网站部署。它严格执行中国本土化合规性,避免使用海外字体、CDN 和分析工具,优先使用系统字体和本地打包的资源。关键的设计原则包括:默认不包含付费墙或卡密,在用户明确要求之前保持无后端、纯前端的状态,并确保所有 UI 在低端移动设备 (320px+) 上也能完美运行。该技能通过 `references/` 目录下专门的参考文档来指导验证、发布和可选的访问控制架构,而非通过提示工程,从而使设计决策和实现细节清晰分离。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/jinceci9-netizen/quiz-site-builder/tree/HEAD/skills/quiz-site-builder

在你喜欢的 AI 中提问

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

文档

测验网站构建器 — 可移植代理技能

与用户共同构思测验概念,然后将商定的设计转化为一个经过打磨、测试、准备部署到 Cloudflare Pages 的网站。本技能遵循供应商中立的 Agent Skills 文件夹格式;绝不要求任何特定的代理产品或供应商特定工具。始终区分 GitHub 源代码托管 与 Cloudflare 网站部署;本技能自身的仓库和每个生成的测验网站的仓库是独立的。

请先阅读

  1. 在接触文件之前,检查用户的工作目录。不要覆盖现有项目、文件、设置或部署。
  2. 在共同创造过程中,主动提出方案而非默默地修复机制;在完全实现之前,需要确认或接受委托:
    • 性格/角色匹配: 维度 → 确定性类型/角色匹配;说明平局处理方式。
    • 生存/互动故事: 有序决策 → 跟踪状态变量和检查点 → 可达结局。
    • 诊断/优势: 自然轻松感 + 消耗 + 高峰体验 → 可解读的优势和行动建议。
  3. 阅读 references/quiz-design.md 了解问题、结果和分数平衡。阅读 references/visual-and-copy.md 了解主题写作和设计。阅读 references/mainland-readiness.md 再选择字体、图片或依赖。阅读 references/qa.md 再宣布完成。阅读 references/publishing.md 了解通过 GitHub 部署到 Cloudflare Pages 的流程(当被要求部署时)。
  4. 在获得批准的发展阶段,从头开始:复制完整的 assets/starter/ 到一个新的网站目录;绝不直接修改可复用的启动器。启动器包含 3 个示例测验、一个类型化评分引擎、响应式视图和结果分享。在编辑组件之前,先自定义 src/data/*.json。
  5. 默认无付费墙。 除非用户提出,否则绝不引入支付、卡密、Cloudflare Workers、身份认证、D1 或 KV。如果要求访问码,请阅读 references/access-codes-optional.md 并指导用户通过安全的架构实现;不要默默实现或部署会产生费用的服务。

默认模式:用户参与共创

默认采用共创模式,即使初始请求是“制作网站”或列出开发任务。首先明确创作方向;不要立即生成完整的题库、复制启动器或构建整个网站。复用用户已给出的选择,而不是再次询问。允许检查现有文件和准备有边界的方案。

按顺序经历这三个阶段,通常每个响应一个阶段。每个阶段提供具体的建议,并且总共最多提出 1-2 个关键问题;不重复已经回答过的问题。在每个代理上使用普通聊天;绝不能强制要求使用可选表单。

  1. 探索创意 — 针对用户主题提供 2-3 个有意义的、不同的角度,每个角度都需要有吸引点、目标受众和独特的体验。倾向于一个独特的玩家紧张感和一个令人难忘、可诚实分享的结果,而不是未经证实的病毒传播说法。如果用户明确要求不同的数量(例如,五个想法),请尊重它,而不是强行给出 2-3 个。推荐其中一个并解释原因。询问开发哪个角度,最多附带一个能实质性改变概念的问题。
  2. 设计测试 — 用通俗语言呈现提议的算法(状态/维度、选择如何影响它们、检查点/平局以及结局如何选择)、结果类型及其差异,以及 2-3 个带有选项和解释权衡的完整示例问题。推荐一个适合已确认角度的机制;询问是否采纳它或改变关键的权衡点。示例是提议,不是完整的题库。
  3. 确定风格 — 提供 2-3 个具体的视觉方向,包括调色板、排版、手机流程和 3:4 分享卡片处理;推荐一个。展示一个代表性的结果报告草稿,包括标题、解读、优势、代价和建议。询问视觉选择和最终确认整合后的设计,最多两个问题。在用户确认设计或明确委托剩余决策之前,不要开始全面开发。

在每个阶段结束时,显示一个简洁的决策记录:已确认的选择、AI 推荐但仍待确认的选择以及剩余的决策。将委托/跳过的选择记录为“AI决定”或“跳过,采用建议”,绝不能记录为用户选择的偏好。在对话中携带此记录向前;在批准后将其保存到生成网站的 docs/DESIGN.md 中。当用户修改决策时,更新记录,并且仅重新审视受到实质性影响的提议,而不是所有阶段。

在每个阶段,用户可以修改、跳过它,或要求 AI 决定。“跳过这一步”仅委托该阶段:记录推荐的默认值并进入下一阶段。“你决定剩下的”委托所有剩余选择:简要记录选定的设计并继续实现。沉默或超时不视为批准。当需要输入时,在相关阶段停止;不要将未回复视为允许构建。

一键生成

当用户说“直接做”、“一键生成”、“你来决定”,或明确要求跳过所有设计讨论并立即构建时,为当前请求切换到一键模式。说明选择的默认值,并自主地通过内容、逻辑、UI、验证和本地预览进行,无需经过三个对话关卡。现有的用户约束仍然适用。用户可以随时切换回共创模式。先前明确的设计批准也允许自主开发,无需重复各个阶段。

设计批准或一键模式授权了所请求的开发和调试,而非无关的外部操作。保留所请求的仅限本地的界限;GitHub 发布和 Cloudflare 部署仍然需要用户意图和可用的授权。

端到端工作流程

1. 将用户的想法转化为可用的产品规格

在共创模式中,完成上述三个阶段并在实施前整合他们的决策记录。在一键模式中,选择并简短说明这些默认值,无需等待。包含一句话吸引点、目标受众、问题数量(默认约 10-16 个)、结果类别、机制、权衡、主题/颜色方向、手机流程和分享卡片创意。如果未指定,默认创建一个免费、匿名、静态的网站,本地保存进度。不要再次询问已确认的选择;在共创模式中,将提议的默认值标记为“建议”,直到被接受或委托。永远不要将娱乐性人格测试描述为科学诊断。

2. 设计批准或委托后,在 UI 之前编写测验内容和逻辑

自主提供完整的题库,而不是占位样本,并实现/调试已批准的网站,无需询问常规的技术决策。使用叙述性问题,并带有看似合理且非显而易见的选项。保持 src/data/*.json 作为规范的测验数据。对于每个人格/诊断选项,仅引用已声明的轴。对于生存模式,danger 和 influence 必须是有限的整数状态效果,事件按顺序排列,并且多个结局在现实中是可达的。测试失败和成功的路径;防止一种“总是选择最安全答案”的利用方式。对于授权媒体/命名作品,将可验证的情节事实与虚构情况分开。在宣称真实时间线之前,查阅可靠来源或用户提供的参考资料;如果不可用,说明差距并提出一个原创的替代方案供用户选择。不要将对命名作品的请求视为复制其图片、对话或宣传素材的许可。检查使用权限,不要捏造确切的情节时间线。

3. 构建有吸引力、中国友好的静态 UI

默认使用启动器中的 Vite + React + TypeScript,设置 base: '/' 以适配 Cloudflare Pages。保留:每次只显示一个问题、进度条、返回、恢复、重新开始、键盘支持、320px 及以上的手机端、分享链接预览和 3:4 分享卡片导出。避免运行时依赖 Google Fonts、远程图片 CDN、第三方脚本/SDK、海外 API 和客户端分析。打包静态资源;使用安全的系统字体回退方案。永远不要提交密钥或将 API 密钥置于前端代码中。确保结果确定性。默认无支付/卡密。

4. 验证功能和本土化合规性

执行以下命令,调整路径:

python3 <skill-root>/scripts/validate_quizzes.py <website>/src/data
python3 <skill-root>/scripts/audit_mainland_assets.py <website>
cd <website>
npm install
npm test
npm run build

然后手动验证:介绍页、后退和前进、刷新/恢复、多个结局路径、分享 PNG/URL、移动端布局和对比度。参见 references/qa.md。不要声明任何您未实际运行的检查。未经在中国大陆网络上的实际测试,不要声称本土可访问性。

5. 引导上线 — 将代码发布到 GitHub,用 Cloudflare Pages 部署网站

在本地预览后,用通俗语言解释 GitHub 存储代码,Cloudflare Pages 使网站可在线访问;在工具无法执行时,引导用户进行账户或控制台操作。尊重仅限本地的请求,并在已获得授权的地方不再重复请求授权。按照 references/publishing.md 操作。默认路线:为生成的网站建立独立的 GitHub 仓库 → Cloudflare Pages 连接到 Git → Vite/React npm run build / dist / 生产环境 main 分支 → 部署 → 设置自定义域名进行推广 → 在声称就绪前测试 HTTPS / 从中国大陆网络加载。启动器中的 GitHub Action 仅用于检查;Cloudflare 的 Git 集成负责部署。

如果用户想将本技能本身发布到 GitHub,请单独发布此跨代理技能仓库。在没有用户意图和可用授权的情况下,绝不创建账户、购买域名、连接仓库、推送或部署。如果不可用,请提供可操作的命令和控制台步骤,而不是虚假的“已发布”声明。Cloudflare Pages 标准全球计划无法保证中国大陆的可达性;如果硬性要求未通过测试,建议符合要求的中国大陆托管选项/ICP 备案(视情况而定)。不要将 Cloudflare 的企业级中国网络与免费 Pages 混淆。

产品原则

AI 负责拓展创意的可能性,用户负责决定作品的独特性,AI 负责把决定变成现实。 Creative choices belong to the user unless delegated; routine technical execution belongs to the Agent. A narrow delegation such as “配色你来决定” applies only to that decision, not to all remaining stages.

核心不变原则

  • 算法准确,结果可达且可区分;除非用户要求,否则不使用随机结果。
  • 不伪造临床有效性;不作笼统的“中国可访问”承诺。
  • 未经请求不添加后端、登录、跟踪、支付、代码锁或敏感数据收集。
  • 代码共享不是部署。新的测验网站应有自己的仓库和域名。
  • 仅前端的代码锁不安全。如果要求访问码锁定,建议采用服务器端验证并处理秘密结果;保持其为可选功能。
  • 遵循用户现有的品牌、视觉、事实和选择。

调用示例

  • “用 quiz-site-builder 和我共创一个宫廷生存测试,先给我几个创意切口。”

  • “直接做一个10题原创宫廷生存测试,本地预览,不部署。”(一键生成)

  • “用 $quiz-site-builder 帮我做国风人格测试,六衡分析、器物人格、手机端,并部署到 Cloudflare Pages。”

  • “做10题原创宫廷生存测试,分支结局、3:4结果卡,发布到 GitHub 后由 Cloudflare 自动上线。”

  • “帮我把测试网站准备给国内用户用,不依赖国外字体或 CDN,教我绑定自定义域名并检查访问。”

  • “我暂时不需要收费或卡密,只告诉我之后怎么扩展卡密。”

跨代理执行规则

  • 所有指令路径如 references/quiz-design.md 和 assets/starter/ 都是相对于包含此 SKILL.md 的文件夹 (<skill-root>) 的,绝不能相对于硬编码的 Codex 目录。
  • 使用当前宿主代理实际提供的文件操作、shell 和浏览器功能;不要假设存在 apply_patch、Codex 工具或特定的 MCP 服务器。当某个工具缺失时,提供可移植的命令或手动步骤,并清晰标记未完成的步骤。
  • 项目的真实来源是 skills/quiz-site-builder/。切勿将技能逻辑复制或分叉到特定提供商的副本中。适配器安装仅复制相同的文件夹。
  • Codex 调用可能使用 $quiz-site-builder;WorkBuddy、Claude Code、CodeBuddy Code 和其他代理可能使用技能选择器或普通语言。不要在 Codex 之外要求使用 $ 语法。
  • 永远不要仅仅因为某个代理导入了该技能,就声称它支持某项功能。在运行部署步骤之前,确认本地文件访问权限、Python、Node/npm、Git 以及进行身份认证的能力。
  • WorkBuddy 导入使用一个包含 quiz-site-builder/SKILL.md 文件夹根的 zip 文件。WorkBuddy 应从该文件夹加载 references/、scripts/ 和 assets/。如果宿主沙箱阻止脚本运行,请说明限制,但仍然生成静态网站代码。

宿主相关的部署约束

无论使用哪个代理:GitHub 存储源代码,Cloudflare Pages 是默认的部署目标;在用户可以授权的地方使用 Cloudflare Git 集成。可选的卡密架构仅是指导性说明;绝不静默地添加付费墙、支付或包含密钥的前端检查。中国大陆的访问需要经过实际网络测试,标准 Cloudflare Pages 或自定义域名无法保证。

相关技能