openxiangda-skill-kit 2.0.19 → 2.1.0

package/skills/openxiangda-v2/references/product-design.md

@@ -64,9 +64,11 @@ AppSpec 是唯一设计记录位置。`app.md` 是总纲与目录，详细规则
 
 页面必须记录初始加载、刷新、首次空数据、筛选无结果、错误、无权限、提交中、成功、明确失败、结果未知及并发冲突的适用性。公共状态可引用共用设计，逐页写差异；不适用时写具体理由。详细逐页检查与标准方案见[交互模式](interaction-patterns.md)。
 
+页面规格依据真实用户任务说明设备范围；不以历史后台 PC 约定限制必要移动任务，也不为材料完整度增加没有使用场景的页面。页面设计同时选择标准 CRUD、后台自定义页或独立 user 页；报表等专业交互应主动评估成熟组件与开源库，按[前端选型](frontend.md#component-selection)记录选择与理由。
+
 ## AppSpec 材料模板 {#templates}
 
-应用资料放在 `product/`（来源与 PRD）、`experience/`（旅程和逐页规格）、`design/`（视觉、权限和架构）、`reviews/`（评审）下。它们都是 `appspec/` 内单层 Markdown；不要使用嵌套页面目录。只为实际需要的材料建文件，不复制一批“已确认”示例。
+应用资料放在 `product/`（来源与 PRD）、`experience/`（旅程和逐页规格）、`design/`（视觉、权限和架构）、`reviews/`（评审）下。AppSpec 记录仍用这些目录内单层 Markdown；视觉设计包和自包含原型放在 `design/system`、`design/prototypes` 下，通过 assets 纳入评审，详见[设计工作流](design-workflow.md)。只为实际需要的材料建文件，不复制一批“已确认”示例。
 
 设计文件采用下面的受限 YAML；按实际类型和稳定 ID 修改。`documents` 引用本文件依赖的其他设计、总纲、CAP 或 ADR，不能引用 ChangeSpec 形成计划与基线循环。正文保存详细设计；来源可在正文引用脱敏文件或 HTTPS 链接。
 
@@ -139,4 +141,4 @@ context 的 `readyForImplementation` 为真时才制定具体实现任务，把
 - [Design OS，固定提交](https://github.com/buildermethods/design-os/tree/529dedb43bfec24b2cbb128f26dd8cbc6143f754)（MIT）。
 - [Spec Kit，固定提交](https://github.com/github/spec-kit/tree/4a7341a93d944d6efe153b71da4a1adb9c2b578c)（MIT）。
 
-视觉收敛与体验检查可参考 [Impeccable](https://github.com/pbakaus/impeccable/tree/831cabee8b4bc1a2b66e5ae22003e9a19b57d464) 与 [DESIGN.md](https://github.com/google-labs-code/design.md/tree/9bf8eae67128b6cc55ad9bf86665767deb4c11cd) 的方法（Apache-2.0）。本专题不承诺这些项目的当前版本或排名，也不因案例要求增加平台功能。
+有界面影响的工作默认通过 design open / design cli 使用原版 OpenDesign，完成可运行原型、浏览器修正及实现交接，见[设计工作流](design-workflow.md)。原版运行时拥有完整设计资源和工作流；随包方法与 Craft 仅作离线参考。

package/skills/openxiangda-v2/references/testing.md

@@ -28,7 +28,9 @@ CI、离线开发或尚未发布的候选包使用 `pnpm openxiangda check --loc
 
 Web 默认保留开发服务回环访问检查。按需 Nest 使用 `tsx --test` 发现项目中的业务测试；没有用例时只有零项测试，不能当成业务已验收。浏览器目录 `apps/web/e2e/` 起初只有编写说明，添加本应用的 `*.spec.ts` 后运行 `pnpm test:e2e`；真实角色验收绑定 AppSpec 和指定测试版本。
 
-修改资源时验证声明、PC/移动字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。用允许角色验证成功，用禁止角色验证页面、操作、行和字段边界；存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责，应用不重复搭建平台数据库测试。
+修改资源时验证声明、实际交付端的字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。按实际设计的目标设备验证交互；存在移动办理任务时验证对应移动页面，不受历史后台 PC 约定限制。用允许角色验证成功，用禁止角色验证页面、操作、行和字段边界；存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责，应用不重复搭建平台数据库测试。
+
+应用入口或导航变更必须从平台应用列表实际点击进入，再验证应用根路径、登录返回和刷新后的深链接。使用后台的应用检查 `/admin` 进入首个有权菜单、自定义页只出现一个 Shell、菜单切换与未保存保护、无权限拒绝；纯用户应用验证其声明首页，不强制增加后台。直达开发者给出的 `/home` 或报表链接通过，不能替代平台实际入口验收。
 
 只改文案时验证受影响页面。复杂事务、并发和值转换使用聚焦测试。浏览器验收实际操作并检查错误，不能用模拟响应或空页面加载代替真实角色验收。
 

package/skills/openxiangda-v2/references/workflow-events.md

@@ -18,6 +18,46 @@
 权限、记录修订约束、文件引用、日期触发和流程命令继续生效，自定义 `emitEvent`
 也不受该策略影响。策略通过正常应用版本发布、测试和生产晋级生效。
 
+## 平台原生数据自动化
+
+只涉及平台表单数据增删改的自动化，可以直接声明 `execution`，无需应用 Nest
+服务和事件 HTTP 接收器。需要平台 `events.native-data-actions` 1.0.0 能力。
+例如已声明 `items`、`copies` 模型及相应字段后：
+
+```ts
+events: {
+  capturePolicies: [
+    { resourceCode: 'items', mode: 'subscribed' },
+    { resourceCode: 'copies', mode: 'subscribed' },
+  ],
+  subscriptions: [{
+    code: 'copy-item',
+    eventTypes: ['openxiangda.data.record.created.v2'],
+    filter: { resourceCodes: ['items'] },
+    execution: {
+      kind: 'native-data', version: 1,
+      operations: [{
+        operation: 'create', resourceCode: 'copies',
+        data: {
+          name: { source: 'event', path: 'data.projection.name' },
+          sourceId: { source: 'event', path: 'data.recordId' },
+        },
+      }],
+    },
+  }],
+},
+```
+
+编译器自动收集必需的事件字段并固定目标资源摘要。动作效果与执行结果同事务
+提交，重复消息和人工重放使用同一个效果标记。更新、删除还必须映射 `id` 和
+`expectedRevision`，冲突不会覆盖新数据。常量使用 `{ source: 'literal', value }`。
+首版支持数据事件、明确的源资源、最多 16 个操作、每次最多 32 个映射字段和
+64 KiB 输入，不执行脚本、SQL、HTTP 或应用代码。目标模型发生不兼容变化时停止
+旧动作并报告错误；关闭并排空此类动作后才能回退到不支持该能力的平台镜像。
+
+外部 Webhook 和自定义代码仍使用已有签名、回执、重试及接收端幂等协议，按至少
+一次投递处理。轻量操作历史仍通过已有审计 API 查询，不依赖是否订阅了事件。
+
 ## 标准详情与当前用户入口
 
 普通记录、流程记录、任务和实例复用同一详情框架。流程详情提供申请内容、审批历史和变更记录三个标签页；管理员在当前抽屉或页面中切换到普通表单编辑，直接保存并自动留下变更记录，审批结果保持不变。PC 子表在表格内编辑，父表提交时统一校验。