@openprd/cli 0.1.8 → 0.1.10

package/.openprd/benchmarks/index.md

@@ -41,4 +41,18 @@
 
 ## Candidate Sources
 
-- 暂无待确认来源。
+### slavingia/skills `github-com-slavingia-skills`
+
+- 状态: candidate
+- 来源类型: github
+- 场景: skill-design
+- 触发: 设计 skill 触发、metadata、安装方式、自动识别或项目级覆盖规则
+- 不适用: 普通 PRD / 产品流程设计；与 CLI 无关的一次性 UI 视觉问题；单次脚本报错或纯环境权限问题
+- 研究方式: deepwiki_then_github
+- 来源: https://github.com/slavingia/skills
+- 规范化信源: github.com/slavingia/skills
+- 最近 7 天采纳: 1
+- 累计采纳: 1
+- 最近采纳时间: 2026-06-09 11:21:58
+- 备注: DeepWiki read_wiki_structure + ask_question showed a reusable community -> workaround -> manual-first -> commitment -> productize -> default-alive framework for L2 requirement validation and brainstorm.
+- 价值: DeepWiki read_wiki_structure + ask_question showed a reusable community -> workaround -> manual-first -> commitment -> productize -> default-alive framework for L2 requirement validation and brainstorm.

package/.openprd/config.yaml

@@ -31,6 +31,16 @@ quality:
   enabled: true
   command: openprd quality . --verify
   reportFormat: html
+design:
+  enabled: true
+  frameworkRoot: .openprd/design
+  templateRoot: .openprd/design/templates
+  activeArtifacts:
+    facts: .openprd/design/active/facts-sheet.md
+    assets: .openprd/design/active/asset-spec.md
+    imagePreflight: .openprd/design/active/image-preflight.md
+    directions: .openprd/design/active/direction-plan.md
+    selectedDirection: .openprd/design/active/selected-direction.md
 qualityGates:
   standards:
     docsRoot: docs/basic

package/.openprd/design/README.md

@@ -0,0 +1,47 @@
+# OpenPrd 前端设计资产
+
+这层目录给 Agent 提供前端体验任务的可复用设计框架。
+
+它不是参考图仓库，而是实现前的判断顺序和资产底座。
+
+## 目录
+
+- `lenses/`: 设计判断角度
+- `themes/`: 主题 token 和密度规则
+- `layouts/`: 页面骨架
+- `components/`: 高频组件结构
+- `recipes/`: 按任务类型整理的默认配方
+- `checklists/`: 自检门
+- `assets/`: 可复用表面和素材说明
+- `templates/`: 可直接套用的页面起步模板
+- `active/`: 当前任务正在使用的事实、素材和方向文件
+
+## 默认顺序
+
+1. 先选 `lens`
+2. 再选 `theme`
+3. 再选 `layout`
+4. 再决定 `component set`
+5. 再补当前任务的 `facts / assets / image preflight / directions`
+6. 最后进入实现
+
+对空白静态原型，如果 `templates/` 里已经有足够接近的模板，优先先用模板默认组合开工；只有确实要偏离默认组合时，再回头细读所有 catalog。
+
+## 空白底座提醒
+
+如果当前工作区几乎没有页面文件，`active/` 目录里的设计合同就是第一批应该被写实的文件。
+
+- 先补 `facts-sheet / asset-spec / image-preflight / direction-plan / selected-direction`
+- 再从 `templates/` 里选最近的一份模板，先把骨架落成可打开页面
+- 如果页面主题和模块范围已经明确，优先把它们直接带进 `openprd design-starter ... --brief ... --sections ...`
+- 对不依赖外部产品事实、品牌素材或真实图片的静态首页，也要把 active design artifacts 明确写成“无外部事实依赖”“当前无品牌素材依赖”“真实图片不是页面成立前提”，不要留在 `pending`
+- 再创建第一个可打开的页面入口，例如 `index.html`
+- 跑完 starter 后，下一步就是同时改 active design artifacts 和入口文件；直接在生成的入口文件上改。禁止删除 starter 生成的入口文件后另起新稿，也不要继续在 placeholder 文档之间兜圈
+- 不要在 placeholder 文档之间反复来回扫描而迟迟不落任何实现文件
+
+## 这层解决什么问题
+
+- 避免界面都长成一种安全极简解
+- 避免事实没核实就上页面
+- 避免内容型页面没有真实图还硬做
+- 避免实现时临时发明主题和组件

