openxiangda-skill-kit 2.0.20 → 2.1.0

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.
@@ -64,11 +64,11 @@ AppSpec 是唯一设计记录位置。`app.md` 是总纲与目录,详细规则
64
64
 
65
65
  页面必须记录初始加载、刷新、首次空数据、筛选无结果、错误、无权限、提交中、成功、明确失败、结果未知及并发冲突的适用性。公共状态可引用共用设计,逐页写差异;不适用时写具体理由。详细逐页检查与标准方案见[交互模式](interaction-patterns.md)。
66
66
 
67
- 管理后台默认只在 PC 操作,页面规格写明“后台仅 PC,移动不适用”即可,不为材料完整度扩出手机后台。只有用户端有明确手机任务时才设计对应移动页面。页面设计同时选择标准 CRUD、后台自定义页或独立 user 页;报表等专业交互应主动评估成熟组件与开源库,按[前端选型](frontend.md#component-selection)记录选择与理由。
67
+ 页面规格依据真实用户任务说明设备范围;不以历史后台 PC 约定限制必要移动任务,也不为材料完整度增加没有使用场景的页面。页面设计同时选择标准 CRUD、后台自定义页或独立 user 页;报表等专业交互应主动评估成熟组件与开源库,按[前端选型](frontend.md#component-selection)记录选择与理由。
68
68
 
69
69
  ## AppSpec 材料模板 {#templates}
70
70
 
71
- 应用资料放在 `product/`(来源与 PRD)、`experience/`(旅程和逐页规格)、`design/`(视觉、权限和架构)、`reviews/`(评审)下。它们都是 `appspec/` 内单层 Markdown;不要使用嵌套页面目录。只为实际需要的材料建文件,不复制一批“已确认”示例。
71
+ 应用资料放在 `product/`(来源与 PRD)、`experience/`(旅程和逐页规格)、`design/`(视觉、权限和架构)、`reviews/`(评审)下。AppSpec 记录仍用这些目录内单层 Markdown;视觉设计包和自包含原型放在 `design/system`、`design/prototypes` 下,通过 assets 纳入评审,详见[设计工作流](design-workflow.md)。只为实际需要的材料建文件,不复制一批“已确认”示例。
72
72
 
73
73
  设计文件采用下面的受限 YAML;按实际类型和稳定 ID 修改。`documents` 引用本文件依赖的其他设计、总纲、CAP 或 ADR,不能引用 ChangeSpec 形成计划与基线循环。正文保存详细设计;来源可在正文引用脱敏文件或 HTTPS 链接。
74
74
 
@@ -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
- 视觉收敛与体验检查可参考 [Impeccable](https://github.com/pbakaus/impeccable/tree/831cabee8b4bc1a2b66e5ae22003e9a19b57d464) [DESIGN.md](https://github.com/google-labs-code/design.md/tree/9bf8eae67128b6cc55ad9bf86665767deb4c11cd) 的方法(Apache-2.0)。本专题不承诺这些项目的当前版本或排名,也不因案例要求增加平台功能。
144
+ 有界面影响的工作默认通过 design open / design cli 使用原版 OpenDesign,完成可运行原型、浏览器修正及实现交接,见[设计工作流](design-workflow.md)。原版运行时拥有完整设计资源和工作流;随包方法与 Craft 仅作离线参考。
@@ -28,7 +28,7 @@ CI、离线开发或尚未发布的候选包使用 `pnpm openxiangda check --loc
28
28
 
29
29
  Web 默认保留开发服务回环访问检查。按需 Nest 使用 `tsx --test` 发现项目中的业务测试;没有用例时只有零项测试,不能当成业务已验收。浏览器目录 `apps/web/e2e/` 起初只有编写说明,添加本应用的 `*.spec.ts` 后运行 `pnpm test:e2e`;真实角色验收绑定 AppSpec 和指定测试版本。
30
30
 
31
- 修改资源时验证声明、实际交付端的字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。管理后台默认仅 PC,不要求移动后台验收;只有已确认的用户移动页面需要验证移动交互。用允许角色验证成功,用禁止角色验证页面、操作、行和字段边界;存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责,应用不重复搭建平台数据库测试。
31
+ 修改资源时验证声明、实际交付端的字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。按实际设计的目标设备验证交互;存在移动办理任务时验证对应移动页面,不受历史后台 PC 约定限制。用允许角色验证成功,用禁止角色验证页面、操作、行和字段边界;存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责,应用不重复搭建平台数据库测试。
32
32
 
33
33
  应用入口或导航变更必须从平台应用列表实际点击进入,再验证应用根路径、登录返回和刷新后的深链接。使用后台的应用检查 `/admin` 进入首个有权菜单、自定义页只出现一个 Shell、菜单切换与未保存保护、无权限拒绝;纯用户应用验证其声明首页,不强制增加后台。直达开发者给出的 `/home` 或报表链接通过,不能替代平台实际入口验收。
34
34