openyida 2026.7.18 → 2026.7.21

package/yida-skills/skills/yida-skill-evaluator/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: yida-skill-evaluator
+description: >
+  评测指定的 openyida 技能质量。输入技能名称，自动执行全链路闭环评测
+  （静态校验 → 路由测试 → 安全合规 → 覆盖度 → 多维评分 → 准出门槛 → 优化建议），
+  生成评测报告和改进建议。不要触发本技能来执行其他 openyida 开发任务。
+triggers:
+  - 评测技能
+  - 测试技能
+  - skill eval
+  - 评估技能质量
+  - 跑一下评测
+  - 技能打分
+  - 检查技能
+  - 技能准出
+  - 评测 xx 技能
+  - run eval
+---
+
+## 触发条件
+
+当用户的意图是「评测/测试/检查某个 openyida 技能的质量」时触发。典型表述：
+
+- "评测一下 yida-dashboard 技能"
+- "帮我跑一下 skill eval"
+- "检查这个技能的质量"
+- "这个技能能不能准出？"
+- "评估 yida-report 技能"
+- "测试下路由准确率"
+
+## 前置条件
+
+1. 确认目标技能名称（如 `yida-dashboard`）。若用户未指定，列出可用技能供选择：
+   ```bash
+   ls yida-skills/skills/
+   ```
+2. 确认 Node.js 版本 ≥ 18：
+   ```bash
+   node --version
+   ```
+3. 确认依赖已安装：
+   ```bash
+   npm install
+   ```
+
+## 工作流
+
+### Step 1 — 快速评测（默认，无副作用）
+
+大多数情况使用 `pipeline` 模式，它会自动串联所有评测步骤：
+
+```bash
+node scripts/eval/pipeline.js --skill <技能名>
+```
+
+该命令自动执行以下全部步骤：
+1. 静态校验（文档规范性 + 可维护性）
+2. 路由测试（命中率 + 混淆对）
+3. 安全合规检查
+4. 覆盖度分析
+5. 10 维度综合评分 + 加权总分
+6. 准出门槛判定 + 自动优化建议
+
+产物目录：`project/.cache/eval/pipeline/<run-id>/`
+
+读取结果：
+```bash
+cat project/.cache/eval/pipeline/*/pipeline-report.json | tail -1
+```
+
+### Step 2 — 解读结果
+
+从 `pipeline-report.json` 中提取关键信息，向用户报告：
+
+1. **Pipeline 状态**：`status` 字段（pass / fail / warn）
+2. **各步骤结果**：`steps[]` 数组的 step / status / score / detail
+3. **总分**：`scorecard.overall`（0-100 分）
+4. **准出判定**：`scorecard.gate`（pass = 可准出，fail = 不可准出）
+5. **硬门槛详情**：`scorecard.hardGates` 中每项的状态
+6. **优化建议**：`suggestions[]` 中按 priority 排序的改进项
+
+### Step 3 — 深度评测（可选，用户要求时）
+
+如果用户要求更深度的评测（如 A/B 对比、JUnit 报告）：
+
+```bash
+# A/B 基线对比（with_skill vs without_skill）
+node scripts/eval/runner.js --mode baseline --skill <技能名> --format junit
+
+# 单独维度评测
+node scripts/eval/runner.js --mode doc-quality --skill <技能名>
+node scripts/eval/runner.js --mode comprehensive --skill <技能名>
+```
+
+### Step 4 — Web 控制台（可选）
+
+如果用户希望在浏览器中查看评测结果：
+
+```bash
+npm run eval:dashboard
+```
+
+然后打开 http://127.0.0.1:4500 查看控制台。
+
+### Step 5 — 输出评测报告
+
+向用户呈现结构化报告：
+
+```
+## 技能评测报告：<技能名>
+
+### Pipeline 状态：<PASS/FAIL/WARN>
+
+| 步骤 | 状态 | 分数 | 详情 |
+|------|------|------|------|
+| 静态校验 | ✔/✗ | xx | ... |
+| 路由测试 | ✔/✗ | xx% | ... |
+| 安全合规 | ✔/✗ | xx | ... |
+| 覆盖度 | ✔/✗ | xx% | ... |
+| 综合评分 | ✔/✗ | xx/100 | ... |
+| 准出判定 | ✔/✗ | - | ... |
+
+### 评分卡（10 维度）
+
+| 维度 | 得分 | 权重 | 加权得分 |
+|------|------|------|----------|
+| 规范性 | xx | 10% | x.x |
+| 可维护性 | xx | 5% | x.x |
+| 路由准确率 | xx | 15% | x.x |
+| ... | ... | ... | ... |
+| **总分** | **xx** | | |
+
+### 准出门槛
+
+| 门槛 | 要求 | 实际 | 状态 |
+|------|------|------|------|
+| 触发准确率 | ≥ 85% | xx% | ✔/✗ |
+| 步骤完成率 | = 100% | xx% | ✔/✗ |
+| 功能测试通过率 | ≥ 95% | xx% | ✔/✗ |
+| 输出格式正确率 | ≥ 85% | xx% | ✔/✗ |
+| 安全合规 | 0 failures | xx | ✔/✗ |
+
+### 优化建议（前 3 条）
+
+1. [blocker/critical/high] ...
+2. ...
+3. ...
+```
+
+## 可用评测模式
+
+| 模式 | 命令 | 说明 |
+|------|------|------|
+| pipeline | `--mode pipeline` | 全自动闭环（推荐） |
+| doc-quality | `--mode doc-quality` | 文档规范性 |
+| routing | `--mode routing` | 路由准确率 |
+| safety | `--mode safety` | 安全合规 |
+| coverage | `--mode coverage` | 覆盖度 |
+| comprehensive | `--mode comprehensive` | 10 维度评分 |
+| baseline | `--mode baseline` | A/B 基线对比 |
+| e2e | `--mode e2e` | 端到端基线（需 OPENYIDA_E2E=1） |
+| generate | `--mode generate` | 真实生成（需 OPENYIDA_E2E=1） |
+
+## WHEN NOT
+
+- **不处理**应用搭建、页面开发、数据管理等开发任务
+- **不处理**非 openyida 技能的评测
+- **不修改**技能文件——仅读取和评测（除非用户明确要求根据建议修改）
+- **不执行**需要真实宜搭资源的评测（e2e / generate），除非用户明确要求
+- 不与 `yida-dashboard`、`yida-report`、`yida-create-process` 等搭建类技能混淆