package/.openprd/design/README_EN.md

@@ -0,0 +1,25 @@
+# OpenPrd Frontend Design Assets
+
+This folder gives agents a reusable design framework for frontend experience work.
+
+It is not a gallery of references. It is the pre-build decision layer and asset base.
+
+## Structure
+
+- `lenses/`: design decision lenses
+- `themes/`: theme tokens and density rules
+- `layouts/`: page skeletons
+- `components/`: reusable structural components
+- `recipes/`: task-type defaults
+- `checklists/`: quality gates
+- `assets/`: reusable surface and asset notes
+- `templates/`: ready-to-adapt page starters
+- `active/`: task-specific facts, assets, and selected direction files
+
+## Blank Workspace Reminder
+
+When the workspace is still empty, fill the active design contracts first, then pick the closest file in `templates/` and adapt it into the first runnable page entry such as `index.html`.
+
+- If the page does not depend on external product facts, branded assets, or real images, write that down explicitly in the active design contracts instead of leaving them in `pending`.
+- If the page theme and module scope are already clear, prefer passing them into `openprd design-starter` through `--brief` and `--sections` so the first real page and the active design contracts are created together.
+- After the starter is created, the next move should be one patch that updates both the active design contracts and the entry file. Edit the generated entry file in place instead of deleting and recreating it, and do not keep circling through placeholder docs.

package/.openprd/design/active/asset-spec.md

@@ -0,0 +1,15 @@
+# Asset Spec
+
+| 类型 | 资产 | 来源 | 状态 | 备注 |
+| --- | --- | --- | --- | --- |
+| logo | 待填写 | 待确认 | pending |  |
+| 产品图 | 待填写 | 待确认 | pending |  |
+| UI 图 | 待填写 | 待确认 | pending |  |
+| 摄影 / 插图 | 待填写 | 待确认 | pending |  |
+| 色板 / 字体 | 待填写 | 待确认 | pending |  |
+
+## 冻结变量
+
+- lens: 待填写
+- theme: 待填写
+- layout: 待填写

package/.openprd/design/active/direction-plan.md

@@ -0,0 +1,7 @@
+# Direction Plan
+
+| 方向 | 生成逻辑 | lens | theme | layout | 为什么不同 | 适用场景 | 主要风险 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 方向 1 | contrast | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| 方向 2 | reference-transfer | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| 方向 3 | design-lens | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |

package/.openprd/design/active/facts-sheet.md

@@ -0,0 +1,13 @@
+# Facts Sheet
+
+| 字段 | 当前值 | 来源 | verifiedAt | 状态 |
+| --- | --- | --- | --- | --- |
+| 产品 / 项目名 | 待填写 | 待确认 | - | pending |
+| 版本 / 发布状态 | 待填写 | 待确认 | - | pending |
+| 关键事实 1 | 待填写 | 待确认 | - | pending |
+| 关键事实 2 | 待填写 | 待确认 | - | pending |
+
+## 备注
+
+- 没核实到就保留 `pending`
+- 不要把记忆当来源

package/.openprd/design/active/image-preflight.md

@@ -0,0 +1,9 @@
+# Image Preflight
+
+| 问题 | 回答 |
+| --- | --- |
+| 真实图片是不是页面成立前提 | 待填写 |
+| 必需图片类型 | 待填写 |
+| 计划来源 | 待填写 |
+| 缺失风险 | 待填写 |
+| 降级方案 | 待填写 |

package/.openprd/design/active/selected-direction.md

@@ -0,0 +1,11 @@
+# Selected Direction
+
+- selected: 待填写
+- reason: 待填写
+- lens: 待填写
+- theme: 待填写
+- layout: 待填写
+- components:
+  - 待填写
+- follow-up risks:
+  - 待填写

