Argus 是做什么的?
你懂得设计规则。有四件事容易出错,本技能专门解决每个问题:
- 你看不到自己生成的东西。 因此要构建、查看渲染结果、修复,再查看。
- 你的第一想法是所有人的第一想法。 因此要从外部获取输入:现有的系统、用户说的内容、用户展示的内容。
- 你评判的能力优于生成的能力。 因此对于新工作,要制作粗略的备选方案,并通过查看来选择。
- 你会倾向中庸和单薄。 因此新页面应聚焦一个想法、一个大胆的动作,并完成一个完整的论证。
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. 循环
- 构建第一个真实版本。
- 查看。 渲染并捕获宽度为 320、390 和 1440 像素的效果(对于原生应用,使用手机大小的模拟器或设备)。在再次阅读代码之前,写下可见的内容。
- 检查是否违反
slips.md中的规则。运行适用的脚本(参见verify.md)。 - 使用它。 点击主按钮、填写表单、用 Tab 键遍历它、在手机宽度下找到导航。
- 修复发现的问题并再次查看。进行两轮,然后报告剩余问题。
如果无法渲染任何内容,则说明情况,改为检查源代码,且不能认为工作已通过验证。对于涉及整个页面或界面的重大工作,若存在子代理,则将截图交给一位未看过你推理过程的新审阅者;其修复算作两轮中的一轮。
始终保持的规则
- 谁的指令优先:用户的明确指令优先;然后是现有系统;然后是用户的回答和参考资料;然后是你编写的方向;最后是此技能的编号和列表。无障碍最低要求不会被你的个人品味或此技能的偏好覆盖。用户要求的内容永远不会被报告为缺陷。
- 真实内容。 不使用占位文本(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.md | Web 页面或手机屏幕上的布局指南 |
slips.md | 按界面类型列出的实际常见错误。每次查看时检查 |
verify.md | 如何捕获、检查和审查;辅助脚本 |
craft.md | 所有数字:字体、颜色、空间、动效、目标尺寸 |
laws.md | UX定律支持和不支持的内容;常见误区 |
tells.md | 常见的生成设计缺陷 |
review.md, design-md.md | 评价格式;记录决策 |
所有文件均在 references/ 目录下。
此技能中的所有路径(references/...、scripts/...、assets/...)都是相对于包含此文件的文件夹,而非用户的项目文件夹。在 Claude Code 中,该文件夹为 ${CLAUDE_SKILL_DIR}。运行脚本时,请使用其完整路径,例如 node "<此技能文件夹>/scripts/lint.js" <目标>。