package/yida-skills/skills-index.json

@@ -3,39 +3,6 @@
   "source": "openyida",
   "entry": "openyida",
   "skills": [
-    {
-      "name": "large-file-write",
-      "path": "skills/large-file-write/SKILL.md",
-      "display_name": "大文件可靠写入",
-      "description": "解决 heredoc 或 shell 命令写入大文件内容被截断的问题。优先使用 agent 结构化文件写入工具；超大文件可用该工具创建 Node.js payload 后执行。适用于需要可靠写入超过 100 行文本文件时。",
-      "category": "yida-skills/agent",
-      "tags": [
-        "大文件",
-        "写入",
-        "结构化文件",
-        "heredoc"
-      ],
-      "aliases": [
-        "大文件写入"
-      ]
-    },
-    {
-      "name": "sls-log-workbench",
-      "path": "skills/sls-log-workbench/SKILL.md",
-      "display_name": "SLS 日志查询工作台",
-      "description": "SLS 日志查询工作台排查技能。用于快速定位和排查宜搭平台的页面请求、业务规则、集成自动化、流程审批、TraceId、灰度匹配等问题。",
-      "category": "yida-skills/ops",
-      "tags": [
-        "SLS",
-        "日志",
-        "排查",
-        "TraceId"
-      ],
-      "aliases": [
-        "日志查询",
-        "平台排障"
-      ]
-    },
     {
       "name": "yida-agent-center",
       "path": "skills/yida-agent-center/SKILL.md",
@@ -56,7 +23,8 @@
       "name": "yida-app",
       "path": "skills/yida-app/SKILL.md",
       "display_name": "宜搭完整应用开发",
-      "description": "从零到一搭建完整宜搭应用的流程编排技能。默认 fast_build 只创建应用、必要表单、主页面、发布并输出链接；不默认使用未绑定 dataSourceMap，导航、示例数据和深度设计按需后置。",
+      "description": "完整搭建或补齐普通 OpenYida 应用的流程编排技能。默认 fast_build 先解析并复用 app/page/form/process 上下文，只创建缺失且允许创建的应用、表单或页面；预创建占位应用在语义名称稳定后通过 update-app 重命名；不默认使用未绑定 dataSourceMap，导航、示例数据和深度设计按需后置。",
+      "done_when": "若本轮 Write/Edit 页面源码，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 并返回访问 URL；没有 publish 证据只能声明源码已修改，尚未发布。",
       "category": "yida-skills/app",
       "tags": [
         "宜搭",
@@ -136,7 +104,25 @@
       ],
       "aliases": [
         "业务关联"
-      ]
+      ],
+      "positive_signals": [
+        "业务关联规则",
+        "高级函数",
+        "表单内跨表联动",
+        "INSERT",
+        "UPDATE",
+        "DELETE 规则"
+      ],
+      "negative_signals": [
+        "集成自动化逻辑流",
+        "HTTP 连接器",
+        "页面 dataSourceMap",
+        "流程审批节点"
+      ],
+      "command_ids": [
+        "create-form.rule"
+      ],
+      "done_when": "业务关联规则配置写入目标表单 Schema。"
     },
     {
       "name": "yida-canvas-custom-page",
@@ -153,7 +139,28 @@
       "aliases": [
         "代码画布",
         "Canvas 页面"
-      ]
+      ],
+      "positive_signals": [
+        "Code Canvas",
+        "代码画布",
+        "现代 React 页面",
+        "官网首页",
+        "工作台",
+        "看板页面",
+        ".canvas.jsx"
+      ],
+      "negative_signals": [
+        "普通自定义页面 JSX/Jsx",
+        "强依赖 this.$",
+        "强依赖 this.dataSourceMap",
+        "renderJsx 旧页面迁移"
+      ],
+      "command_ids": [
+        "generate-page",
+        "build-page",
+        "publish"
+      ],
+      "done_when": "Canvas 源码生成或修改后，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 写入 YidaCodeCanvas Schema；没有 publish 证据只能声明源码已修改，尚未发布。"
     },
     {
       "name": "yida-canvas-data-binding",
@@ -203,7 +210,25 @@
       "aliases": [
         "高级图表",
         "数据大屏"
-      ]
+      ],
+      "positive_signals": [
+        "ECharts",
+        "高级图表",
+        "数据大屏图表",
+        "地图",
+        "雷达图",
+        "散点图"
+      ],
+      "negative_signals": [
+        "原生报表",
+        "完整驾驶舱交付",
+        "仅创建报表数据源"
+      ],
+      "command_ids": [
+        "sample",
+        "publish"
+      ],
+      "done_when": "ECharts 页面源码完成并发布，必要时报表数据源已绑定。"
     },
     {
       "name": "yida-connector",
@@ -273,7 +298,7 @@
       "name": "yida-create-app",
       "path": "skills/yida-create-app/SKILL.md",
       "display_name": "创建宜搭应用",
-      "description": "创建宜搭应用并返回 appType。搭建应用的第一步。",
+      "description": "仅在没有目标 app 且允许创建时创建宜搭应用并返回 appType。已绑定或预创建 app 不调用 create-app，应交给 yida-app 复用，并在需要时通过 update-app 重命名。",
       "category": "yida-skills/app",
       "tags": [
         "创建应用",
@@ -299,7 +324,32 @@
       "aliases": [
         "建表单",
         "字段设计"
-      ]
+      ],
+      "positive_signals": [
+        "创建表单",
+        "新建表单",
+        "新增字段",
+        "修改字段结构",
+        "字段联动",
+        "数据源绑定字段"
+      ],
+      "negative_signals": [
+        "查询表单数据",
+        "新增记录",
+        "更新记录",
+        "删除记录",
+        "发起流程实例"
+      ],
+      "command_ids": [
+        "create-form.create",
+        "create-form.update",
+        "create-form.patch",
+        "create-form.rule",
+        "create-form.validation",
+        "create-form.bind-datasource",
+        "create-form.add-option"
+      ],
+      "done_when": "表单结构创建或更新成功，并拿到真实 formUuid / fieldId 证据。"
     },
     {
       "name": "yida-create-page",
@@ -348,7 +398,28 @@
       "aliases": [
         "页面开发",
         "普通自定义页面"
-      ]
+      ],
+      "positive_signals": [
+        "普通自定义页面",
+        "Jsx 组件链路",
+        "this.$",
+        "this.utils.yida",
+        "this.dataSourceMap",
+        "renderJsx",
+        ".oyd.jsx"
+      ],
+      "negative_signals": [
+        "默认现代 React 页面",
+        "Code Canvas 默认链路",
+        "只做视觉方向决策"
+      ],
+      "command_ids": [
+        "sample",
+        "check-page",
+        "compile",
+        "publish"
+      ],
+      "done_when": "普通自定义页面源码通过 check-page / compile 后，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 发布到目标 display 页面；没有 publish 证据只能声明源码已修改，尚未发布。"
     },
     {
       "name": "yida-dashboard",
@@ -365,7 +436,26 @@
       "aliases": [
         "经营看板",
         "驾驶舱"
-      ]
+      ],
+      "positive_signals": [
+        "经营看板",
+        "管理驾驶舱",
+        "产品化工作台",
+        "指标闭环",
+        "行动看板"
+      ],
+      "negative_signals": [
+        "单个 ECharts 图",
+        "原生报表",
+        "只做页面视觉美化"
+      ],
+      "command_ids": [
+        "create-page",
+        "generate-page",
+        "create-report",
+        "publish"
+      ],
+      "done_when": "看板页面、数据来源和关键行动入口形成可访问交付。"
     },
     {
       "name": "yida-data-management",
@@ -382,7 +472,27 @@
       "aliases": [
         "数据管理",
         "造数"
-      ]
+      ],
+      "positive_signals": [
+        "查询数据",
+        "新增记录",
+        "更新记录",
+        "批量导入",
+        "表单实例",
+        "子表数据",
+        "任务中心"
+      ],
+      "negative_signals": [
+        "新增字段",
+        "修改表单结构",
+        "字段联动规则",
+        "页面数据源设计器配置"
+      ],
+      "command_ids": [
+        "data",
+        "task-center"
+      ],
+      "done_when": "目标数据查询或写入完成，并用 query/get 抽查真实记录。"
     },
     {
       "name": "yida-data-source-connectors",
@@ -574,13 +684,36 @@
       ],
       "aliases": [
         "自动化流"
-      ]
+      ],
+      "positive_signals": [
+        "集成自动化",
+        "逻辑流",
+        "提交后跨表写入",
+        "外部 API 自动化",
+        "开启自动化",
+        "关闭自动化",
+        "异常日志"
+      ],
+      "negative_signals": [
+        "表单内业务关联规则",
+        "只创建 HTTP 连接器动作",
+        "页面 dataSourceMap 数据源"
+      ],
+      "command_ids": [
+        "integration.create",
+        "integration.list",
+        "integration.enable",
+        "integration.disable",
+        "integration.check",
+        "integration.diagnose"
+      ],
+      "done_when": "集成自动化创建/启停/诊断完成，并返回 processCode 或检查结果。"
     },
     {
       "name": "yida-login",
       "path": "skills/yida-login/SKILL.md",
       "display_name": "宜搭登录态管理",
-      "description": "宜搭登录态管理。默认 OAuth token 模式，access_token / refresh_token 持久化到 .cache/auth-token-<env>.json。",
+      "description": "宜搭登录态管理。默认 OAuth token 模式；YIDA_AUTH_ENABLED=true 时使用宿主注入 token。",
       "category": "yida-skills/context",
       "tags": [
         "登录",
@@ -686,7 +819,25 @@
       ],
       "aliases": [
         "视觉决策"
-      ]
+      ],
+      "positive_signals": [
+        "页面美化",
+        "视觉方向",
+        "去 AI 味",
+        "高级感",
+        "品牌化",
+        "页面太丑"
+      ],
+      "negative_signals": [
+        "创建页面资源",
+        "发布页面",
+        "表单字段建模",
+        "数据记录操作"
+      ],
+      "command_ids": [
+        "generate-page"
+      ],
+      "done_when": "输出可执行视觉方向决策块，并交给页面实现技能落地。"
     },
     {
       "name": "yida-ppt",
@@ -741,6 +892,12 @@
       "path": "skills/yida-publish-page/SKILL.md",
       "display_name": "发布自定义页面",
       "description": "将自定义页面源码编译为宜搭可运行 Schema 并发布；源码依赖 dataSourceMap 但发布无数据源时不能视为完成。",
+      "command_ids": [
+        "check-page",
+        "compile",
+        "publish"
+      ],
+      "done_when": "final 证据只认真实执行成功的 openyida publish <source> <appType> <displayPageFormUuid> 命令结果；本地文件编辑、diff、check-page 或 compile 不能证明远端页面已更新。",
       "category": "yida-skills/page",
       "tags": [
         "发布",
@@ -766,7 +923,24 @@
       ],
       "aliases": [
         "原生报表"
-      ]
+      ],
+      "positive_signals": [
+        "原生报表",
+        "统计报表",
+        "指标卡",
+        "表格报表",
+        "筛选器"
+      ],
+      "negative_signals": [
+        "ECharts 大屏",
+        "产品化驾驶舱页面",
+        "自定义页面视觉实现"
+      ],
+      "command_ids": [
+        "create-report",
+        "append-chart"
+      ],
+      "done_when": "原生报表或图表创建成功并返回 reportId / 页面链接。"
     },
     {
       "name": "yida-table-form",
@@ -801,6 +975,22 @@
         "品牌色"
       ]
     },
