Communitygithub.com

从零创建前端界面(andreischuaste12-ctrl / create-frontend-from-zero-konv…

根据产品需求说明书和目标受众,从空白项目或明确请求的新界面开始,经过交互设计、实现到渲染验证,最终构建一个功能完整、可访问且可验证的前端界面。适用于落地页、商城、仪表盘或应用界面等全新构建场景。

create-frontend-from-zero-konv… 是什么?

该技能(named: create-frontend-from-zero-konvert)专为需要从零开始构建全新前端界面的开发者或AI智能体设计。它覆盖从产品需求澄清、交互设计、技术选型、代码实现到渲染验证的完整流程,确保最终交付的功能界面可运行、可访问且经过实际验证。技能明确界定了协作边界:当任务是创建新前端时它主导执行;若需要审计现有界面则使用 audit-frontend-designer-konvert;若需参考现有设计进行重构或优化则使用 design-por-referencia-konvert。工作流分为六个阶段:理解需求、定义具体方案(含状态与组件清单)、规划构建(复用现有框架/组件/令牌,白项目时选择最简合适栈)、实现(包含语义结构、样式、交互与辅助功能)、验证(本地运行、检查核心任务、导航、键盘焦点、响应式布局、对比度等)、交付报告(记录变更、决策、验证结果和已知限制)。技能内置隐私与安全约束,禁止读取 .env 或凭证,使用合成数据,并强制只有核心任务在约定的范围内端到端可运行时才算完成交付。支持多个参考文档和示例(如调研简报模板、电商简报模板、交付报告模板)辅助执行。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/andreischuaste12-ctrl/frontend-designer-konvert/tree/main/skills/create-frontend-from-zero-konvert

在你喜欢的 AI 中提问

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

文档

从零创建前端界面

将产品需求转化为可运行、可访问且可验证的界面。此技能主要负责在空白项目或明确要求的新区域中构建全新前端。它实现代码、在可行时运行项目,并报告实际验证过的内容。

边界与协作

  • 全新前端: 此技能主导执行,即使有参考帮助引导原创设计也是如此。提取设计原则,但不得复制第三方的品牌、内容或资产。
  • 审计现有界面: 请使用 audit-frontend-designer-konvert,它仅为只读模式。如需“审计并修正”,则先运行该技能,之后遵循审批合约。
  • 应用参考、直接优化现有界面或实施已批准的审计报告: 请使用 design-por-referencia-konvert 并遵守其范围、审批及外部依赖规则。
  • 在混合项目中,仅实现被授权的全新区域;识别并保留现有集成与界面。请参阅协作指南,以利用其他技能的知识和工具而无需重复。

流程

  1. 理解请求与上下文。 阅读项目说明、相关文件、现有技术栈和约定。识别产品、目标受众、主要任务、页面、数据、品牌标识、限制条件以及交付位置。区分已知事实与假设;不得虚构用户画像或研究成果。如果某个不可缺少的选择无法推断且会产生不可逆影响,则请求澄清;对于其他决策,申明假设后继续推进。将结果记录在探索与简报中。
  2. 确定具体方案。 选择相关的用户旅程和状态:初始态、加载态、空态、成功态、错误态及恢复态(若适用)。使用状态与组件按屏幕列出组件和状态,并将审计单元作为完成标准。对于多页面或多类别项目,使用内容结构与导航定义路径。定义与目标受众和目标一致的内容、层次结构、导航和视觉方向,并根据视觉基础确定设计令牌。当两个选项会显著改变最终结果时,使用视觉方向探索。利用现有本地材料,并在可用且相关时使用审计的知识单元和目录。仅引用实际查阅过的参考资料。视觉参考是灵感来源,而非可用性证据。
  3. 规划构建。 复用现有框架、路由、组件和令牌。在空白项目中,根据技术栈选择选择最简方案以匹配请求和环境;论证新依赖项,在运行前验证版本和脚本。不得假设已获得付费服务、发布、外部账户或真实数据的授权。根据请求保持后端范围、身份验证和集成;如果未提及,则使用合成数据并明确标明限制。
  4. 实现。 在授权范围内构建实际的内容、语义结构、样式、组件和交互。避免看似有功能但实则无行为的按钮或虚假链接:要么实现所请求的动作,要么明确表明其不可用。使用一致的令牌、可见状态和响应式布局。应用内容、SEO、性能与度量规则:虚构内容需标明,公共页面需基本SEO,未经请求不添加分析工具。参考安全与前端本地化以保护前端,当产品涉及多语言或多区域时,根据已定义的语言环境调整界面。未经必要性和适用授权,不得删除或替换用户代码、数据、集成或文件。
  5. 验证。 执行适用于项目的检查,尽可能在本地运行界面并打开渲染结果。检查主要任务、内容、导航、键盘操作、焦点、表单、相关状态、窄屏和桌面显示;评估对比度和减少动画(若适用)。当参考技能有可用脚本时,使用其脚本,输出授权结果和合成数据。对于没有先前版本的全新创建,不得捏造前后对比:记录首次截图作为初始参考,仅对比实际存在的状态或版本。参阅验证。
  6. 交付与报告。 检查完成定义并使用其中的报告模板。报告变更的文件、相关决策和假设、如何运行、已执行的检查及其结果、模拟的功能以及无法验证的内容。在授权输出目录中,将任务、检查区域、决策和已验证的标准记录到 execution-record.json 中,遵循执行记录及其验证器。不得存储私有 URL 或提示。未经证据,不得声称进行了用户测试、完全合规性、性能或商业成果。如果浏览器不可用,则明确说明界面未经过视觉检查。

隐私与安全

仅使用授权目标和环境。不得读取或暴露 .env、凭据、会话或不必要的个人数据;使用合成内容并在分享前审查截图。尊重捕获工具的保护和限制:检查会执行 JavaScript,不是不受信任网站的沙箱。仅将产物写入已授权且被 Git 忽略的目录,或者写入检出目录之外;未经必要,不得更改项目隐私配置。不得向第三方发送数据、创建账户或未经授权发布。

质量标准

界面应以清晰性、视觉层次、一致的内容和有用的反馈来支持主要任务。根据上下文关注语义、焦点、无障碍名称、标签和内容重排;不得仅凭自动检查就声称无障碍认证。不得捏造转化指标、用户评价、认证徽章、价格、集成或功能。更倾向于在范围内提供一个完整且可测试的实现,而不是外观令人信服但操作失灵的界面。

完成定义

仅当主要任务在约定范围内端到端可运行,且完成定义中的每一项要么已完成、要么有理由不适用、要么因故未检查时,交付才算就绪。从零创建时最容易出错的点:

  • 正常状态之外的状态(加载、错误、空、成功、恢复)无法被观察;
  • 焦点被移除或遮挡,标签仅出现在占位符中,错误仅通过颜色指示;
  • 对比度和触摸目标未在渲染中进行测量;
  • 看似有行为但实际上不工作的按钮和链接;
  • 捏造的商业数据、用户评价或集成;
  • 在无明确决策记录的情况下添加分析工具或外部字体。

参考资料与示例

材料何时使用
探索与简报构建前:带模板的问题和假设记录。
技术栈选择空白项目,无定义平台。
视觉基础可验证的对比度、目标和焦点的令牌与约束。
视觉方向探索原创方向、实质性选项及渲染确认。
内容结构与导航新项目中的路径、标签和页面组织。
状态与组件按屏幕的清单,审计单元作为完成标准。
内容、SEO、性能与度量公共页面、巴西格式、Core Web Vitals 与隐私。
安全与前端本地化可变内容、外部资源,以及(若适用)多语言或多区域。
验证如何执行并记录检查。
协作何时使用审计工具和执行工具。
完成定义与交付在报告交付之前查看。
落地页简报、电商简报和交付报告期望详细程度的合成示例。

相关技能