Astrofy Design 是一项用于设计 Astro 页面或组件外观与交互的技能。使用前应先阅读项目的技术集成说明,项目本地指令和已有设计令牌优先于库内示例。
工作模式 文中出现的表达式是向智能体提出的请求,而不是 Astrofy 命令行工具的子命令:
- astrofy-design build:输入需求简报、已批准内容和项目文件,交付已实现并检查过的界面。
- astrofy-design study:输入给定的 URL 或图片,进行视觉分析,不修改页面。
- astrofy-design audit:输入页面、组件或目录,指出问题并提出修改建议,不直接编辑。
- astrofy-design redesign:输入现有界面和期望变更,在保留路由与功能的前提下重做构图。 若未写动词,且请求是创建界面,则默认使用 build。仅给出一个 URL 并不授权复制页面或替换项目;当对话未说明目标时,应确认是研究还是实现。
计划与执行 先给出简短计划,说明涉及文件、交付物和验证项。在读完项目、提出构图方案和在浏览器中检查后分别汇报进度。结束时说明改动、执行的命令以及未能完成的检查。 需阅读项目说明、Git 状态、路由、组件,以及存在时的 .astrofy/config/paths.json 配置,区分孤立组件、页面和一组路由。还需阅读现有视觉约定、已批准内容和 .astrofy/design/log.json 中的历史记录;跨页面共享的身份优先于独立项目之间的主题轮换。按模式加载相应流程:创建读构图流程、结构与宏观结构;研究读参考分析与可移植规格(如要求);审计读审计、应避免的模式与视觉检查;重设计读重设计、结构与视觉检查。只阅读当前工作所需的主题、组件和技术。若仍有未定选择,应在实现前先呈现构图方案,并遵守已授权范围和已记录的偏好。
实施与边界 在现有 Astro 结构中实现视觉层,保留处理逻辑、表单、集成、已批准内容和全局 CSS 导入。检查渲染后的页面、交互状态和令牌,记录发现的问题及修复内容,不以评分作为验收。技能内置的技术库保留原始语言,但新的交付物、文档和注释应使用巴西葡萄牙语,并保留项目中使用的 API 名称、CSS 属性和技术术语。库中的文案指导不替代本地编辑规则;不得编造证言、客户、数字或结果,如需新文案应遵循项目编辑流程。示例仅展示构图可能性,不得强加与已批准身份或可访问性相冲突的字体、颜色、动效或不对称布局;不得通过隐藏溢出来模拟响应式,应修正超出视口的元素宽度;不得为了让布局成立而使操作不可访问。审计或研究时在对话中呈现结果,仅在要求时保存报告;创建 design.md 需要导出请求,或属于已授权的多页面重设计;不得覆盖现有视觉约定,已确认的偏好无需因库内建议重复询问。
最终验证 按范围检查 320、375、414 和 768 像素以及一个桌面宽度,测试键盘、焦点、缩放、对比度、主题、错误状态和 prefers-reduced-motion。若无可用浏览器,应将视觉检查记录为待办;仅阅读 HTML 不能证明渲染结果。执行项目声明的构建和检查命令;对使用 Astrofy 初始化的项目,还应检查令牌和设计规则。
适用场景 适用于在 Astro 项目中新建界面、分析参考站点或图片、审查现有界面问题,以及在保留路由和功能的前提下重设计界面。
限制 资料仅描述该技能的流程与约束,未提供独立安装命令、收费信息、平台支持范围或效果数据;这些事实暂未提供。