+    {
+      "name": "yida-skill-evaluator",
+      "path": "skills/yida-skill-evaluator/SKILL.md",
+      "display_name": "技能质量评测",
+      "description": "评测指定的 openyida 技能质量，自动执行多维评测（规范性、触发准确率、执行完整性、输出有效性、可维护性），生成评测报告和改进建议。",
+      "category": "yida-skills/ops",
+      "tags": [
+        "评测",
+        "技能质量",
+        "skill eval",
+        "评估"
+      ],
+      "aliases": [
+        "技能评测"
+      ]
+    },
     {
       "name": "yida-voc",
       "path": "skills/yida-voc/SKILL.md",
@@ -946,13 +1136,8 @@
     {
       "name": "yida-skills/ops",
       "display_name": "排障与支持",
-      "description": "SLS 日志排查、数据库 Sequence 修复、VOC 故障/需求反馈材料整理。",
+      "description": "数据库 Sequence 修复、VOC 故障/需求反馈材料整理。",
       "signals": [
-        "SLS",
-        "日志",
-        "traceId",
-        "排障",
-        "灰度",
         "Sequence",
         "主键冲突",
         "VOC",
@@ -962,9 +1147,8 @@
     {
       "name": "yida-skills/agent",
       "display_name": "Agent 辅助工具",
-      "description": "非宜搭业务资源本身的 agent 辅助能力：大文件可靠写入、导出对话、会议/闪记转 PRD。",
+      "description": "非宜搭业务资源本身的 agent 辅助能力：导出对话、会议/闪记转 PRD。",
       "signals": [
-        "大文件写入",
         "导出对话",
         "会议纪要",
         "闪记",