# Build Product And Tool Interfaces

为浏览器内需要持续操作对象、推进多步状态并产生可检查结果的产品与专业工具设计、实现、重构或诊断完整界面。用于运营与审核工作台、任务流业务产品、创作与编辑工具、分析与管理工具、资...

- Repository: https://github.com/EverMind-AI/Raven (5958 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add EverMind-AI/Raven --skill build-product-and-tool-interfaces -g -a claude-code -y`
Codex: `npx skills add EverMind-AI/Raven --skill build-product-and-tool-interfaces -g -a codex -y`
Cursor: `npx skills add EverMind-AI/Raven --skill build-product-and-tool-interfaces -g -a cursor -y`
Gemini CLI: `npx skills add EverMind-AI/Raven --skill build-product-and-tool-interfaces -g -a gemini-cli -y`

## Description

为浏览器内需要持续操作对象、推进多步状态并产生可检查结果的产品与专业工具设计、实现、重构或诊断完整界面。用于运营与审核工作台、任务流业务产品、创作与编辑工具、分析与管理工具、资产或文件处理器、监控处置台及其目标环境工作流；核心覆盖对象模型、状态机、真实输入输出、专业引擎、错误恢复、信息密度与任务连续性。不用于主要供阅读的内容网站、只展示组件与 token 的设计系统样张、单张数据图或以理解模型为目的的交互演示。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 构建产品与工具界面

## 成功定义

让目标角色把真实输入或对象推进到可核验结果；需要持久化、权限、批量或协作时，这些能力也必须形成真实闭环。完成态不是“页面已经画完”，而是适用于当前子型的输入、命令、状态变化、反馈、恢复与输出成立；不适用的能力应明确记为 `N/A`，不能用假数据或假控件补齐产品外观。

本 Skill 拥有产品领域判断，并保留介质中立的真实标杆、视觉理由、素材来源与许可和目标环境验收。
最终消费者或合同交付确为 Web 时，再与 `$build-polished-visual-frontends` 组合；对象模型、迁移报告或
内部状态检查器本身不触发组合。组件系统风格合同和代表性非空方向帧只适用于含可视界面的
Create/Edit；纯对象建模和 Diagnose 记为 `N/A + 原因`。Diagnose 可只读检查组件语言与渲染证据，
不得借检查改写视觉方向。详细状态矩阵、批量作用域、恢复策略和环境转换模式见
[references/patterns.md](references/patterns.md)。

组合时以对象模型、命令关系、任务密度和状态风险决定视觉优先级，不套用“简单、干净、中性”的
默认皮肤。主题材料与标志性表达不得压过主工作对象，除非用户要求、已接受参考或品牌系统明确授权。

## 选择主要产品循环

按用户反复完成的工作选择主型，不按“有侧栏”“像后台”或采用的框架分类。混合产品只保留一个主要循环，其他能力围绕它服务。

| 主型 | 核心对象 | 高频循环 | 完成证据 |
| --- | --- | --- | --- |
| 运营与审核工作台 | 案例、记录、请求、任务 | 定位、判断、分派、批量处置、追踪 | 状态去向、责任人、审计记录 |
| 创作与编辑工具 | 文档、素材、场景、版本 | 选择、编辑、预览、比较、保存、发布 | 可恢复版本或真实产物 |
| 分析与管理工具 | 数据集、查询、配置、项目、资源 | 查询、比较、解释、配置、处置 | 可追溯决策、配置或报告 |
| 任务流产品 | 申请、订单、工单、审批、作业 | 受理、校验、交接、批准、完成、重开 | 生命周期变化与交接记录 |

页面主要用于发现和阅读内容时，路由到内容网站；交付物主要是跨产品复用的组件、状态与 token 时，路由到 UI 组件与设计系统。单张图的重点是解释数据时属于数据可视化；只有当查询、筛选、告警和处置组成持续工作时，完整界面才属于本领域。操纵变量只为理解规律时属于交互解释器，不要套用业务工作流。

登录、侧栏、搜索、图表或 AI 摘要不自动构成产品工具。混合站点按任务面拆分：发现与阅读仍按内容网站设计；只有反复操作稳定对象、推进持久生命周期或生成可继续使用结果的工作区才应用本 Skill，不把整个站点强行包装成 dashboard。

## 先定工作模式与适用能力

先根据请求选择工作模式，不能把 Create 的流程机械套到 Edit 或 Diagnose：

| 模式 | 目标 | 硬边界 |
| --- | --- | --- |
| **Create** | 从需求建立新的对象、命令与工作面 | 只实现有真实输入、状态和结果的承诺；未要求的企业能力不补齐 |
| **Edit** | 修改现有产品而不破坏既有任务、数据与交互契约 | 先审计不可破坏行为、数据迁移和回归证据，再做最小必要改动 |
| **Diagnose** | 定位现有界面的行为、状态、性能或可用性问题 | 默认零写入：不改源码、配置、权威数据或产品状态；只做只读复现、追踪和证据归因，修复需用户另行授权 |

再按产品子型建立适用性表，并为每项写 `required / optional / N/A + 原因`：

| 能力 | 何时需要 | 何时可为 `N/A` |
| --- | --- | --- |
| 当前对象、选择与批量 | 多对象列表、集合操作、批处理 | 单对象计算器、一次只处理一个文件或文档的工具 |
| 持久化、版本与刷新恢复 | 工作跨会话继续、形成权威记录或可恢复草稿 | 明确的一次性无持久化工具；仍须给真实即时结果或可用输出 |
| 权限与审计 | 多角色、受控动作、合规或高影响变更 | 单用户、本地、无角色差异的工具 |
| 协作与冲突 | 多人同时或异步编辑、交接、评论、审批 | 单人工作流或只读共享 |
| 异步作业与进度 | 导入、计算、上传、发布等确实跨时完成 | 同步且可即时完成的命令 |
| 目标环境任务转换 | brief 明确承诺多个环境完成任务 | 明确限定单一环境的专业重型工作面；仍须在合同视口可用 |

The rest: https://github.com/EverMind-AI/Raven/blob/HEAD/plugins-dist/design-engine/raven_design/skills/build-product-and-tool-interfaces/SKILL.md