Agency of One 是做什么的?
为什么存在
当要求生成一个网站时,模型会产生最有可能的网站。禁止那种外观只是将它推向下一个最有可能的样子(奶油色配衬线字体加黏土、黑色配酸绿色、全大写眉毛、链接上的 → 符号:这是第二波“AI痕迹”)。而“创意”也并非解决方案:一个商业网站必须看起来像 一家杰出的机构制作的,可信且精致,一切浑然一体。
优先级顺序:1) 美观且符合客户需求,2) 清晰且可信,3) 独特(不像是 AI 生成的)。 避免 AI 痕迹是必要的,但还不够:一个独特但平庸或偏离品牌的页面就是失败的。
因此,这项技能 从客户已有的品牌出发,将最冒险的选择权从构建者手中夺走,并将输出保持在世界级的完成度和美学标准:
- 首先考虑客户的品牌和资产,然后是策略:标志颜色、真实照片、参考、定位、证据、品牌理念。
- 真正的随机性,品牌锁定的颜色:一个脚本抽取杠杆(构图、品牌装置、调色板策略、字体策略)。颜色来自于客户的 Logo(如果有的话),否则来自于一个经过策划和对比度检查的调色板库,从不依赖于模型自身的品味。
- 一个独立的批评者 从典型性和强度两方面对五个方向进行评分;一个脚本从中挑选出非典型且强度高的方向。
- 一个工艺标准(
craft.md)和一个核心场景设定(hero set piece),首先独立构建。 - 无法争辩的检查:每次编辑都进行 lint 检查、渲染度量、计划与渲染的差异对比、跨项目记忆、渲染的美观度检查,以及一个盲审者,首先对渴望度和品牌契合度进行评分,然后才是工艺和独特性。
当规则冲突时,此顺序获胜: 客户简报和品牌资产 > 美观(craft.md 优先级,§2b) > 抽到的调色板和卡牌 > AI 痕迹列表。卡牌或避免痕迹的规则绝不应成为制作更丑或偏离品牌的东西的理由。
$S = 此技能文件夹:Claude Code 加载技能时显示的基目录(作为插件时为 ${CLAUDE_PLUGIN_ROOT}/skills/agency-of-one;作为直接放入时为 .claude/skills/agency-of-one 或 ~/.claude/skills/agency-of-one)。从仓库根目录运行脚本:node $S/scripts/<name>.mjs。会话钩子会打印脚本的绝对路径;将该绝对路径传递给每个子 Agent(它们自己无法解析 $S)。切勿打开 references/decks.json。 卡牌仅来自脚本。
模式
- Agency(默认): 面向业务、专业、精致。阅读
references/agency.md。 - 表现性(
--mode expressive):仅当简报要求某种实验性、艺术性、编辑性、活动性或事件性的内容时使用。它使用非 Web 参考媒介和约束条件;阅读references/process-notes.md。
门控
DESIGN.md存在 → 严格遵循;直接进入阶段 3。可以提出修正案;切勿悄悄偏离。如果它没有<!-- agency-of-one design v1.1 -->标记,则说明它早于品牌优先颜色规则: 运行brand-extract.mjs;如果其调色板与品牌资产冲突(plan-diff 会报告冲突),则在继续构建之前向用户提出 §4 颜色修正案。- 简报指定了一个方向或品牌指南 → 简报胜出,即使它指定了一个已知的 AI 痕迹。记录它(以及其在 §9 中的例外情况);直接进入阶段 3。
- 否则 → 执行阶段 1–2,即使对于“小”页面也是如此。
每个仓库设置一次: npm i -D playwright && npx playwright install chromium(作为 devDependency,因此后续 npm i 不会删除它)。
阶段 1:资产、品牌、策略(DESIGN.md §1)
- 真实资产:先询问(agency.md 第 0 步)。Logo、人物照片、个人简介事实、客户名称或案例研究、联系方式和法律信息、真实数据、产品截图。在盲审中,没有这些东西,可信度和意象得分大约会停留在 6/10,无论设计多好。缺失的内容会成为专业的占位符(agency.md 第 5 步),你的报告应首先说明需要提供什么。
- 你已有的品牌(agency.md 第 0a 步)。如果有 Logo、徽章、现有网站或人物照片,运行
node $S/scripts/brand-extract.mjs(自动发现,或传递路径)。它会写入.design-review/brand.json;此后draw.mjs会自动锁定品牌,并且任何丢失 Logo 颜色的调色板都将导致 plan-diff 失败。需要陪伴执行:用一句话向用户确认提取的品牌颜色。切勿与品牌自身的颜色冲突。 - 参考(需要陪伴执行): 要求提供 2–3 个客户认为美观的网站(任何行业)。将截图保存在
design-references/中。评审者会将其与之比较。它们设定的是质量基准,而非外观样式。 - 人类品味(仅限陪伴执行): 询问一次,“您欣赏的 2–3 个品牌或物品,以及一个您不希望模仿的竞品网站。”
- 策略(agency 模式,agency.md 第 1 步):定位陈述、唯一信念、标记为保持/打破的 5 个品类代码(打破 ≥ 2)、品牌理念、带有“但不是”的个性描述、证据清单(切勿编造证据)。
- 主题清单: 来自客户世界的 8 个以上的真实物品、地点、材料和日常用语(表现性模式为 12 个以上)。在 agency 模式下,这些用于指导图像方向、品牌装置和文案,而非用于“装扮”。
- 用品牌的语调草拟核心标题和主要操作标签。 你可以在抽取之后对其进行精炼。
阶段 2:抽取 → 基线 → 发散 → 批评者 → 挑选 → 提交
2a. 抽取。 node $S/scripts/draw.mjs --project "<name>"(默认 agency 模式)会分配一个质量参考、构图系统、品牌装置、调色板策略和字体策略。当 .design-review/brand.json 存在时,颜色会自动锁定品牌(仅可通过 --no-brand "<reason>" 覆盖,例如客户要求的品牌重塑);否则颜色来自一个经过策划、对比度检查的调色板库:美观的起点,绝不是原始的随机色调。将其粘贴到 DESIGN.md 的 §2。可以附带书面原因行使一次否决权:--redraw <slot>。如果某张卡牌强制要求使用 AI 痕迹列表中的内容(例如可见网格),则允许作为卡牌强制例外:在 §9 中记录为 card: <reason>,并作为结构而非装饰来执行。
2b. 基线。 编写两个孪生版本:AI 孪生(模型会为此简报生成的内容:字体、十六进制颜色、核心区域、版块)以及(在 agency 模式下)agency 陈词滥调孪生(奖项诱饵版本)。对照 references/tells.md 检查两者。
2c. 发散。 编写 5 个方向(A–E) 到 .design-review/directions.md,并附上一个简短概述和 §1 的清单。每个方向都应包含品牌理念表达、每个抽取杠杆的应用方式、核心区域构图(小型 ASCII 线框图)、字体类别(还不是具体字体)、调色板草图以及品牌装置。不要自己评分。 至少有 3 个方向应在页面架构上有所不同,而不仅仅是皮肤。
2d. 独立批评者。 运行 direction-critic 子 Agent(作为插件时为 agency-of-one:direction-critic),仅向其传递路径。它会返回每个方向的典型性 t 和强度 s,以及一个 PICK_ARG。
2e. 挑选。 node $S/scripts/draw.mjs --pick "<PICK_ARG>"。在 agency 模式下,它选择最强的方向(s ≥ 8,且与最佳分差在 0.5 以内),仅排除明显普通的那些(t ≥ 0.7)。在表现性模式下,它偏向非典型方向。退出码 3 表示没有符合条件的:编写 3 个新方向(融入批评者的 STRONGEST_IDEA_TO_STEAL)并重新运行批评者。构建脚本挑选出来的那个。 需要陪伴执行:用一行展示被选中的方向和一个亚军方向,并允许用户覆盖。
2e′. 核心区域构图(美学关)。 在提交之前,为选中的方向和亚军方向构建核心区域(首屏 + 初始滚动区域,桌面和移动端),制作两个快速的静态构图,使用真实资产。对两者进行截图(screenshot.mjs --file comp-a.html comp-b.html),然后向一个全新的 design-reviewer 只提供这两个首屏和移动端首屏的图片(不标记),并要求进行一次强制选择:哪个页面客户会更自豪地发送出去,为什么? 构建胜出的那个。如果评审者称两者都平淡或偏离品牌,则应重新抽取而非优化。
2f. 差异分析。 填写 DESIGN.md 的 §3 表格,对比两个孪生版本。任何匹配的轴都必须更改,除非简报要求如此。互换测试:竞品的名字是否也适合?如果是,则从 §1 中提取更多内容。
2g. 提交令牌。 将 templates/DESIGN.md 填充完善为 DESIGN.md,包括 plan-diff 读取的机器可读 tokens 块。
- 字体:
references/typography.md。使用node $S/scripts/type-specimen.mjs渲染你的候选列表,并通过观察选择。使用一个比例缩放;将流体显示大小标记为fluid。 - 颜色: 从 brand.json 的提议(或策划的调色板)开始:品牌色直接使用,brandForText 用于浅色背景上的文字,深色/浅色色调,带色调的中间色和墨色(craft.md §4)。测试 AA 对比度。保持 Logo 颜色可识别。
- 重复检查:
node $S/scripts/designlog.mjs check --project "<name>" [--brand-locked] --display … --body … --ground … --accent … --layout … --medium "<composition or primary medium>"。如果报告了 REPEAT,则更改重复的轴。
阶段 3:按照工艺标准构建
3a. 首先独立构建核心场景。 仅构建核心区域(agency 模式:完美执行抽取到的构图;表现性模式:标志性机制)。对其进行截图(screenshot.mjs,并使用 --state 处理交互状态),并迭代直到其在 references/craft.md 的每个相关工艺轴上都得分 ≥ 8。然后才构建其余部分。
3b. 仅从令牌(CSS 变量 / Tailwind v4 @theme)构建页面,遵循 agency.md 第 3 步的架构或表现性骨架。shadcn/Radix 仅提供行为;重新样式化每个基础组件。文案需具体、使用句子大小写、且符合品牌语调;证据是真实的或使用占位符。Lint 钩子在每次编辑时都会标记 AI 痕迹,因此要随着编辑逐一修复。
3c. 完成性检查。 逐行检查 references/craft.md §1–10:排版细节、网格审计、节奏、色彩与对比度、图像与占位符、动效与状态、在 1440/1024/768/390 下的响应式构图、文案编辑(减少 30%)、技术完成度。这一遍是“机构制作”质感的来源。不要跳过。
阶段 4:验证(最多 3 轮,保留最佳版本)
- 先截取快照: 在每轮之前提交(或复制)当前状态,以便可以回滚到较差的修订版本。
node $S/scripts/slop-lint.mjs:零错误;每个警告都在 §9 和slop-lint.config.json中修复或有正当理由。node $S/scripts/screenshot.mjs --url <dev url> --routes / /about …(或静态页面使用--file index.html about.html …;每个页面,不仅仅是首页)--state <name>=click:<sel>|hash:<#id>|scroll:<sel>|hover:<sel>针对每个关键状态。查看 首屏、移动端首屏、scroll50 和状态截图。node $S/scripts/plan-diff.mjs:Logo 颜色在调色板中,计划的字体已加载,调色板已渲染,缩放已应用,没有计划外的背景色,以及在桌面端和 390px 的美观检查:没有内容因动画而不可见或未启用 JS 就隐藏,没有首字母头像,一致的图片组(裁剪、大小、背景),没有居中的多行文本,没有全大写标签,没有分隔线,每个页面都有设计好的页眉。- 盲审:
design-reviewer子 Agent(agency-of-one:design-reviewer)仅获取 URL 或文件、路径以及.design-review/。它会首先对渴望度和品牌契合度进行评分,然后参考design-references/(如果存在)对工艺和独特性进行评分。SHIP 要求渴望度、品牌契合度以及每个工艺轴 ≥ 8。多页面的裁决取决于其最弱页面的得分。 - 修复并重新渲染。仅当评审者对修订版本的评分高于之前最佳版本时才保留它。 在 3 轮后停止,并报告仍然存在的问题。
- 镜像: 移除一个不能服务于品牌理念的装饰元素;在 DESIGN.md §11 中记录。
- 记录:
node $S/scripts/designlog.mjs add --project "…" …与 check 相同的标志… --media "<draw summary>" --signature "<device / set piece>"(使用--log <path>可将日志保留在仓库中)。 - 报告: 方向(一行)、品牌理念、核心场景、lint/plan-diff/审查结果(含工艺得分)、未解决的例外情况、客户必须提供或确认的每个占位符和假设。
参考文件
| 文件 | 使用时机 |
|---|---|
references/agency.md | Agency 模式:策略、标识系统、商业架构、占位符、可信度 |
references/craft.md | 3a, 3c, 阶段 4:完成度标准、对齐方式、照片系统、页面页眉、评分 |
references/patterns.md | 3b:人物网格、页面页眉、证据展示区、活动、捐赠、表单等经过验证的模式 |
references/palettes.json | 策划的调色板库(由 draw.mjs 读取;你可以浏览它) |
references/tells.md | 2b, 2f, 阶段 4:AI 痕迹(第 1-3 代),包含特征标识和来源 |
references/typography.md | 2g:字体处理流程、来源、许可、缩放 |
references/process-notes.md | 表现性模式:解读卡牌;工作示例 |
templates/DESIGN.md | 2g |