Skip to content
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,14 @@
},
"metadata": {
"description": "Thinloop skills and continuity hooks for Issue-backed discovery, read-only project-status navigation, multi-Issue project DAG decomposition and execution, evidence-backed reengineering and delivery, and approved skill evolution.",
"version": "0.20.0"
"version": "0.20.1"
},
"plugins": [
{
"name": "thinloop",
"source": ".",
"description": "Discovery, Web UIUX, architecture, Next project-status navigation, Project DAG decomposition, Execute READY-wave orchestration, Reengineering gates, QuickDev delivery, maintenance, knowledge, and evolution skills with continuity checks; Project itself remains non-executing.",
"version": "0.20.0"
"version": "0.20.1"
}
]
}
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "thinloop",
"version": "0.20.0",
"version": "0.20.1",
"description": "Simplify complex development with Issue-backed discovery, risk-adaptive Web experience and architecture design, non-executing multi-Issue project decomposition into dependency DAGs, bounded READY-wave execution, read-only project-status navigation, project-scale refactoring and cross-stack reimplementation, autonomous single-Issue PR delivery, evidence-backed maintenance, concise experiential knowledge, and human-approved skill evolution.",
"author": {
"name": "mindcarver"
Expand Down
4 changes: 2 additions & 2 deletions .codebuddy-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,14 @@
},
"metadata": {
"description": "Thinloop skills and continuity hooks for Issue-backed discovery, read-only project-status navigation, multi-Issue project DAG decomposition and execution, evidence-backed reengineering and delivery, and approved skill evolution.",
"version": "0.20.0"
"version": "0.20.1"
},
"plugins": [
{
"name": "thinloop",
"source": ".",
"description": "Discovery, Web UIUX, architecture, Next project-status navigation, Project DAG decomposition, Execute READY-wave orchestration, Reengineering gates, QuickDev delivery, maintenance, knowledge, and evolution skills with continuity checks; Project itself remains non-executing.",
"version": "0.20.0"
"version": "0.20.1"
}
]
}
2 changes: 1 addition & 1 deletion .codebuddy-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "thinloop",
"version": "0.20.0",
"version": "0.20.1",
"description": "Simplify complex development with Issue-backed discovery, risk-adaptive Web experience and architecture design, non-executing multi-Issue project decomposition into dependency DAGs, bounded READY-wave execution, read-only project-status navigation, project-scale refactoring and cross-stack reimplementation, autonomous single-Issue PR delivery, evidence-backed maintenance, concise experiential knowledge, and human-approved skill evolution.",
"author": {
"name": "mindcarver"
Expand Down
2 changes: 1 addition & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "thinloop",
"version": "0.20.0",
"version": "0.20.1",
"description": "Simplify complex development with Issue-backed discovery, risk-adaptive Web experience and architecture design, non-executing multi-Issue project decomposition into dependency DAGs, bounded READY-wave execution, read-only project-status navigation, project-scale refactoring and cross-stack reimplementation, autonomous single-Issue PR delivery, evidence-backed maintenance, concise experiential knowledge, and human-approved skill evolution.",
"author": {
"name": "mindcarver"
Expand Down
3 changes: 3 additions & 0 deletions .scd/evolution/history.jsonl

Large diffs are not rendered by default.

29 changes: 29 additions & 0 deletions .scd/plans/20261109-221831-uiux-design-intelligence/decisions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
status: approved
version: 2
created_at: 2026-11-09T22:18:31+08:00
updated_at: 2026-11-09T22:26:00+08:00
recorded_timezone: Asia/Shanghai
---

# 决策与事件

- 事件ID:DEC-1
- 类型:批准
- 文件及文档版本:requirements.md v1、implementation.md v1、plan.md v1(本目录)
- 目标Git SHA:`64125e3acfa3de5e57d5c3ca742af3cdbc7b9a37`(计划首个提交,含四份计划文档与演进 proposed/trial 事件)
- 用户实际依据:用户对五项改造清单回复"没问题"(清单含逐项内容、优先级 P0+P1、落点文件、验收方式与"走 scd-evolve 立一个 Issue 实施"的路径建议),上下文为本对话研究结论展示。
- 任务或Issue范围:EVO-20261109-uiux-design-intelligence 全部 7 项文件操作与版本提升
- occurred_at:null # 用户消息原始时间未知(会话内口头确认,无消息ID)
- recorded_at:2026-11-09T22:26:00+08:00
- 未决选择:无(P2 两项明确暂不实施,不属未决)

- 事件ID:DEC-2
- 类型:开工
- 文件及文档版本:同 DEC-1;决策事件本身记录于 decisions.md v2
- 目标Git SHA:`64125e3acfa3de5e57d5c3ca742af3cdbc7b9a37`
- 用户实际依据:对正式候选项展示(含稳定候选 ID、7 项操作、试验验证与分发边界、"确认 EVO-20261109-uiux-design-intelligence 开始试验,或拒绝该 ID",及是否写入 `~/.scd/config.json` 的可选项)回复"可以"。
- 任务或Issue范围:Issue #120(scd-uiux 补入设计智力层);开工授权覆盖 7 项文件操作、确定性检查、隔离会话前向测试、版本提升与普通交付序列;`thinloop_source_root` 配置写入已同步执行并回读。
- occurred_at:null # 用户消息原始时间未知(会话内口头确认,无消息ID)
- recorded_at:2026-11-09T22:26:00+08:00
- 未决选择:无
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
status: approved
version: 1
created_at: 2026-11-09T22:18:31+08:00
updated_at: 2026-11-09T22:18:31+08:00
recorded_timezone: Asia/Shanghai
---

# 实施计划

## 文件与顺序

| 序 | 文件 | 操作 | 依赖 |
|---|---|---|---|
| 1 | `skills/scd-uiux/references/design-taste.md` | 新建(约 70–100 行) | 无 |
| 2 | `skills/scd-uiux/references/design-tokens.md` | 新建(约 45–60 行) | 无 |
| 3 | `skills/scd-uiux/references/visual-quality.md` | 八维表加"阈值/反模式"双列;黑名单链接;轮次记录加方向决策与变更原因 | 1 |
| 4 | `skills/scd-uiux/references/visual-evidence.md` | 保真度表加两阶段行;新增"两阶段保真度循环"小节 | 1 |
| 5 | `skills/scd-uiux/references/experience-contract.md` | "视觉与组件纪律"挂接 design-tokens 一句 | 2 |
| 6 | `skills/scd-uiux/assets/ux-contract.md` | "视觉方向与系统增量"加方向块占位与设计决策日志栏 | 1、3 |
| 7 | `skills/scd-uiux/SKILL.md` | "形成可实施的视觉交付"挂接 design-taste 一句 | 1 |
| 8 | 发布清单(`.codex-plugin/plugin.json`、`.claude-plugin/plugin.json` 等 grep 确认全集) | 0.20.0→0.20.1 | 1–7 通过验证后 |

## 验证

1. 确定性:全部新增/修改文件的内部相对链接可解析;`grep -r "visual-quality"` 确认 scd-ui-polish/quickdev 引用不受破坏;八维术语保留;各文件行数在预算内;全部发布清单版本相等且无 0.20.0 残留。
2. 隔离会话前向测试(instruction+workflow 必需):编辑后新起子代理,仅提供修改后技能路径与一个新页面设计简报提示词,期望:先产出五项方向块并排查黑名单,再生成视觉产物。
3. 交付门:PR 独立验收子代理返回 PASS;页面类变更不适用(本任务为技能文档,无页面交互)。

## 交付

分支 `evo/20261109-uiux-design-intelligence` → PR → 独立验收 PASS → 合并 → 同步本地 main → 按 Thinloop 交付默认核对已安装 ZCode / Claude Code / Codex 与合并后 main 一致(含仓库内变更的负载刷新)。

## 风险与停止条件

- 隔离会话测试失败:按 trial 契约从 `/tmp/thinloop-evo-20261109-snapshot` 恢复候选文件并追加 `reverted`,报告差距。
- 共用 visual-quality.md 的相邻技能行为回归:八维行名与"八维都要考虑;未触发维度记录 N/A"等共用语句保持原文不动,只增列与小节。
- 清单版本同步遗漏:以 `grep -rn '0\.20\.0'` 全仓核对归零。
14 changes: 14 additions & 0 deletions .scd/plans/20261109-221831-uiux-design-intelligence/plan.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
status: approved
version: 1
created_at: 2026-11-09T22:18:31+08:00
updated_at: 2026-11-09T22:18:31+08:00
recorded_timezone: Asia/Shanghai
---

# 任务索引

- 任务与Issue:EVO-20261109-uiux-design-intelligence——scd-uiux 补入设计智力层(P0+P1 共 7 项文件操作);治理 Issue 见 decisions.md DEC-2 范围记录
- 所需文档及版本:requirements.md v1、implementation.md v1、decisions.md v1
- 基线来源:`skills/scd-uiux/`(main @ `12cc21e`,演进历史 `.scd/evolution/history.jsonl` 8 事件,本候选 proposed/trial 已登记)
- 批准与开工事件:decisions.md `DEC-1`(方案批准:五项改造清单)、`DEC-2`(开工授权与候选 ID 确认)
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
status: approved
version: 1
created_at: 2026-11-09T22:18:31+08:00
updated_at: 2026-11-09T22:18:31+08:00
recorded_timezone: Asia/Shanghai
---

# 需求

scd-uiux 是流程治理型技能,设计质量全部委托给八维检查表(验收框架),缺少生成侧设计智力,导致视觉产出回落均值。经对 plugin87/ux-ui-agent-skills、ui-ux-pro-max、BMAD WDS、apple-design-skill、superdesign-skill 五个高星项目的源码分析,确认补入以下能力(用户已逐项确认清单与优先级,P2 两项暂不实施)。

## P0

1. 新增 `skills/scd-uiux/references/design-taste.md`:生成前五项方向决策块(领域与气质/受众与语气/动效深度/布局族/参考锚点,命名不出不得生成)、反模式黑名单(等权重卡片、全居中、#000压#fff、emoji 图标、满投影、彩虹强调色、单侧彩条、营销空话文案,逐条含原因与替代)、移动优先基准。
2. 升级 `skills/scd-uiux/references/visual-quality.md` 八维表为"具体阈值+反模式":对比≥4.5:1、触控≥44×44px、最大标题≥2.5×正文、行长 45–75ch、4px 间距阶梯、外距>内距、一个主色至多一个强调色;自审轮次记录增加方向决策与变更原因。

## P1

3. 新增 `skills/scd-uiux/references/design-tokens.md`:三层令牌(primitive→semantic→component,原始令牌禁止直接引用)、命名规范、暗色在语义层切换、语义结构与视觉样式分离。
4. `skills/scd-uiux/references/visual-evidence.md` 增加两阶段保真度循环:先讨论再画图;低保真只决结构与层级(禁谈字体颜色);确认即冻结参考后再高保真。
5. `skills/scd-uiux/assets/ux-contract.md` 增加设计决策日志栏。

## 挂接

- `skills/scd-uiux/SKILL.md`「形成可实施的视觉交付」挂接 design-taste。
- `skills/scd-uiux/references/experience-contract.md`「视觉与组件纪律」挂接 design-tokens。

## 边界(不得超出)

- 不改治理流程、状态机、确认机制或与其他技能的分工。
- 不引入外部服务依赖、大型知识库或多 agent 人格体系。
- visual-quality.md 为 scd-ui-polish 与 quickdev 共用,只做增量升级,不破坏既有"八维"术语与共用契约。
- 验收:确定性检查(内部链接、共用文件一致性、行数约束、发布清单版本相等)+ 编辑后新起隔离会话用真实提示词前向测试;通过后补丁版本 0.20.0→0.20.1 并同步全部发布清单。
2 changes: 1 addition & 1 deletion .zcode-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "thinloop",
"version": "0.20.0",
"version": "0.20.1",
"description": "Simplify complex development with Issue-backed discovery, risk-adaptive Web experience and architecture design, non-executing multi-Issue project decomposition into dependency DAGs, bounded READY-wave execution, read-only project-status navigation, project-scale refactoring and cross-stack reimplementation, autonomous single-Issue PR delivery, evidence-backed maintenance, concise experiential knowledge, and human-approved skill evolution.",
"author": {
"name": "mindcarver"
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
</p>

<p align="center">
<kbd>v0.20.0</kbd>
<kbd>v0.20.1</kbd>
&nbsp;
<kbd>ISSUE-DRIVEN</kbd>
&nbsp;
Expand Down
1 change: 1 addition & 0 deletions docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -403,3 +403,4 @@ ZCode:使用 $scd-evolve 诊断本次使用过的 Thinloop Skill。
方案与开工前提:按[计划确认契约](../skills/scd-quickdev/references/planning-contract.md)先确认具体技术选择、精确Git计划版本和开工范围,再连续完成普通交付;新选择或实质变更重新确认。纯状态查询不创建开发计划。

- 升级到 v0.20.0:新增独立 `scd-research`,支持产品前期用户、竞品、替代方案和假设验证;Discovery 消费研究结论,保留清晰变更快速路径。已有客户端按原安装形态更新并核对十四个技能,详见 [`v0.20.0`](./releases/v0.20.0.md)。
- 升级到 v0.20.1:`scd-uiux` 补入设计智力层——生成前方向块、反模式黑名单、三层设计令牌纪律与两阶段保真度循环,八维检查升级为阈值加反模式双列。详见 [`v0.20.1`](./releases/v0.20.1.md)。
7 changes: 7 additions & 0 deletions docs/releases/v0.20.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Thinloop v0.20.1

`scd-uiux` 补入生成侧设计智力,新增[设计品味](../../skills/scd-uiux/references/design-taste.md)与[设计令牌](../../skills/scd-uiux/references/design-tokens.md)两份参考。生成任何视觉产物前必须先写五项方向块(领域与气质、受众与语气、动效深度、布局族、参考锚点)并逐条排查反模式黑名单;[八维检查](../../skills/scd-uiux/references/visual-quality.md)升级为具体阈值加反模式双列(正文对比 4.5:1、触控 44px、最大标题 2.5 倍正文、行长 45–75ch、4px 间距阶梯等);重要页面默认两阶段保真度循环,低保真只决结构与层级;UX 契约模板增加设计决策日志。治理流程与状态机不变,共用文件对 `scd-ui-polish` 与 QuickDev 保持兼容。

设计判断参考 plugin87/ux-ui-agent-skills、BMAD WDS、ui-ux-pro-max、apple-design-skill、superdesign-skill 等开源技能的公开方法(MIT 许可),按本仓库语言与治理结构改写;未引入外部插件或运行时依赖。

结构检查与隔离行为场景只验证本次指令路径,不证明跨模型一致的视觉效果;实际设计质量以用户真实使用验收为准。
2 changes: 1 addition & 1 deletion marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"name": "thinloop",
"source": ".",
"description": "Discovery, Web UIUX, architecture, Next project-status navigation, Project DAG decomposition, Execute READY-wave orchestration, Reengineering gates, QuickDev delivery, maintenance, knowledge, and evolution skills with continuity checks; Project itself remains non-executing.",
"version": "0.20.0"
"version": "0.20.1"
}
]
}
2 changes: 1 addition & 1 deletion skills/scd-uiux/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ description: "在生产实施前设计或完善 Web 产品的用户体验和界

## 形成可实施的视觉交付

创建或验证线框图、视觉稿或原型前,阅读 `references/visual-evidence.md`。
创建或验证线框图、视觉稿或原型前,阅读 `references/visual-evidence.md`。生成任何视觉产物前,先按[设计品味](references/design-taste.md)写出五项方向块并逐条排查反模式黑名单;命名不出方向时不得开始生成。
视觉设计自动使用共用的[页面视觉质量](references/visual-quality.md):统一方向、八维检查、实际渲染的有限轮次自审与可核对对比。已有页面只需视觉打磨时可独立使用 [scd-ui-polish](../scd-ui-polish/SKILL.md);生产实施仍交给 QuickDev,清晰局部变更不增加设计阶段。

- 明显的文案、颜色、间距或局部组件变更继续使用简洁的交互增量说明,不强制扩大成设计项目。
Expand Down
7 changes: 7 additions & 0 deletions skills/scd-uiux/assets/ux-contract.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,9 +23,16 @@ recorded_timezone: Asia/Shanghai

## 视觉方向与系统增量

- <生成前方向块:领域与气质 / 受众与语气 / 动效深度 / 布局族 / 参考锚点;局部变更只写增量>
- <统一方向、共用页面视觉质量的八维观察及适用视口;引用来源与证据,不复制标准>
- <修改前基线或新页面 N/A 理由、各轮自审记录及前后对比;实施对照沿用下方视觉 ID>

### 设计决策日志

| 日期 | 决策 | 变更原因或依据 |
|---|---|---|
| <YYYY-MM-DD> | <方向或令牌决策> | <原因、参考或验收依据> |

## 视觉交付清单

| 视觉 ID | 界面或组件族 | 状态 | 旅程或验收 | 视口 | 保真度 | 项目文件 | 已检查 |
Expand Down
40 changes: 40 additions & 0 deletions skills/scd-uiux/references/design-taste.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# 设计品味

UIUX 设计在生成任何视觉产物前共用本参考。它负责生成侧判断:先固定方向、封死模板化默认。产物验收仍按[页面视觉质量](visual-quality.md)的八维、轮次与证据执行;二者冲突时先统一再继续。

## 生成前方向块

生成线框、视觉稿或原型前,先把五项方向决策写入 UX 契约「视觉方向与系统增量」。说不出任一项时不得开始生成;说不出方向的生成必然回落均值:

- 领域与气质:产品类别,加一个结果必须成立的一个词气质(如「克制」「精密」「温暖」);
- 受众与语气:专家或新手、冷静或活力、高级或实用;
- 动效深度:无 / 仅反馈 / 表达性编排,三选一并说明;
- 布局族:命名的分节序列,说明每节构图如何变化,不重复同一行式;
- 参考锚点:对标的具名系统或作品,来源可核对;无法联网对标时按页面视觉质量的外部对标规则记录。

方向块先于产物存在。产物偏离方向块时,先改方向块或改产物并记录原因,不得事后解释成「风格选择」。清晰局部变更继承现有方向,只写增量。

## 反模式黑名单

以下默认每一个都是缺陷,不是起点。生成时逐条规避,自审时命中即按对应维度 `FAIL`:

| 默认 | 为什么读起来像生成物 | 替代 |
|---|---|---|
| 三个或四个等权重卡片并排 | 视线无处落 | 让一个要素领先:更大、更重或独占一行 |
| 整页居中 | 无张力、无层级 | 真实网格上的不对称;居中是刻意例外 |
| 同一「左文右图」行式重复 | 明显模板化 | 每节构图有意变化 |
| 标题只是加粗正文 | 没有显示层级 | 最大标题至少 2.5 倍正文,短,18–24 字符行长 |
| 每个盒子都有投影 | 浑浊、过时的深度 | 大部分平面;阴影稀有而分层 |
| `#000` 压 `#fff` | 刺眼、业余 | 主题内的暖白底配非纯黑文字 |
| 强调色彩虹 | 无纪律 | 一个主色,至多一个强调色;中性色承担主体 |
| emoji 当图标、项目符或状态点 | 最响的生成物痕迹 | 内联 SVG 图标用 `currentColor`,或纯文字 |
| 单侧彩色边条 | 陈词滥调的装饰 | 完整细边框或面分隔;状态用图标加文字 |
| 拥挤的垂直节奏 | 密集、焦虑 | 分节之间保留慷慨的宏观留白 |

## 文案纪律

界面文案禁用:营销填充词(「赋能」「无缝」「解锁」「极致」)、空洞三连(「强大、直观、美观」)、假结构标签(「SECTION 01」、lorem ipsum、「在此输入标题」)和过度对冲的微文案。写具体的、可验证的事;读出来像新闻稿就删短、写具体。

## 移动优先

基础样式即窄屏布局,更宽的屏幕用 `min-width` 逐层叠加。禁止桌面优先、回头再补移动端。`max-width` 属性用于阅读行长、容器上限与图片约束,不受此限制。
Loading
Loading