Forge Design

> 文档落地路径：遵循 forge-doc-policy 规范。完整白名单 + frontmatter schema 见 > ~/claudecode_workspace/工具/forge-cookbook/skills/forge-doc-policy/doc-paths.md。

/forge-design：全栈设计规划与文档管理

纯设计规划——不写代码。产出 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

全程中文。关键设计决策需用户确认后才能定稿。 涉及前端页面、组件、状态或布局时，读取 ../_shared/visual-decision-layer.md，使用 Image 2 作为实现前的视觉预判门禁。

---

分级门控体系

L1 完整设计（不可跳过）

触发条件：

• 新项目、新页面、新的独立功能模块
• 迭代不满触发器命中（同一模块 PRD CHANGELOG ≥ 3 次迭代）

流程： 第0步 → 第1步（创建模式）→ 第2步 → 第3步 → 第4步 → 第5步 → 第6步 硬门控： 第5步评分 20 个模糊观察。

1. 响应式是设计，不只是"不坏"。 移动端要有独立的设计意义。
2. 快速胜利很重要。 始终包含 3-5 个高影响低工作量的改进建议。
3. 不孤立评估。 每个设计决策放在用户旅程的完整上下文中评判。
4. 门控必须遵守。 L1 评分 < B 不能放行。L2 评分 < C 必须升级。
5. 子模块必须一致。 大需求下的子模块设计必须与父页面对齐。

---

资源

• 设计文档模板：[references/design-template.md](references/design-template.md)
• 配色库：[data/colors.csv](data/colors.csv)
• 字体库：[data/typography.csv](data/typography.csv)
• UX 规则：[data/ux-guidelines.csv](data/ux-guidelines.csv)
• 产品类型：[data/products.csv](data/products.csv)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: yike-gunshi
• Source: yike-gunshi/forge-skills
• License: MIT

Install and usage instructions live in the source repository linked above.