openxiangda-skill-kit 2.1.0 → 2.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -1,10 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: openxiangda-v2
|
|
3
|
-
description: 使用 OpenXiangda 2.0
|
|
3
|
+
description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由 AI 在工作区内调用 OpenDesign 原版 CLI/Skill/MCP 形成整体视觉与可运行原型，再开发、检查和交付应用。OpenDesign 客户端只作为可选预览器；维护 1.x 应用时使用对应的 1.x 技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# OpenXiangda 2.0
|
|
7
7
|
|
|
8
|
+
## 应用结构基线（必须遵守）
|
|
9
|
+
|
|
10
|
+
每个业务应用默认先建立并保留标准管理后台。管理后台是应用骨架，承载资源模型、表单、数据列表、详情/编辑、权限和流程入口；AI 必须先从后台完成数据与契约，再实现用户端体验。不得因为制作用户端首页而删除、隐藏或替换后台 Shell、后台路由或显式菜单。
|
|
11
|
+
|
|
12
|
+
OpenDesign 按页面归属使用：后台页面可以用 OpenDesign 优化布局、视觉和交互，但必须复用平台后台 Shell、导航、字段行为和权限；用户端 PC 与移动端可以分别使用 OpenDesign 的完整视觉和交互，并通过平台 runtime/Data API 读取后台数据。不得用单页 HTML、iframe 或独立假后台冒充管理后台，也不得在用户端复制后台权限和导航状态。
|
|
13
|
+
|
|
14
|
+
设计、实现和发布验收必须分别核验管理后台入口、表单、数据列表、流程入口，以及用户端 PC/移动端入口。缺少标准管理后台的应用结构不完整，不能发布。
|
|
15
|
+
|
|
8
16
|
## 先理解任务
|
|
9
17
|
|
|
10
18
|
新应用或模糊业务想法先读[对话发现与产品设计](references/product-design.md)，从资料和真实流程主动提出模块建议，逐轮少量提问、复述确认并更新 AppSpec。完整首发的 PRD、旅程、逐页交互、视觉/原型、权限与架构形成权威基线后，才制定实施计划和编写业务实现。用户不知道模块时给出有理由的推荐和代价，不能把整套设计问题丢回用户。
|
|
@@ -13,7 +21,19 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
|
|
|
13
21
|
|
|
14
22
|
遇到已有 V1 项目时，先核实 V2 能力覆盖、项目是否仍在测试阶段和迁移成本；能力满足、仍在测试阶段且代价可控时，优先建议转用 V2。先做只读评估，再按项目确认详细设计、数据/流程映射、测试和回滚；迁移实施前的原项目维护仍使用匹配的 V1 引擎。
|
|
15
23
|
|
|
16
|
-
有界面影响的开发和改版默认读[OpenDesign 工作流](references/design-workflow.md)
|
|
24
|
+
有界面影响的开发和改版默认读[OpenDesign 工作流](references/design-workflow.md)，由 AI 在当前 OpenXiangda 工作区读取相关 Skill，并通过 `openxiangda design cli` 或原版 stdio MCP 自动完成设计方向、原型、lint、修正和产物交接；不要求用户打开或操作 OpenDesign 客户端。客户端只用于用户主动查看或人工预览。随包方法仅作离线参考，保留字段与权限行为，旧默认皮肤或设备偏好可按任务重新设计。设计与原型资源使用 AppSpec assets 固定；不把结构检查或示例数据当成实际验收。
|
|
25
|
+
|
|
26
|
+
## AI 自动设计与开发
|
|
27
|
+
|
|
28
|
+
AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作区内执行以下闭环，不把设计任务转交给用户操作客户端：
|
|
29
|
+
|
|
30
|
+
1. 读取本 Skill、`references/design-workflow.md` 和任务相关的 OpenDesign Skill；从当前 AppSpec、平台契约和用户材料确定页面、角色、设备与验收目标。
|
|
31
|
+
2. 用 `openxiangda design cli` 查询原版方向、模板、设计系统和插件；需要持续会话时启动 `openxiangda design cli mcp`，把原版设计工具接入当前 AI Agent。所有 CLI 参数、JSON、标准输入输出和取消都由原版处理。
|
|
32
|
+
3. 在任务工作区创建或复用原版项目，向原版 Agent 提交任务上下文，生成可运行原型；AI 自己读取文件、运行 lint/预览检查并按结果修正。
|
|
33
|
+
4. 将本轮实际采用的设计文件、token、原型和来源版本复制或导出到 `appspec/design`，然后继续生成 OpenXiangda 页面、字段和业务实现。设计产物与应用源码属于同一变更链，不要求用户在客户端中搬运文件。
|
|
34
|
+
5. 运行本项目的 check、浏览器和真实角色验收；只有实际证据通过后才进入部署流程。原型、示例数据或客户端截图不能替代业务验收。
|
|
35
|
+
|
|
36
|
+
如果原版 CLI 或 MCP 不可用，保留真实错误并停止依赖原版的设计步骤；可以继续不依赖设计运行时的只读分析，但不能伪造设计产物或把离线参考当成原版执行结果。
|
|
17
37
|
|
|
18
38
|
## 定位当前版本
|
|
19
39
|
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# OpenDesign 设计、原型与实现
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
有界面影响的新应用、页面或改版，默认由 **OpenXiangda 2.0 的 AI 工作流调用原版 OpenDesign CLI、Skill 和 MCP** 完成设计、原型、预览和修正，再在同一工作区交接到享搭实现业务。OpenDesign 客户端是可选预览器，不是用户必须操作的开发入口。享搭只提供安装发现、原生 CLI 透传和 Agent 接入边界；项目、模板、设计系统、插件、导出及更新都由 OpenDesign 管理。纯后端、文字校正等按影响沿用已有设计。
|
|
4
4
|
|
|
5
5
|
## 原版安装与完整 CLI {#native}
|
|
6
6
|
|
|
7
|
-
从[官方发行页](https://github.com/nexu-io/open-design/releases/latest)
|
|
7
|
+
从[官方发行页](https://github.com/nexu-io/open-design/releases/latest)安装原版运行时或 CLI。AI 工作流优先通过绝对路径 `OPENXIANGDA_OPENDESIGN_CLI`（也支持 `OD_BIN` 与 `OD_NODE_BIN`）调用原生 CLI；macOS 桌面自动发现 `/Applications/Open Design.app` 或 `~/Applications/Open Design.app` 仅用于可选预览。不要要求用户打开客户端，也不搜索 PATH 中的 `od`，避免调用操作系统的同名命令。当前桌面自动发现已在官方 macOS arm64 0.22.2 验证；其他平台使用显式入口，不声称已完成桌面验证。
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
pnpm openxiangda design open
|
|
@@ -20,9 +20,9 @@ pnpm openxiangda design cli mcp
|
|
|
20
20
|
|
|
21
21
|
`cli` 后面的参数、标准输入、输出、JSON、错误码和取消交给原版；享搭不维护上游命令白名单。查看每条原生命令的 `--help` 再执行当前需要的操作。原版 MCP 可直接接到支持 stdio 的 Agent，启动命令为 `openxiangda design cli mcp`；它与享搭平台 MCP 分别拥有设计项目和平台契约，不合并权限。
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
AI 通过 CLI/MCP 工作时使用原生 `OD_DAEMON_URL` 或原版自动发现的本地运行时；不需要先执行 `design open`。桌面版 sidecar 只在用户主动预览时使用。原版桌面文件导入等操作可能要求桌面授权上下文；AI 应保留原版错误并停止该步骤，不伪造 token 或改数据库。享搭不会在 npm 安装时下载桌面应用、自动修改 Agent 凭据或开启云付费功能。
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
AI Agent 通过原版 CLI/MCP 使用设计能力；模型和登录由原版及所选提供商管理。用户需要人工查看时才打开客户端。需要原版图像、视频、音频或云服务时按原版配置相应提供商。原生功能按其实际依赖可用，不把所有功能都描述为无需配置。
|
|
26
26
|
|
|
27
27
|
## 随包离线参考 {#resources}
|
|
28
28
|
|
|
@@ -41,6 +41,8 @@ pnpm openxiangda design cli mcp
|
|
|
41
41
|
|
|
42
42
|
按用户任务、业务材料和实际设备选择整体方向，包括导航形态、布局、层次、密度、字体、色彩、间距、组件与交互状态。已有“标准后台必须默认外观”“后台一律不设计移动”等审美和设备约定不再是限制。设备适用性由真实任务决定；不要机械增加没有用户任务的页面。
|
|
43
43
|
|
|
44
|
+
应用结构先于视觉改版：标准管理后台是默认骨架，必须保留平台 Shell、后台路由、显式菜单、资源表单、数据列表、权限和流程入口。OpenDesign 对后台只做布局、视觉和交互优化，不能用独立原型、单页 HTML 或 iframe 替换后台。用户端 PC 与移动端按真实旅程分别设计，可以完整采用 OpenDesign 的视觉与交互，但通过平台 runtime/Data API 连接后台数据，并保持与后台分离的权限和导航状态。设计交接时分别标记后台、用户端 PC、用户端移动端的页面归属和验收入口。
|
|
45
|
+
|
|
44
46
|
先复用 PC/移动 Field Kit 的输入、校验、上传、只读和权限行为。组件外观、布局及专业控件可据设计优化；换组件时证明字段值、未保存输入、拒绝和恢复行为仍正确。Shell 的路由、当前用户、授权菜单事实继续来自平台；`ui` 提供视觉参数，局部 CSS 可以编排布局，结构扩展应走平台支持的组件接口，不能复制导航状态。
|
|
45
47
|
|
|
46
48
|
上游模板的桌面/手机预览框、固定侧栏、虚构指标、限定图表库和示例品牌仅服务其示例。原文中的字体/颜色数量、渐变等规则用于评审设计理由，不能压过实际品牌、中文阅读或已确认任务。借鉴参考的可描述特征，不复制品牌素材或凭空声称业务事实。
|
|
@@ -50,7 +52,7 @@ pnpm openxiangda design cli mcp
|
|
|
50
52
|
## 从设计到真实页面 {#loop}
|
|
51
53
|
|
|
52
54
|
1. 从当前 AppSpec 和实际界面识别主任务、目标用户、设备、约束与已有证据。新方向给出有理由的推荐；实际有取舍时最多比较两个方向，已确认意图不重复问。
|
|
53
|
-
2.
|
|
55
|
+
2. AI 通过原版 CLI/MCP 创建或复用项目、选择模板/设计系统，提供任务与必要参考；工作目录由当前 OpenXiangda 工作区确定。使用原版工作流形成设计方向，保留上游的项目和资源结构；用户可选打开客户端查看。
|
|
54
56
|
3. 通过原版 Agent、项目和预览做可运行原型，关键任务能从入口走到完成。标明示例数据；覆盖适用的空、加载、失败、拒绝、校验、提交中和成功状态。真实业务请求尚未接入时明确说明。
|
|
55
57
|
4. 使用原版预览、lint、导出和修正能力；在目标尺寸实际打开、点击和键盘操作。证据记录实际 URL/文件、尺寸、操作与发现，没有浏览器证据就写未验证。不能用 AI 评分或勾选表代替画面和操作结果。
|
|
56
58
|
5. 依据已有授权和实际答复记录确认范围，固定设计文档和 assets 摘要。工具检查只证明资料与资源一致，不代表审美通过。
|
|
@@ -16,6 +16,14 @@
|
|
|
16
16
|
|
|
17
17
|
管理后台的设备范围按实际办理任务确定。数据管理、录入和报表复用平台 Shell 的路由与菜单事实，视觉依据[OpenDesign 工作流](design-workflow.md)设计；存在手机办理任务时同步设计与验证。
|
|
18
18
|
|
|
19
|
+
### 应用骨架优先与 OpenDesign 页面边界
|
|
20
|
+
|
|
21
|
+
标准管理后台是每个业务应用的默认开发骨架，必须保留后台 Shell、显式菜单、资源表单、数据列表、详情/编辑、权限和流程入口。开发顺序先完成后台资源与契约，再实现用户端 PC/移动端；不能以用户端首页或设计原型替代后台。
|
|
22
|
+
|
|
23
|
+
OpenDesign 可以在标准后台内部优化布局、视觉和交互，但后台仍复用平台 Shell、导航、字段行为和权限。用户端 PC 与移动端可以分别采用 OpenDesign 的完整视觉和交互，通过平台 runtime/Data API 使用后台数据。禁止用单页 HTML、iframe 或自定义假后台替换标准后台，也不能把后台权限、导航状态复制到用户端。
|
|
24
|
+
|
|
25
|
+
发布前分别验证后台入口、表单、数据列表、流程入口和用户端 PC/移动端入口；没有完成后台骨架的应用不得发布。
|
|
26
|
+
|
|
19
27
|
| 任务 | 页面与组件起点 |
|
|
20
28
|
| --- | --- |
|
|
21
29
|
| 简单管理列表、表单、详情 | 显式标准 CRUD，复用平台字段行为并应用本应用设计 |
|
|
@@ -141,4 +141,4 @@ context 的 `readyForImplementation` 为真时才制定具体实现任务，把
|
|
|
141
141
|
- [Design OS，固定提交](https://github.com/buildermethods/design-os/tree/529dedb43bfec24b2cbb128f26dd8cbc6143f754)（MIT）。
|
|
142
142
|
- [Spec Kit，固定提交](https://github.com/github/spec-kit/tree/4a7341a93d944d6efe153b71da4a1adb9c2b578c)（MIT）。
|
|
143
143
|
|
|
144
|
-
|
|
144
|
+
有界面影响的工作默认由 AI 通过 design cli / 原版 MCP 使用 OpenDesign，完成可运行原型、浏览器修正及实现交接，见[设计工作流](design-workflow.md)。客户端仅用于用户主动预览；原版运行时拥有完整设计资源和工作流，随包方法与 Craft 仅作离线参考。
|