openxiangda-skill-kit 2.0.14 → 2.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.0.14",
+  "version": "2.0.16",
   "description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "openxiangda-devkit-core": "2.5.1"
+    "openxiangda-devkit-core": "2.6.1"
   },
   "devDependencies": {
     "tsx": "4.23.12",

package/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "5a9de1acf40c78b2b73d45a5feae2cb28e6bb6cad03f512928bfdb21443a1152"
+      "sha256": "82852e5d0e0aac4a66d6d5f769e0e26a714b76692a7b148cea0331a073fb9ffe"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -60,7 +60,7 @@ pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ skill install --force
 
 总纲维护领域与模型关系、PC/移动任务页面、页面/操作/行/字段权限、多角色组合和容量预算。新增功能先评估影响，普通 CRUD、流程、消息等复用平台能力。明确数据量、分页/索引、请求次数、并发/批量和延迟目标，避免无界全量读取、逐行请求与无限重试。
 
-新应用和改变业务含义的工作，先以实际用户答复和设计内容摘要形成评审，确认 readyForImplementation 后再写实施任务；纯文案和无行为调整引用已有有效基线，不新建评审或重复确认。不能只改摘要或虚构确认让检查通过；工具结构检查不证明体验合格。本轮 ChangeSpec 关联评审、需求依据、方案、任务、源码、AC 场景和验收证据；多个变更时用提交说明 `AppSpec: <ID>` 指明本次交付。测试发布前完成设计和计划，部署后按实际角色、拒绝路径和性能样本验收。生产使用绑定测试运行及包摘要的 `appspec/verification/<运行ID>.json`。更新当前规则后归档，保留未覆盖项、失败原因、发布指针和交接。不可编造需求确认或通过结果；参见 [AppSpec](references/appspec.md)。
+新应用和改变业务含义的工作，先以实际用户答复和设计内容摘要形成评审，确认 readyForImplementation 后再写实施任务；纯文案和无行为调整引用已有有效基线，不新建评审或重复确认。不能只改摘要或虚构确认让检查通过；工具结构检查不证明体验合格。本轮 ChangeSpec 关联评审、需求依据、方案、任务、源码、AC 场景和验收证据；多个变更时用提交说明 `AppSpec: <ID>` 指明本次交付。测试发布前完成设计和计划，部署后按实际角色、拒绝路径和性能样本验收。生产使用绑定测试运行及包摘要的 `appspec/verification/<运行ID>.json`。用户明确延期性能时，按 AppSpec 记录有实际授权来源和后续安排的 `performanceDeferral`，保留原失败测量并报告延期未通过；该记录不豁免功能 AC。更新当前规则后归档，保留未覆盖项、失败原因、发布指针和交接。不可编造需求确认或通过结果；参见 [AppSpec](references/appspec.md)。
 
 ## 使用当前事实
 

package/skills/openxiangda-v2/references/application-foundation.md

@@ -37,6 +37,21 @@ export const recordsModule = defineApplicationModule({
 
 不写 `crud` 时仅注册数据模型；`crud: [{ model: records.code }]` 使用标准页面默认字段。列表默认列、表单、详情的字段选择均保持给定顺序。一个模型可以声明多套命名视图，各自配置字段、分组和操作入口，共用同一份数据和权限。
 
+列表可通过公开声明关闭本期不提供的导入、导出任务：
+
+```ts
+list: defineResourceList(records, {
+  fields: ['title', 'enabled'],
+  actions: { import: false, export: false },
+})
+```
+
+省略某个开关保持默认行为，`false` 隐藏对应入口。`true` 仍遵循已有权限和写入归属，
+不会授予导入或数据读取权限。默认与命名视图各自声明；PC 原生或流程导入、PC/移动导出
+使用该视图同一设置。直接声明 `data.resources[].list` 时同样支持 `actions`。
+这是页面任务配置，Data API 仍按原权限执行；敏感字段必须使用字段权限控制。
+发布此声明需要平台采用匹配的 contracts 校验版本，无需新增数据库迁移。
+
 ```ts
 // openxiangda.config.ts
 import { defineOpenXiangdaApp, resourceRoleCapabilities } from 'openxiangda/config';

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

@@ -101,6 +101,26 @@ pnpm openxiangda spec check
 
 本地证据路径必须位于工作区内且文件存在；长期报告也可引用 HTTPS 证据。工具核对引用格式、版本绑定、场景覆盖与数值，不替代对截图、业务含义或外部证据真实性的评估。授权角色成功和禁止角色拒绝分别验证；支持范围之外的渠道在需求范围与未覆盖清单中明确说明。
 
+用户明确将性能验收延期时，在同一报告增加 `performanceDeferral`：
+
+```json
+{
+  "performanceDeferral": {
+    "status": "deferred",
+    "reason": "用户实际决定延期的原因与本期范围",
+    "followUp": "后续负责方、处理安排及保留的未完成事项",
+    "authorizedBy": "实际授权人；若由代理转达，注明真实来源及转达关系",
+    "authorizedAt": "实际授权时间ISO8601，不能晚于报告记录时间",
+    "authorizationSource": "实际用户消息或需求来源的稳定引用",
+    "evidence": ["appspec/product/actual-user-decisions.md"]
+  }
+}
+```
+
+以上仍是格式示例，不代表发生了授权。`performance` 保留已取得的真实测量，包括超标样本；确实未测时可为 `[]`。不得仅挑选成功样本、提高目标或删除原失败来美化结果。延期原因、后续安排、授权人、时间、来源和证据必须完整；工具不从超时或 AI 判断推断授权。由代理转达用户决定时，证据应定位实际用户答复，授权时间取该决定的记录时间，报告生成时间另写 `recordedAt`。
+
+`spec verify` / MCP 返回 `performance.status: "deferred"`、测量条数和 `overBudget` 数量；生产阶段同时显示“性能按用户授权延期（未通过）”。这表示该版本的功能验收满足本次交付范围，性能仍未通过。没有延期记录时，缺少测量或超标仍阻断；延期不能豁免任何失败、未测或缺失的 AC，也不能改变原 TEST 版本、包摘要、设计基线和生产授权。结构检查不能证明授权、证据内容或实际体验真实。
+
 ```bash
 pnpm openxiangda spec verify --deployment <测试运行ID>
 # 报告也可显式指定；生产晋级按运行 ID 读取默认路径

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

@@ -59,6 +59,8 @@ pnpm openxiangda status <deployment-id> --watch
 
 先按真实操作保存 `appspec/verification/<测试运行ID>.json` 并提交、推送到主线。晋级会从测试源码提交读取原验收计划，核对报告的运行 ID、包摘要、AC 场景与性能证据；主线后来的需求不改变已测范围。
 
+性能若由用户明确延期，按 [AppSpec 延期记录](appspec.md)填写有证据的 `performanceDeferral` 并保留原测量。晋级阶段明确显示性能未通过；功能 AC 和其余版本/权限门禁继续执行。仅升级验收工具和补充报告不会重建原测试制品。
+
 该版本的源码提交必须仍包含在权威远端主分支中。主分支后来有新提交，不会改变本次晋级的制品。若任务分支采用 squash/rebase 合并，应在最终主线提交上重新冻结并验证测试候选，不能继续晋级合并前的提交。
 
 ```bash

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

@@ -145,7 +145,7 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 
 ## appspec_verify
 
-核对业务验收报告。读取成功测试运行与 Git 中的真实验收报告，核对版本绑定、场景结果和性能证据；不自动编造或执行验收。
+核对业务验收报告。读取成功测试运行与 Git 中的真实验收报告，核对版本绑定、场景结果和性能证据；有实际授权的性能延期单列为deferred未通过，不豁免功能AC，不自动编造或执行验收。
 
 - 只读：是
 - 可替换文件或改变远端状态：否

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

@@ -12,6 +12,8 @@ CI、离线开发或尚未发布的候选包使用 `pnpm openxiangda check --loc
 
 结果中的 AppSpec/lifecycle 单独列出需求与设计缺口；普通 check 可以继续验证尚未完成的实现。正式测试发布前核对总纲、关联变更、权限、性能预算和 AC 计划，测试部署之后再执行真实角色验收。生产晋级按 [AppSpec 报告](appspec.md)核对指定测试版本的实际结果。
 
+用户明确延期的性能项使用报告的 `performanceDeferral`，记录实际授权与后续安排并保留原超标样本。结果明确区分功能通过与性能延期；不补造测量，不放宽功能 AC。
+
 本地与平台使用同一份纯校验规则，并核对实现摘要和配置投影摘要。必需登录提供方、目标环境的密钥可用性、已有模型的物理字段约束和应用管理权限会在构建前检查；预检不读取密钥明文、不创建物理表、不修改环境。现场变化仍由平台在真正执行时复核。
 
 检查会写本地生成结果并按需初始化后端，不是只读操作。前置阶段失败后，下游阶段标为 skipped，不继续构建或上传。保留错误码、pointer、details 和下一步，修正原因后重试。