package/.openprd/design/anti-slop.md

@@ -0,0 +1,16 @@
+# Anti-Slop
+
+## 禁区
+
+- 三版候选都只是浅色留白加点缀色
+- 内容型页面没有真实图，只用大面积占位块
+- 工具型页面做成营销站
+- 页面里出现多个互相冲突的圆角、阴影和边框体系
+- 不核实事实就写产品页
+
+## 优先替代
+
+- 用明确 lens 代替“做个好看的页面”
+- 用 theme lock 代替边写边试色
+- 用 layout skeleton 代替从空白页硬搭
+- 用真实内容资产代替装饰性占位

package/.openprd/design/assets/dark-mesh.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="180" height="180" viewBox="0 0 180 180" fill="none">
+  <rect width="180" height="180" fill="#0D1117"/>
+  <path d="M0 0.5H180" stroke="#243140" stroke-opacity="0.78"/>
+  <path d="M0 45.5H180" stroke="#243140" stroke-opacity="0.28"/>
+  <path d="M0 90.5H180" stroke="#243140" stroke-opacity="0.28"/>
+  <path d="M0 135.5H180" stroke="#243140" stroke-opacity="0.28"/>
+  <path d="M0.5 0V180" stroke="#243140" stroke-opacity="0.78"/>
+  <path d="M45.5 0V180" stroke="#243140" stroke-opacity="0.28"/>
+  <path d="M90.5 0V180" stroke="#243140" stroke-opacity="0.28"/>
+  <path d="M135.5 0V180" stroke="#243140" stroke-opacity="0.28"/>
+  <circle cx="30" cy="38" r="1.2" fill="#34D3A2" fill-opacity="0.36"/>
+  <circle cx="146" cy="62" r="1.2" fill="#34D3A2" fill-opacity="0.26"/>
+  <circle cx="102" cy="144" r="1.2" fill="#34D3A2" fill-opacity="0.18"/>
+</svg>

package/.openprd/design/assets/paper-grid.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="160" height="160" viewBox="0 0 160 160" fill="none">
+  <rect width="160" height="160" fill="#FFFDF8"/>
+  <path d="M0 0.5H160" stroke="#D8CEC1" stroke-opacity="0.48"/>
+  <path d="M0 40.5H160" stroke="#D8CEC1" stroke-opacity="0.22"/>
+  <path d="M0 80.5H160" stroke="#D8CEC1" stroke-opacity="0.22"/>
+  <path d="M0 120.5H160" stroke="#D8CEC1" stroke-opacity="0.22"/>
+  <path d="M0.5 0V160" stroke="#D8CEC1" stroke-opacity="0.48"/>
+  <path d="M40.5 0V160" stroke="#D8CEC1" stroke-opacity="0.22"/>
+  <path d="M80.5 0V160" stroke="#D8CEC1" stroke-opacity="0.22"/>
+  <path d="M120.5 0V160" stroke="#D8CEC1" stroke-opacity="0.22"/>
+  <circle cx="20" cy="22" r="1.1" fill="#A64B2A" fill-opacity="0.26"/>
+  <circle cx="108" cy="56" r="1" fill="#A64B2A" fill-opacity="0.2"/>
+  <circle cx="60" cy="124" r="1.2" fill="#A64B2A" fill-opacity="0.18"/>
+</svg>

package/.openprd/design/assets/surface-presets.md

@@ -0,0 +1,21 @@
+# Surface Presets
+
+这里记录允许反复复用的表面和背景资产类型。
+
+## 允许
+
+- 低对比纸张肌理
+- 轻微颗粒
+- 低强度网格
+- 真实摄影背景
+- 真实产品渲染图
+
+## 慎用
+
+- 大面积渐变主导整个页面
+- 纯装饰型发光块
+- 和主题无关的氛围图
+
+## 默认原则
+
+- 资产服务于内容，不要盖过内容。

