Menú
全栈设计规划：分级门控管理 DESIGN.md 与 DESIGN-CHANGELOG，内置可检索设计规则库（UX 规则/配色/字体），三层 Token、Image 2 视觉稿门禁、反 AI 模板检测。 触发方式：用户说"设计"、"forge-design"、"先看效果图"，或 forge-dev 调度、需要创建/更新设计文档时。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Forge 工作流总入口。只读检测项目状态，推荐下一步该用哪个 skill，自己不干活。触发方式：用户说"forge"、"下一步"、"接下来做什么"。
复盘 v3（Workbench 门禁型）：启动本地 Workbench，用户在独立会话页确认想学的知识点和深度，按选择调研产出复盘文档； 同时落 2-3 条账本条目（记录/复盘/learnings.jsonl）供 bugfix/eng 开工回放与复发检测。 触发方式：用户说"总结知识"、"学习总结"、"复盘"、"可视化复盘"、"/forge-fupan"。
通用头脑风暴：4 种模式（产品/内容/构建/探索）× 6 阶段，强制前提挑战和 2-3 方案，产出可跨会话续聊的思考文档；支持 Mermaid/图辅助判断。 触发方式：用户说"头脑风暴"、"brainstorm"、"讨论一下"、"我有个想法"、"帮我想想"、"画图梳理想法"。
设计实现：把 DESIGN.md 转成代码，只改样式不改逻辑；CSS 优先、Token 驱动、反 AI 模板、原子提交，以真实截图和 CSS 断言验证。 触发方式：用户说"实现设计"、"forge-design-impl"、设计文档确认后需要写代码时。
文档落地治理规范。统一管理 docs/ 目录下文档的写时约束、读时索引、生命周期标记。提供当前真相源白名单（doc-paths.md）+ frontmatter schema + 新项目一键脚手架（init-project.sh，已就绪）。所有 forge-* skill 的文档落地路径以本 skill 的 doc-paths.md 为准。触发方式：用户说"文档治理"、"文档放哪"、"docs 目录乱了"、"forge-doc-policy"、AI 准备创建任意 .md 或新目录前的自查。
发布后文档更新。读取所有项目文档，与 diff 交叉对照， 更新 README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md 使之匹配已发布内容， 润色 CHANGELOG 语气，清理 TODOS，可选地更新 VERSION。 触发方式：用户说"更新文档"、"文档同步"、"forge-doc-release"，或 forge-ship 之后、PR 合并之前由 forge-dev --full 调度。
| name | forge-design |
| description | 全栈设计规划：分级门控管理 DESIGN.md 与 DESIGN-CHANGELOG，内置可检索设计规则库（UX 规则/配色/字体），三层 Token、Image 2 视觉稿门禁、反 AI 模板检测。 触发方式：用户说"设计"、"forge-design"、"先看效果图"，或 forge-dev 调度、需要创建/更新设计文档时。 |
文档落地路径：遵循 forge-doc-policy 规范。完整白名单 + frontmatter schema 见
~/.claude/skills/forge-doc-policy/doc-paths.md。 当前文档加载契约：先读项目CLAUDE.md、docs/README.md、docs/INDEX.md和docs/DESIGN.md当前真相源；长 changelog、Image2 历史稿和 raw archive 只在追溯原因时加载。详见~/.claude/skills/_shared/current-doc-loading.md。
纯设计规划——不写代码。产出 DESIGN.md 和设计方案，交由 forge-design-impl 或 forge-eng 实现。
门控判定（L1/L2/L3）
│
├── L1 完整设计 ──→ 竞品调研 → 美学方向(3+) → 配色/字体 → Token体系 → Image 2视觉稿 → 完整审计 → 0-10审查 → DESIGN.md
├── L2 轻量审查 ──→ 读DESIGN.md → 对照检查 → 重点审计(10项) → 必要时Image 2 before/after → 一致性验证 → 更新文档
└── L3 跳过设计 ──→ 纯后端/无UI → 直接进 forge-eng
全程中文。关键设计决策需用户确认后才能定稿。
涉及前端页面、组件、状态或布局时，读取 ~/.claude/skills/_shared/visual-decision-layer.md，使用 Image 2 作为实现前的视觉预判门禁。
触发条件：
流程： 第0步 → 第1步（创建模式）→ 第2步 → 第3步 → 第4步 → 第5步 → 第6步 硬门控： 第5步评分 < B 必须返工。子模块必须通过与父页面的一致性检查。
触发条件：
流程： 第0步 → 第1步（迭代模式）→ 第2步（重点10项）→ 第3步（简化）→ 第4步 → 第5步 门控： 评分 < C 升级到 L1。
触发条件： 纯后端/API、纯数据处理、基础设施、无 UI 变更 流程： forge-dev 调度器自动判断 → 直接进 forge-eng
| 触发器 | 条件 | 动作 |
|---|---|---|
| 迭代不满 | 历史账本显示同一模块 ≥ 3 次反复迭代 | L2 → L1，强制重新设计 |
| 子模块一致性 | 大需求下的子模块 | 必须读父页面 DESIGN.md，检查一致性 |
| 评分过低 | L2 评分 < C | L2 → L1，完整重来 |
审计和方案设计时逐条检查：
完整的 12 条设计师认知模式与设计批评话术（背景素养）见 references/create-mode.md。
提问格式与批量策略见
~/.claude/skills/_shared/interaction-protocol.md。设计选项附视觉效果描述。
{项目目录}/docs/PRD.md 或类似文件搜索模式：
- {项目目录}/docs/DESIGN.md
- {项目目录}/DESIGN.md
- {项目目录}/docs/*design*（不区分大小写）
- {项目目录}/**/DESIGN*.md
*design*changelog*docs/CHANGELOG.md 顶部索引；只有当前模块需要追溯历史时，才读 PRD-CHANGELOG.md / DESIGN-CHANGELOG.md 的相关段落。docs/README.md、docs/INDEX.md 和 docs/DESIGN.md 当前真相源。docs/PRD.md 的相关产品边界和相关模块附录。DESIGN-CHANGELOG.md 相关段落，不默认扫全文。项目没有 DESIGN.md 时走此分支。必读 references/create-mode.md—— 含产品理解四问、美学方向探索（用 search.py 查风格/配色/字体）、三层 Token 生成、模板落地。
按门控级别执行审计（浅门控只查涉及项，深门控全量）。执行前必读 references/audit-and-scoring.md 的审计节—— 含 UX 规则库查询方法、反 AI 模板检查清单、逐项审计表格式。
对每个设计变更点，通过 AskUserQuestion 确认：
页面布局方案：用 ASCII 线框图描述布局结构
┌─────────────────────────────┐
│ 顶栏：Logo + 导航 + 搜索 │
├──────────┬──────────────────┤
│ 侧边栏 │ 主内容区 │
│ 分类导航 │ 卡片网格 │
└──────────┴──────────────────┘
组件设计：描述组件的视觉表现、所有状态变化、响应式行为
设计体系变更：新增的颜色、字体、间距等 token（遵循三层架构）
交互方案：关键交互的状态流转
Image 2 视觉稿：对 UI/布局/状态变化，生成或引用视觉稿，让用户确认观感是否符合预期。视觉稿只用于确认方向，最终实现仍以 DESIGN.md token、组件规范和真实截图为准。
对重要设计决策，用以下方式深度审查：
审查维度：
| 维度 | 审查内容 |
|---|---|
| 信息架构 | 导航结构、内容组织、层级深度 |
| 交互状态覆盖 | 所有状态是否定义、边界情况、错误流程 |
| 用户旅程情感弧线 | 从进入到完成的情绪变化、摩擦点 |
| AI 模板痕迹风险 | 方案是否可能产出泛用感的界面 |
| 设计体系对齐 | 方案是否复用已有 token 和组件 |
| 响应式与无障碍 | 移动端体验、键盘导航、屏幕阅读器 |
| 未决设计问题 | 方案中含糊或未定的部分 |
评分方法：
对每个维度打 0-10 分，并说明：
就绪度分级：
如果当前任务是大需求下的子模块：
追加本次变更记录：时间、背景、设计方案、关键决策。
[vX.Y 新增/修改]对新项目的配色+字体方案，可生成简单 HTML 预览页让用户直观对比：
<!-- 配色预览：展示 Primary/Secondary/Accent 在不同组件上的效果 -->
<!-- 字体预览：展示 Heading/Body 字体在不同层级的视觉效果 -->
执行前必读 references/audit-and-scoring.md 的评估节—— 含 0-10 交互评分维度、健康分计算、B 级门槛（design-impl 的前置条件）。
+====================================================+
| 设计交付完成 |
+====================================================+
| 项目：[项目名] |
| 版本：vX.Y |
| 门控级别：[L1/L2] |
| 设计评分：[A-F]（变更前 → 变更后） |
| AI 模板痕迹评分：[A-F] |
| 设计变更：X 项（新增 A / 修改 B） |
| 子模块一致性：[通过 / 不适用] |
| 文件： |
| DESIGN.md — [已更新/已创建] |
| DESIGN-CHANGELOG — [已追加/已创建] |
| 下一步：forge-design-impl 或 forge-eng 实现 |
+====================================================+
状态标记与通用操作规则见
~/.claude/skills/_shared/feature-status-protocol.md。
design 特有动作：启动前确认 prd 行为 [✅ 已完成]。
本 Skill 自带以下数据文件（自闭环，无需外部依赖）：
| 文件 | 内容 | 用途 |
|---|---|---|
data/colors.csv | 161 种产品类型的完整配色方案 | 第1.4步配色决策 |
data/typography.csv | 73 组字体搭配（含 Google Fonts 链接） | 第1.5步字体决策 |
data/styles.csv | 84 种设计风格定义 | 第1.3步美学方向 |
data/ux-guidelines.csv | 99 条 UX 规则（10类，含代码示例） | 第2步审计补充 |
data/products.csv | 161 种产品类型的设计属性 | 第1.1步产品定位 |
data/ui-reasoning.csv | 产品类型→设计决策映射 | 自动推荐设计方向 |
data/charts.csv | 25 种图表类型指南 | 数据可视化设计 |
data/landing.csv | 34 种落地页区块类型 | 落地页设计 |
scripts/search.py | 设计资源搜索引擎 | 按关键词搜索配色/字体/风格 |
搜索脚本用法：
# 生成完整设计系统建议
python3 {skill_dir}/scripts/search.py "AI search tool modern minimal" --design-system -p "产品名"
# 按领域深入搜索
python3 {skill_dir}/scripts/search.py "elegant serif" --domain typography
python3 {skill_dir}/scripts/search.py "fintech trust" --domain color
python3 {skill_dir}/scripts/search.py "dashboard data" --domain style
设计文档模板：references/design-template.md