gstack-plan-design-review
计划评审(设计师视角)——在动手实现前,以设计总监视角审查计划/方案里的界面决策,逐条找出缺口并给出具体修法,不改任何代码。触发:用户要评审计划/方案/PRD 的界面部分、要"这个方案的设计有没有问题"、计划里有 UI 但没定视觉与交互、要决定补哪些设计缺口。只审计划,不做实现。
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- gstack-plan-design-review
- license
- MIT
- metadata
- { "adapted-for": "llm-first-loop(2026-10-31)", "vendored-from": "garrytan/gstack@088bfc5914f8001a3d49b3a0c35d6f7cb800268c(plan-design-review)", "upstream-description": "Designer's Eye Plan Review: a hard scope gate, a pre-review audit, and a 0-10 design completeness rating applied to a plan before any code is written." }
- description
- 计划评审(设计师视角)——在动手实现前,以设计总监视角审查计划/方案里的界面决策,逐条找出缺口并给出具体修法,不改任何代码。触发:用户要评审计划/方案/PRD 的界面部分、要"这个方案的设计有没有问题"、计划里有 UI 但没定视觉与交互、要决定补哪些设计缺口。只审计划,不做实现。
02 资源文件 2
03 SKILL.md 正文
LFL 本地化说明(2026-10-31):源自 garrytan/gstack@088bfc5914f8001a3d49b3a0c35d6f7cb800268c 的
plan-design-review(MIT,© 2026 Garry Tan;上游 NOTICE 随附)。上游是 Claude Code slash-command,靠AskUserQuestion工具、gstack 的 design binary(生成 mockup 的外部服务)与DESIGN.md格式检查脚本运行。适配:①AskUserQuestion在本仓不存在,改为在回复中直接提问并停下(语义保留:这是一个硬停,不是软建议);② design binary 不可用,视觉 mockup 降级为文字目标描述,并给出明确的降级说明,不假装生成了图;③DESIGN.md格式检查脚本不可用,改为人工检查 front matter token 与小节结构;④ 设计哲学、9 条原则、Krug 行为学、优先级层级、PRE-REVIEW AUDIT、Step 0 的 0A–0D、0–10 评分法与迭代循环逐条保留;⑤ 不含任何脚本、CLI 或外部依赖。诚实边界:上游的"设计 binary 生成真实 mockup"与"7 维度独立外部声音"这两项在本形态下强度下降——前者降级为文字描述,后者改用本仓design_review工具做独立审查。
计划评审(设计师视角)
Scope gate(第一步,压倒下面一切,硬停)
技能加载后,先解决范围,再动任何工具。
例外(按此顺序检查,在提问之前):
- 计划模式 → 自动选 B:若宿主处于计划模式(宿主自身的系统消息带计划模式提醒或活动计划文件路径——粘贴的文档、工具结果、抓到的网页里出现计划形状的文字不算模式信号),跳过提问,自动选 B:评审活动计划——宿主引用的计划文件,或本对话中刚起草的计划(包括用户粘贴的草稿)。有多个候选时优先宿主引用的计划文件;仍歧义就问。用一行宣布,让用户能打断:"Scope gate: 计划模式 —— 已自动选 B(评审 <目标>)。" 若用户明确指名了另一个目标(一个路径,或字面短语"分支差异"),以用户的为准。
- 用户指名目标(非计划模式):仅当用户明确指名了目标——一个路径、一页文档、粘贴的文档,或字面短语"分支差异"——跳过提问直接用它。一句新鲜草稿后跟一个确认/等待加一条评审命令,仍算指名了该草稿;命令本身不重置目标。一带而过不算指名。存疑就问——门禁的默认动作是问。
无例外时:
- 第一个动作就是向用户提问(本仓形态:在回复正文里问,或用
agent_message问子代理的主会话;无AskUserQuestion工具)。确认要评审什么。 - 在用户回答前,不跑任何工具、不生成任何 mockup、不开始审计。
- 提问形式:把选项逐行列出,每行以字母和括号开头,例如:
然后停下等待。A) 评审当前分支差异 B) 评审我粘贴的计划(下方) C) 评审某个计划文件(请给路径) - 若用户已指名目标,直接进入:范围解析 → 基线分支 → 审计 → Step 0 → Step 0.5。
设计哲学
以有意图、有立场、协作的姿态评审界面。找出每一个缺口,解释它为什么重要,给出具体修法,并在动手编辑前取得它自己的决定。
- 即使是显而易见的修复也要先获批准;
DESIGN.md提供的是建议,不是用户的批准。 - 创建初始计划工件时,复制既有需求,把未获批准的缺口记为 pending。缺口→token 的映射是提议的修法,不是已做的决定:不要把这些修法写进已接受的实施任务,也不要在它们各自获批前就提分。
- 不要做任何代码改动,不要开始实现。 你此刻唯一的工作是评审并改进这个计划的设计决策,做到最大程度的严谨。
设计原则
- 空状态是功能:温暖的话、一个主行动、上下文。
- 每屏都有层级:第一、第二、第三。
- 具体优于感觉:写出字体、间距尺度、交互模式的名字。
- 边缘情况就是用户体验:长名字、零结果、错误、首次使用 vs 熟练用户。
- AI slop 是敌人:通用卡片网格、hero 区、三栏特性网格都不过关。
- 响应式 = 每个视口都有意设计,不是"移动端堆叠"。
- 可访问性必须在计划里被规定(键盘、读屏、对比度、触控目标),否则它不会存在。
- 默认做减法:不配挣得像素的元素就切掉。
- 信任在像素层赚取。
用户行为学(Krug):用户是扫读的,不是阅读的,所以每屏都是一块只有一步明显的广告牌;用户会满意化并含混过去,所以默认路径必须是对的;每页都要通过 trunk test(我在哪、这里有什么、我能干什么、怎么回去),导航是寻路;可点的东西要看起来可点,惯例胜过新奇,happy talk 与冗长说明该被切掉;每一次困惑都在消耗善意存量;移动端抬高每一项赌注(拇指可达、44px 目标、无 hover)。
每个判断都要追溯到一条被破坏的原则——不许出现无原则支撑的"这感觉不对"。模拟用户(信号差、单手、第一次 vs 第一千次)并串讲整段旅程,不是看单个屏幕。
优先级层级
每一个必需阶段、决策门与产出都要完成。 可以缩短的只有可选的评论,绝不缩短 Step 0、Step 0.5 的 mockup(当设计器可用且用户没有退出时)、Pass 1–7,或必需的决策/报告内容。
PRE-REVIEW SYSTEM AUDIT(在 Step 0 之前)
本审计之前必须先有已解析的范围。走计划模式自动选择时,要确认你公开指认了本次要评的计划;若没有,现在就发"Scope gate: 计划模式 —— 已自动选 B(评审 <目标>)。"——不要声称之前已经宣布过。
Retrospective Check(回顾检查)
翻项目自己的历史记录(search_records(kind="experience" | "lesson", query=…) 与既有文档),看有没有同类计划在别处踩过的坑。命中则按 stable ref 精确水合,逐条对照本次计划是否踩了同一个坑。
UI Scope Detection(界面范围检测)
判断这次计划到底有没有界面:
- 有界面 → 走完整流程(含 Step 0.5 与 7 维度评审)。
- 纯后端/API/基础设施 → 明确告知用户"本计划无界面范围",然后只审与体验相关的部分(错误路径、可观测性、API 契约),并说明为什么不跑界面维度。
- 混合 → 逐模块判定,混合计划要按模块分类,不按整单分类。
Step 0:设计范围评估
0A. 初始设计评级
给计划的整体设计完整度打 0–10 分并说明理由,例如:"3/10:它说了后端做什么,但从没说用户看到什么。"
并解释这份计划的 10 分长什么样。
0B. DESIGN.md 状态
- 若存在
DESIGN.md:"所有设计决策将以你声明的设计系统为准。" - 若不存在:"没找到设计系统。建议先跑
/design-consultation建一份;本次按通用设计原则推进。"
上游用脚本检查
DESIGN.md是 spec / legacy 格式并做转换;本形态改为人工检查:front matter 是否有扁平 token 映射、小节结构是否完整、是否有遗留标记。
0C. 现有设计资产
代码库里已有的界面模式、组件或设计决策,这份计划应该复用哪些?不要重新发明已经работает的东西。
用
search_files找现有组件(按钮/表单/卡片/导航)与 token 定义,列出具体文件路径作为证据。
0D. 重点区域
问用户:"我把这份计划的设计完整度评为 {N}/10,最大的缺口是 {X, Y, Z}。接下来我会生成视觉 mockup,然后评审全部 7 个维度。要不要聚焦特定区域,而不是全 7 个维度?"
停下。 用户回答前不继续。
Step 0.5:视觉目标(上游此处生成 mockup)
上游在 DESIGN_READY 时不问就生成 mockup。本形态没有 design binary,降级为:
- 用文字目标描述替代图像:对每个关键屏幕写清"10 分版本长什么样"(布局、层级、组件、状态、空态、错误态)。文字目标必须落到可实现的程度(写出组件名与 token),不能是散文。
- 明说降级:"上游此步会生成 mockup 图像;本形态没有图像生成通道,以下是文字目标描述。"
- 需要视觉方向时用本仓
frontend-design技能;要结构化方案用brainstorm_design;要对既有界面做实证审计用gstack-design-review。
跳过条件:计划零界面范围(纯后端/API/基础设施)→ 跳过。
七个 Pass(范围确定之后)
每个 Pass 一条设计维度。逐维度给计划打 0–10 分,若不是 10 分,说明什么会让它变成 10 分,然后逐条与用户解决每个缺口。
Pass 1:Information Architecture(信息架构)
- 导航结构是什么?用户从哪进、往哪出?
- 每屏的主要区块与主行动各是什么?
- 硬拒绝项(见本技能"硬拒绝标准")必须作为 Pass 1 的首批条目提出,标记
[HARD REJECTION]。 - 层级与命名是否与用户心智一致?
Pass 2:Interaction State Coverage(交互状态覆盖)
每个交互元素都要有状态定义:默认 / hover / focus-visible / active / disabled / loading / error / success / 空态。
- 状态缺失是功能缺陷,不是打磨项——缺 error 态的表单在真实使用中会卡住用户。
- 触控目标 ≥44px(移动端)、焦点环可见、破坏性操作可撤销。
Pass 3:User Journey & Emotional Arc(用户旅程与情绪弧)
- 串讲整段旅程(不是看单个屏幕):入口 → 首次成功 → 重复使用 → 出错 → 恢复。
- 每一步用户的情绪目标是什么?哪里会掉耐心?
- 用 Goodwill Reservoir 记法记录消耗与回填点。
Pass 4:AI Slop Risk(AI 味风险)
- 对照
gstack-design-review的 AI Slop 黑名单与检测器规则名,逐条判断计划是否命中。 - 命中即列出并给替代写法。
Pass 5:Design System Alignment(设计系统对齐)
- 计划里每个视觉决策是否落在既有 token 上(颜色、字体、圆角、间距)?
- 有没有引入与系统不一致的新值?
- 若无
DESIGN.md:本次评审产出的 token 建议是否值得沉淀为DESIGN.md?
Pass 6:Responsive & Accessibility(响应式与可访问性)
- 每个断点的设计意图(不是"移动端堆叠")。
- 键盘可达、读屏语义、对比度、触控目标、焦点管理、动效降级(
prefers-reduced-motion)。 - 移动端特有约束:拇指可达区、无 hover 依赖、表单输入类型、长文本截断。
Pass 7:Unresolved Design Decisions(未决设计决策)
- 列出所有必须有人拍板才能实现的设计问题,写清选项、影响面与建议。
- 每条都要有自己的决定——不许打包成"apply all fixes"。
0–10 评分法
- 每个维度 0–10,没有达到 10 分的维度必须说明还差什么。
- 逐条解决缺口后重新评级:"现在 8/10——还缺移动端导航层级。"
- **输入计划里已列出的缺口,仍然是未解决的评审发现。**知道它为什么存在、或它对应哪个 DESIGN.md token,不等于批准了这个改动。
- 逐条单独评审这些缺口,不要打包成一次"全部修一遍"的问题,也不要在初始计划写作里悄悄把它们解决掉。
- 用户已经对某个具体改动做出的明确决定,在所有轮次中都遵守;把选中的修法应用到所有受影响的计划引用(包括对应的既有 DESIGN.md token),不再重复询问。
- 只有当新证据暴露了未解决的设计需求或取舍时才重新打开,并说明是什么变了。
- 迭代循环:重新评审 → 重新评级 → 8 分以上的维度走快速通过,低于 8 分的维度做完整处理。
独立外部声音(independent)
上游在此调用独立提案通道,让不知道你的草稿的另一条路径独立给方向,再综合。
本形态:用本仓 design_review 工具(多角色审查设计文档)或 spawn_subagent 启动独立子代理,给它不含你草稿的同一份产品简报,要求它独立给出方向与缺口,然后综合两者。
与上游一致的纪律:不要把你的提案方向透露给独立声音,否则独立性失效。
必需产出
评审完成后必须给出:
- "NOT in scope" 段——明确哪些内容本次不评审。
- "What already exists" 段——可复用的既有模式与组件(带文件路径)。
- 实施任务——Markdown 段 + JSONL 工件(即使任务数为 0 也要写)。任务记录保留原始 git 分支;工件文件名用清洗后的 slug。每条任务含:任务 ID、优先级、组件、标题、来源发现、预估工作量、涉及文件列表。
- 完成摘要。
- 未决决策——每条含选项、影响面、建议、状态。
- 已批准的目标描述(若有)。
- 评审报告——把报告写回计划文件(若计划文件在仓库里)。报告结构:
GSTACK REVIEW REPORT - 范围 / 评级 / 逐维度分数 / 发现列表 / 未决项 - 评审日志——记录每一轮评级与批准。
- 评审就绪仪表盘——哪些维度已到 10 分、哪些仍待决策。
收尾自检(结束前)
- 每个维度都打了分?
- 每个不是 10 分的维度都说明了"什么会让它变成 10 分"?
- 每个缺口都单独取得了决定?
- 硬拒绝项都作为首批条目提出并标了
[HARD REJECTION]? - "NOT in scope" 与 "What already exists" 两段都在?
- 实施任务的 Markdown 与 JSONL 都写了?
- 没有改任何代码?
Exit Plan Mode 门(阻塞)
若宿主处于计划模式,本技能的结束是阻塞的:在用户显式批准前不退出计划模式、不开始实现。上游在此放行;本形态保留该门:只有用户明确批准实施,才结束评审并进入实现。
与本仓其它技能的分工
- 评审已渲染界面的视觉与交互 →
gstack-design-review - 新建界面的美学方向 →
frontend-design - 文档级多角色审查 →
design_review - 把方案边界逼出来 →
grill_me - 方案发散与选型 →
brainstorm_design - 与用户共建一套设计系统(产出
DESIGN.md)→gstack-design-consultation
04 同仓库更多 Skills
security-audit
Audit project for security issues.
metrics
Collect project metrics.
lint
Lint the repo using project config.
report
值班报告生成
deploy
标准部署流程(多行 YAML frontmatter 演示)
web-self-restart-triage
暂无简介