package/.openprd/design/assets/workbench-grid.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="180" height="180" viewBox="0 0 180 180" fill="none">
+  <rect width="180" height="180" fill="#FFFFFF"/>
+  <path d="M0 0.5H180" stroke="#D9E1E8" stroke-opacity="0.82"/>
+  <path d="M0 36.5H180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <path d="M0 72.5H180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <path d="M0 108.5H180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <path d="M0 144.5H180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <path d="M0.5 0V180" stroke="#D9E1E8" stroke-opacity="0.82"/>
+  <path d="M36.5 0V180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <path d="M72.5 0V180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <path d="M108.5 0V180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <path d="M144.5 0V180" stroke="#D9E1E8" stroke-opacity="0.34"/>
+  <circle cx="28" cy="24" r="1.2" fill="#2F80ED" fill-opacity="0.24"/>
+  <circle cx="120" cy="84" r="1.2" fill="#2F80ED" fill-opacity="0.18"/>
+  <circle cx="74" cy="146" r="1.2" fill="#2F80ED" fill-opacity="0.14"/>
+</svg>

package/.openprd/design/checklists/ui-quality-gate.md

@@ -0,0 +1,22 @@
+# UI Quality Gate
+
+## P0
+
+- 关键事实已核实，或明确标注 `待确认`
+- 主题已锁定，不存在临时发明的颜色体系
+- 真实图片是否必需已经判断
+- 大界面任务若无参考方向，已完成 3 个异源方向
+
+## P1
+
+- 页面主次明确
+- 同一页面的密度一致
+- 按钮、卡片、表格、表单大小关系自然
+- 长文本没有挤爆容器
+- 局部视觉语言没有突然换轨
+
+## P2
+
+- 屏幕第一眼能知道页面是干什么的
+- 未改区域没有明显视觉漂移
+- 需要时已准备 `visual-prepare` 或 `visual-compare` 证据

package/.openprd/design/components/component-catalog.md

@@ -0,0 +1,42 @@
+# Component Catalog
+
+优先复用这些结构，不要每次从空白页发明一套。
+
+## Hero
+
+- `immersive-hero`
+- `spec-hero`
+- `editorial-hero`
+
+## Proof
+
+- `stat-row`
+- `trust-strip`
+- `quote-block`
+- `logo-wall`
+
+## Content
+
+- `feature-grid`
+- `story-section`
+- `timeline`
+- `gallery-rail`
+- `map-highlight`
+
+## Tooling
+
+- `filter-rail`
+- `dense-table`
+- `settings-group`
+- `summary-panel`
+
+## Decision
+
+- `plan-compare`
+- `faq-accordion`
+- `cta-banner`
+
+## 使用规则
+
+- 先决定这次页面最重要的 3 到 5 个组件，不要无上限堆结构块。
+- 同一页面的组件风格要服从同一 theme 和 layout。

package/.openprd/design/layouts/layout-catalog.json

@@ -0,0 +1,45 @@
+{
+  "version": 1,
+  "layouts": [
+    {
+      "id": "immersive-hero-stack",
+      "useFor": ["product-launch", "immersive-showcase"],
+      "summary": "Full-width hero followed by layered proof and supporting sections."
+    },
+    {
+      "id": "editorial-rail",
+      "useFor": ["editorial-contrast", "content-experience"],
+      "summary": "Alternating wide media and text rails with strong vertical rhythm."
+    },
+    {
+      "id": "product-spec-runway",
+      "useFor": ["product-launch"],
+      "summary": "Hero, highlights, specs, proof, and CTA in a linear product narrative."
+    },
+    {
+      "id": "ops-density-grid",
+      "useFor": ["operational-density"],
+      "summary": "Dense work surface with fixed controls, structured panels, and scan-first tables."
+    },
+    {
+      "id": "catalog-browser",
+      "useFor": ["catalog-clarity"],
+      "summary": "Filter rail plus flexible list or grid browsing surface."
+    },
+    {
+      "id": "story-map",
+      "useFor": ["immersive-showcase", "editorial-contrast"],
+      "summary": "Narrative sequence with strong landmarks, maps, or guided discovery blocks."
+    },
+    {
+      "id": "pricing-and-proof",
+      "useFor": ["product-launch", "operational-density"],
+      "summary": "Decision-focused layout with plan comparison, objections, and proof."
+    },
+    {
+      "id": "settings-split",
+      "useFor": ["operational-density"],
+      "summary": "Stable navigation rail with form-heavy content split by configuration sections."
+    }
+  ]
+}

