Skip to content

feat(design): 引入 DESIGN.md 设计 token SSOT + 状态覆盖 + 8 维交付自查#2

Merged
pcliangx merged 1 commit into
mainfrom
feat/uiux-optimization
Jun 17, 2026
Merged

feat(design): 引入 DESIGN.md 设计 token SSOT + 状态覆盖 + 8 维交付自查#2
pcliangx merged 1 commit into
mainfrom
feat/uiux-optimization

Conversation

@pcliangx

Copy link
Copy Markdown
Owner

背景

借鉴 xianxin-design-workflow 的设计工作流,把其中与 AGF 哲学最契合的价值点引入 uiux-designer 体系。补齐 AGF 此前缺的「项目级设计系统 SSOT」一层。

P0 — 项目级设计 token 单一来源

  • 🆕 docs/design/DESIGN.md:设计 token SSOT(YAML 机读 color/typography/spacing/radius/component + on-* 对比安全配对 + Do/Don't + 最小组件覆盖)
  • uiux-designer spec 改为引用 token、禁内联硬编码色板/间距
  • coding.md 增「设计 token 纪律」(与前后端/Apple 契约纪律同构)
  • code-reviewer 增「设计 token 审查项」(硬编码/on-* 配对/token 在册三查)
  • 同步:CLAUDE.md 设计交付物路径约定、repo-layout.mdteam-capability-map.md 主要输出列

P1 — 状态完整性 + 设计侧前置门

  • spec 新增「页面/模块状态覆盖」:loading / empty / error / permission(AGF 此前真正缺的产品态)
  • 原型「覆盖关键状态」扩成 组件视觉态 + 产品态,空态不得白屏
  • 新增「交付前自查(8 维)」:把 xianxin 8 验证维度落成 designer 交付前自检门
  • testing.md「视觉达标」状态口径扩成全状态 —— 刻意不改「读图四查」术语(跨 6+ 文件既定词汇),8 维(设计前置门)与四查(qa 验证)互补不重叠

闭环

DESIGN.md(token SSOT)→ designer 引用 token + 全状态覆盖 → 8 维自查门 → frontend-dev 禁硬编码 → code-reviewer token 审查 → qa UAT 读图四查(全状态验证)

验证

  • lint-all.sh 全过、roles 无 drift
  • ✅ DESIGN.md YAML 合法、on-* 配对零缺口、4 个最小组件齐全
  • 仅改 agent body,未碰 frontmatter 生成物

注:本 PR 只含 UIUX 优化;评审发现的模板加固(verdict-hook 误伤 / hook 安全洞)走独立 fix/agf-hardening 分支。

P0 — 项目级设计 token 单一来源:
- 新增 docs/design/DESIGN.md(YAML token + on-* 配对 + Do/Don't + 最小组件覆盖)
- uiux-designer spec 引用 token、禁内联硬编码
- coding.md 增「设计 token 纪律」;code-reviewer 增「设计 token 审查项」
- CLAUDE.md / repo-layout / team-capability-map 三处同步

P1 — 状态完整性 + 设计侧前置门:
- spec 新增「页面/模块状态覆盖」(loading/empty/error/permission)
- 原型要求扩成组件态+产品态;新增「交付前自查(8 维)」
- testing.md「视觉达标」口径扩成全状态(保留「读图四查」术语不改)

借鉴 xianxin-design-workflow 的 DESIGN.md token 体系与 8 维验证框架。
@pcliangx pcliangx merged commit 2e31130 into main Jun 17, 2026
2 checks passed
@pcliangx pcliangx deleted the feat/uiux-optimization branch June 17, 2026 13:43
pcliangx added a commit that referenced this pull request Jun 17, 2026
rule #4 的 sk-ant- 排除原为整段 prompt 级(scan-secrets)/ 整行级(scan-commit):
prompt 或同一行里只要出现裸字符串 sk-ant-,同处真 OpenAI key 即被静默放行。
"同时讨论 OpenAI 与 Anthropic 两家 key" 是很自然的场景。

- scan-secrets.sh rule #4:改 grep -oE 抽取每个 sk- token,再过滤 ^sk-ant-
- scan-commit.sh rule #4:同改(layer-4 与 layer-2 同步,防 Edit/Write 绕过)
- 真 sk-ant- key 仍由 rule #3 优先拦(更具体 message),逻辑不变
- 加 2 条回归用例(真 OpenAI key + 裸 sk-ant- 文本须拦 / 仅讨论前缀须放行)

注:本提交含假 key 测试夹具,触发(已修好的)scan-commit 自身拦截,
--no-verify 记录见 docs/reviews/no-verify-log-2026-06-17.md(security.md §紧急绕过)。

评审 P0-1(QualityExpert finding #2,已复验)。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant