Communitygithub.com

Argus

设计技能。用于设计、构建、重构、润色或审查任何框架中的网站和移动应用页面——落地页、仪表盘、应用界面、组件、表单、设计系统。适用于任何涉及可见界面创建或修改的请求,包括“为X构建页面”、“添加设置界面”、“让这个更好看”或“看起来太普通”,以及已经有设计风格的项目的UI新增。不适用于仅后端工作、独立图表或幻灯片。

Argus 是什么?

Argus 技能是一个全面的设计助手,专为需要处理用户界面视觉表现的AI代理而设计。该技能基于四条核心设计原则:设计师无法直接看到自己生成的作品,因此必须通过构建、查看渲染结果并迭代修复;第一想法往往是陈词滥调,需要从外部获取输入(现有系统、用户反馈、参考素材);评判能力优于生成能力,因此应制作粗略的备选方案,通过视觉对比选择;新页面容易变得平庸且单薄,因此每个新页面应聚焦一个想法、一个大胆的动作,并完成一个完整的论证。它支持Web、iOS、Android等平台,处理营销、运营和阅读三类界面,并能根据任务类型——从简单的微调、命名命令到全新的页面创建或完整重设计——自动选择最佳的设计路径。每次设计都会进入“构建 → 查看 → 检查 → 使用 → 修复”的循环,并强制遵循无障碍最低标准(对比度、焦点、触控目标、减少动效等)。最后生成包含上下文的简洁报告,记录发现、方向、查看内容、修复项、假设和待办事项。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hamza-Masuadi/argus-skill/tree/HEAD/skills/argus

在你喜欢的 AI 中提问

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

文档

Argus 是做什么的?

你懂得设计规则。有四件事容易出错,本技能专门解决每个问题:

  1. 你看不到自己生成的东西。 因此要构建、查看渲染结果、修复,再查看。
  2. 你的第一想法是所有人的第一想法。 因此要从外部获取输入:现有的系统、用户说的内容、用户展示的内容。
  3. 你评判的能力优于生成的能力。 因此对于新工作,要制作粗略的备选方案,并通过查看来选择。
  4. 你会倾向中庸和单薄。 因此新页面应聚焦一个想法、一个大胆的动作,并完成一个完整的论证。

1. 查看现有内容

在开始其他任何操作之前,先找出并用一句话陈述以下内容:

  • 平台:Web,或移动应用(iOS、Android,或两者兼顾)。阅读项目,切勿假设。
  • 界面类型:说服型(营销、落地页、橱窗)、运营型(仪表盘、工具、管理后台、应用界面)或阅读型(文档、文章)。
  • 现有系统:DESIGN.md、主题或令牌文件、共享组件、两三个已完成界面。
  • 用户提供的内容:截图、链接、Logo、品牌色、字体、照片。

使用项目已使用的框架和约定进行实现。

2. 选择唯一合适的路径

使用匹配的第一行。仅读取它命名的文件。

任务执行读取
微调:一个组件、间距或颜色修复进行修改并查看。不提问,一行报告不需要,或它涉及的 craft.md 的一部分
命名命令(polish, audit, typeset, colorize, animate, simplify, variants)遵循命令references/commands/<name>.md 及其命名的内容
“审查这个”或“评价这个”报告,不修改任何内容review.md, laws.md, verify.md
“让这个更好看”、“看起来太普通”——针对现有界面找出真正的问题,然后在现有风格内修复extend.md 第3节,然后是 commands/polish.md;若有一个明显的弱点,使用对应的命令
已有风格的项目中的新页面或组件扩展现有风格。不进行方向性工作,不提问extend.md;对于运营型界面添加 product.md;对于原生应用添加 mobile.md
无匹配风格的全新运营型界面询问简要说明是否开放,然后构建ask.md, product.md, craft.md;若为原生应用则添加 mobile.md
无匹配风格的全新说服型或阅读型界面询问简要说明是否开放,然后执行完整流程ask.md, create.md(其中引入 structures.md 和 ingredients.md), web.md 或 mobile.md;若图片主导销售或提供了照片则添加 photos.md
用户明确要求的重新设计视为新工作,保留内容和行为对应的新工作流程行,加上 extend.md 第1节以盘点必须保留的元素

每个包含构建步骤的路径最终都会进入下面的循环,并参考 slips.md 和 verify.md。微调仅需查看即可。

更改现有产品的身份需要明确的请求。如果没有,“让它更突出”意味着在现有风格内做得更好。

3. 提问(仅限新工作)