package/.openprd/design/lenses/frontend-lenses.md

@@ -0,0 +1,31 @@
+# Frontend Lenses
+
+## `editorial-contrast`
+
+- 适合内容型页面、品牌故事、专题页、馆藏导览、展览解说
+- 核心特征：排版节奏感强，图文切换明确，留白与密度并存
+- 常见风险：做成只有“杂志感”但没有任务完成路径
+
+## `product-launch`
+
+- 适合发布页、产品介绍页、关键功能亮点页
+- 核心特征：主视觉强、卖点集中、规格与证明材料清晰
+- 常见风险：只顾氛围，不给关键事实和证据
+
+## `operational-density`
+
+- 适合后台、工具页、控制台、SaaS、CRM、配置页
+- 核心特征：扫描效率高、信息密度稳、交互路径短
+- 常见风险：密度高但没有层级，最后变成挤
+
+## `immersive-showcase`
+
+- 适合旅游、地点、内容探索、案例展示
+- 核心特征：真实图片主导，叙事路径顺滑，视觉情绪明显
+- 常见风险：图片很好看，但信息组织太弱
+
+## `catalog-clarity`
+
+- 适合资料库、资源库、商品库、内容浏览
+- 核心特征：卡片和列表关系清晰，可筛选、可比较、可快速回看
+- 常见风险：所有区块看起来一样重

package/.openprd/design/recipes/content-experience.md

@@ -0,0 +1,26 @@
+# Content Experience Recipe
+
+## 默认组合
+
+- lens: `editorial-contrast` 或 `immersive-showcase`
+- theme: `quiet-sand` 或 `warm-editorial`
+- layout: `editorial-rail` 或 `story-map`
+
+## 必做前置
+
+- `image-preflight.md`
+- 需要时补 `asset-spec.md`
+
+## 常见组件
+
+- `editorial-hero`
+- `story-section`
+- `timeline`
+- `gallery-rail`
+- `quote-block`
+
+## 验收重点
+
+- 没有真实图时是否及时降级，而不是硬做灰块页面
+- 图文节奏是否成立
+- 读者是否知道下一步看哪里

package/.openprd/design/recipes/operational-tool.md

@@ -0,0 +1,25 @@
+# Operational Tool Recipe
+
+## 默认组合
+
+- lens: `operational-density`
+- theme: `tool-neutral`
+- layout: `ops-density-grid` 或 `settings-split`
+
+## 必做前置
+
+- 先决定关键任务路径和主操作
+- 如有核心业务数据，再补 `facts-sheet.md`
+
+## 常见组件
+
+- `filter-rail`
+- `dense-table`
+- `summary-panel`
+- `settings-group`
+
+## 验收重点
+
+- 是否方便扫描
+- 主操作是否靠近用户决策点
+- 文本和控件是否出现无意义放大

package/.openprd/design/recipes/product-launch.md

@@ -0,0 +1,26 @@
+# Product Launch Recipe
+
+## 默认组合
+
+- lens: `product-launch`
+- theme: `deep-launch` 或 `warm-editorial`
+- layout: `product-spec-runway`
+
+## 必做前置
+
+- `facts-sheet.md`
+- `asset-spec.md`
+
+## 常见组件
+
+- `spec-hero`
+- `feature-grid`
+- `stat-row`
+- `plan-compare`
+- `faq-accordion`
+
+## 验收重点
+
+- 首屏是否一眼知道是什么产品
+- 规格和卖点有没有混成一锅
+- 证明材料是否真实且位置合理

package/.openprd/design/templates/README.md

@@ -0,0 +1,36 @@
+# Frontend Starter Templates
+
+这层模板不是最终成品，而是空白工作区的第一版骨架。
+
+## 使用顺序
+
+1. 先补 `active/` 下的事实、素材、图片前置和方向合同
+2. 再从这里挑最近的一份模板
+3. 运行 `openprd design-starter . --starter <starter-id> --out index.html`
+4. 再按选中的 `lens + theme + layout + component set` 改写内容和样式
+
+## 模板清单
+
+- `content-home.html`: 内容型首页、导览页、展览页、城市体验页、故事型首页
+- `product-launch.html`: 产品发布页、品牌发布页、功能发布页、招商/介绍型首页
+- `ops-dashboard.html`: 工具台、后台首页、运营工作台、信息密度型页面
+
+## 推荐起步组合
+
+| 模板 | 默认 lens | 默认 theme | 默认 layout | 默认组件 |
+| --- | --- | --- | --- | --- |
+| `content-home.html` | `editorial-contrast` | `warm-editorial` | `story-map` | `editorial-hero` `stat-row` `story-section` `feature-grid` `timeline` `cta-banner` |
+| `product-launch.html` | `product-launch` | `deep-launch` | `product-spec-runway` | `spec-hero` `stat-row` `feature-grid` `logo-wall` `cta-banner` |
+| `ops-dashboard.html` | `operational-density` | `tool-neutral` | `ops-density-grid` | `filter-rail` `summary-panel` `dense-table` `settings-group` |
+
+## 默认规则
+
+- 静态原型优先使用单文件 HTML 模板起步
+- 优先用 `openprd design-starter` 创建入口文件，不要手动从空白页重搭第一版骨架
+- 如果页面主题和模块范围已经明确，优先用 `openprd design-starter . --starter <starter-id> --out index.html --brief "<页面主题>" --sections "<模块1|模块2|模块3>"`，让 starter 顺手把 active design artifacts 和第一版真实文案一起落出来
+- 对不依赖外部产品事实、品牌素材或真实图片的静态首页，active design artifacts 可以直接写“无外部事实依赖”“当前无品牌素材依赖”“真实图片不是页面成立前提”，不要把这些通用页面长时间停在 `pending`
+- 跑完 `design-starter` 后先改生成入口文件里的 `[占位]` 文案和标题，再细化样式，不要回头整页重读模板源码
+- 跑完 `design-starter` 后，下一步默认就是一次补丁，同时改入口文件和必要的 active design artifacts；直接在生成的入口文件上改。禁止删除 starter 生成的入口文件后另起新稿
+- 先改结构和文案，再细化装饰
+- 模板只是骨架，不能把示例文案原样交付
+- 如果模板默认组合已经够用，不要继续把所有 catalog 文件都重读一遍再决定

package/.openprd/design/templates/README_EN.md

@@ -0,0 +1,31 @@
+# Frontend Starter Templates
+
+These templates are not final deliverables. They are the first runnable skeleton for blank frontend workspaces.
+
+## Order
+
+1. Fill the task-specific contracts under `active/`
+2. Pick the closest starter template here
+3. Run `openprd design-starter . --starter <starter-id> --out index.html`
+4. Then adapt it using the selected `lens + theme + layout + component set`
+
+## Included Starters
+
+- `content-home.html`
+- `product-launch.html`
+- `ops-dashboard.html`
+
+## Starter Defaults
+
+- `content-home.html`: `editorial-contrast` + `warm-editorial` + `story-map`
+- `product-launch.html`: `product-launch` + `deep-launch` + `product-spec-runway`
+- `ops-dashboard.html`: `operational-density` + `tool-neutral` + `ops-density-grid`
+
+## Defaults
+
+- Prefer `openprd design-starter` over rebuilding the first skeleton from an empty page
+- If the page theme and module scope are already clear, prefer `openprd design-starter ... --brief ... --sections ...` so the first page and the active contracts are created together
+- If the page does not depend on external product facts, branded assets, or real images, write those contracts as explicit no-dependency decisions instead of leaving them in `pending`
+- After `design-starter`, replace the generated placeholder copy and title in the entry file before rereading the whole template
+- After `design-starter`, the default next move is one patch that updates both the entry file and the active design contracts; edit the generated entry file in place instead of deleting and recreating it
+- Start with structure and copy before decoration