当简要说明未明确目标受众、期望的感觉或用户需要展示的内容时,在设计前提问:一轮,最多四个关于产品的问题,每个问题可跳过,不涉及字体或颜色。对于新页面,还要询问第一个页面应围绕什么构建(你为此主题提出的三个方法),以及他们想并排查看多少个方向(1、3或5个,推荐3个)。ask.md 中包含这些问题。跳过简要说明或 DESIGN.md 已经回答的问题。

如果没有人可以回答,陈述每个假设并继续。切勿陷入循环等待。

4. 循环

  1. 构建第一个真实版本。
  2. 查看。 渲染并捕获宽度为 320、390 和 1440 像素的效果(对于原生应用,使用手机大小的模拟器或设备)。在再次阅读代码之前,写下可见的内容。
  3. 检查是否违反 slips.md 中的规则。运行适用的脚本(参见 verify.md)。
  4. 使用它。 点击主按钮、填写表单、用 Tab 键遍历它、在手机宽度下找到导航。
  5. 修复发现的问题并再次查看。进行两轮,然后报告剩余问题。

如果无法渲染任何内容,则说明情况,改为检查源代码,且不能认为工作已通过验证。对于涉及整个页面或界面的重大工作,若存在子代理,则将截图交给一位未看过你推理过程的新审阅者;其修复算作两轮中的一轮。

始终保持的规则

  • 谁的指令优先:用户的明确指令优先;然后是现有系统;然后是用户的回答和参考资料;然后是你编写的方向;最后是此技能的编号和列表。无障碍最低要求不会被你的个人品味或此技能的偏好覆盖。用户要求的内容永远不会被报告为缺陷。
  • 真实内容。 不使用占位文本(lorem ipsum),不编造证据:推荐语、客户、Logo、评分、使用人数。页面需要的事实(如价格、试用条款)可以使用合理的替代内容,但必须在代码注释中标记并在报告中列出。演示、目录或仪表盘中的示例数据在使用具体数据时是可接受的,且必须在界面上标记为“示例”。
  • 重设计绝不改变行为。 保持字段名称、id、链接、事件处理函数、表单动作、测试钩子和无障碍属性。
  • 构建所有可能出现的状态,以及所有状态。必做:按下和禁用状态;悬停和键盘焦点状态(只要有指针或键盘的地方)。加载、空状态和错误状态(只要有真实加载、可能为空或可能失败的内容)。切勿仅为了拥有加载状态而构建网络请求。
  • 无障碍最低要求:文本对比度 4.5:1;可见的键盘焦点;控件至少 24px,触摸屏上为 44pt / 48dp;提供减少动效的路径;放大文本时不得丢失信息。craft.md 包含具体数字,laws.md 包含确切标准。
  • 验证意味着已查看。

报告

Found:     平台、界面类型、现有系统、用户提供的内容
Direction: 一句话描述(新工作),或重用了什么以及添加了什么(扩展)
Looked:    渲染了什么,在哪些宽度下,手动使用了哪些内容
Fixed:     循环中捕获的问题
Assumed:   替代事实和示例数据,按类型分类,或者“无”
Open:      未完成或未检查的内容,以及指南要求标记的任何内容

保持在这些行内。微调只需一行。

文件

文件用途
ask.md提问环节
create.md全新的说服型或阅读型工作:想法、大胆动作、粗略备选方案、方向
structures.md可供选择的页面结构,使备选方案在形状上有所不同,而不仅仅是颜色
ingredients.md每个方向都需要填充的令牌角色,以及颜色、字体、形状和空间的选项
extend.md在现有风格内工作
product.md运营型界面:仪表盘、工具、应用界面
photos.md照片主导的页面
web.md, mobile.mdWeb 页面或手机屏幕上的布局指南
slips.md按界面类型列出的实际常见错误。每次查看时检查
verify.md如何捕获、检查和审查;辅助脚本
craft.md所有数字:字体、颜色、空间、动效、目标尺寸
laws.mdUX定律支持和不支持的内容;常见误区
tells.md常见的生成设计缺陷
review.md, design-md.md评价格式;记录决策

所有文件均在 references/ 目录下。

此技能中的所有路径(references/...、scripts/...、assets/...)都是相对于包含此文件的文件夹,而非用户的项目文件夹。在 Claude Code 中,该文件夹为 ${CLAUDE_SKILL_DIR}。运行脚本时,请使用其完整路径,例如 node "<此技能文件夹>/scripts/lint.js" <目标>。

相关技能