openyida 2026.7.26-beta.2 → 2026.7.27-beta.1

package/README.md

@@ -414,6 +414,8 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida data <action> <resource> [args]` | Unified data management (form/process/task/subform) |
 | `openyida task-center <type> [options]` | Global task center (todo/processed/cc etc.) |
 | `openyida basic-info <overview\|commodity\|grant\|capacity\|quota\|abs-path\|dataflow\|i18n\|domain>` | Query organization basic info, capacity, quotas, and domain settings |
+| `openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]` | Fetch Markdown content from a DingTalk document |
+| `openyida read-dingtalk-tingji <taskUuid> [--json]` | Fetch DingTalk Tingji details by task UUID |
 | `openyida get-permission <appType> <formUuid>` | Query form permission config |
 | `openyida save-permission <appType> <formUuid> ...` | Save form permission config |
 | `openyida corp-manager <search-user\|list\|add\|remove\|address-book> ...` | Manage platform admins and address book permissions |

package/bin/yida.js

@@ -869,6 +869,18 @@ async function main() {
       break;
     }
 
+    case 'read-dingtalk-doc': {
+      const { run } = require('../lib/document/document-markdown');
+      await run(args);
+      break;
+    }
+
+    case 'read-dingtalk-tingji': {
+      const { run } = require('../lib/document/tingji');
+      await run(args);
+      break;
+    }
+
     case 'doctor': {
       const { run } = require('../lib/core/doctor');
       await run(args);

package/lib/core/command-manifest.js

@@ -402,9 +402,17 @@ const COMMAND_SIDE_EFFECTS = new Map([
     'integration.list',
     'list-forms',
     'process.preview',
+    'read-dingtalk-tingji',
     'verify-short-url',
   ], sideEffect('remote_read')),
 
+  ['read-dingtalk-doc', sideEffect('mixed', {
+    mutates_yida: false,
+    mutates_local: true,
+    read_actions: ['<docUrl>', '<docUrl> --json'],
+    mutating_actions: ['<docUrl> --output <file>', '<docUrl> -o <file>'],
+  })],
+
   ['asset', sideEffect('mixed', {
     mutates_yida: false,
     mutates_local: true,
@@ -620,11 +628,24 @@ const COMMAND_PERMISSIONS = new Map([
     'integration.list',
     'list-forms',
     'process.preview',
+    'read-dingtalk-tingji',
     'verify-short-url',
   ], permission('allow', 'read', {
     reason: 'Read-only, diagnostic, validation, or manifest discovery command.',
   })),
 
+  ['read-dingtalk-doc', actionDependentPermission({
+    preauthorized_actions: [
+      '<docUrl> --output <file>',
+      '<docUrl> -o <file>',
+    ],
+    preauthorized_patterns: [{
+      type: 'argv_contains_any',
+      values: ['http://', 'https://'],
+      description: 'A valid document URL is present; optional output writes are non-destructive local operations.',
+    }],
+  })],
+
   ...permissionEntries([
     'eval',
   ], actionDependentPermission({
@@ -1038,6 +1059,12 @@ const COMMAND_GROUPS = [
       command('basic-info', ['basic-info'], 'basic-info <overview|commodity|grant|capacity|quota|abs-path|dataflow|i18n|domain>', 'help.cmd_basic_info', {
         output: 'json',
       }),
+      command('read-dingtalk-doc', ['read-dingtalk-doc'], 'read-dingtalk-doc <docUrl> [--output <file>] [--json]', 'help.cmd_read_dingtalk_doc', {
+        output: 'text|json',
+      }),
+      command('read-dingtalk-tingji', ['read-dingtalk-tingji'], 'read-dingtalk-tingji <taskUuid> [--json]', 'help.cmd_read_dingtalk_tingji', {
+        output: 'json',
+      }),
       command('get-permission', ['get-permission'], 'get-permission <appType> <formUuid>', 'help.cmd_get_permission'),
       command('save-permission', ['save-permission'], 'save-permission <appType> <formUuid> ...', 'help.cmd_save_permission'),
       command('corp-manager', ['corp-manager'], 'corp-manager <search-user|list|add|remove|address-book> ...', 'help.cmd_corp_manager', { output: 'json' }),

package/lib/core/locales/en.js

@@ -47,6 +47,8 @@ module.exports = {
     cmd_data: 'Unified data management (form/process/task/subform)',
     cmd_task_center: 'Global task center (todo/processed/cc etc.)',
     cmd_basic_info: 'Query organization basic info, capacity, quotas, and domain settings',
+    cmd_read_dingtalk_doc: 'Fetch Markdown content from a DingTalk document',
+    cmd_read_dingtalk_tingji: 'Fetch DingTalk Tingji details by task UUID',
     cmd_get_permission: 'Query form permission config',
     cmd_save_permission: 'Save form permission config',
     cmd_corp_manager: 'Manage platform admins and address book permissions',

package/lib/core/locales/zh.js

@@ -47,6 +47,8 @@ module.exports = {
     cmd_data: '统一数据管理（表单/流程/任务/子表单）',
     cmd_task_center: '全局任务中心（待办/已处理/抄送等）',
     cmd_basic_info: '查询组织基本信息、容量、额度和域名设置',
+    cmd_read_dingtalk_doc: '获取钉钉文档的 Markdown 内容',
+    cmd_read_dingtalk_tingji: '按任务 UUID 获取钉钉听记详情',
     cmd_get_permission: '查询表单权限配置',
     cmd_save_permission: '保存表单权限配置',
     cmd_corp_manager: '管理平台管理员与通讯录权限',

package/lib/core/utils.js

@@ -916,6 +916,18 @@ async function httpGet(baseUrl, requestPath, queryParams, cookiesOrOptions, mayb
           });
           return;
         }
+        if (optionsOverride.responseType === 'text') {
+          if (Number(res.statusCode) < 200 || Number(res.statusCode) >= 300) {
+            resolve({
+              success: false,
+              errorMsg: `HTTP ${res.statusCode}`,
+              __httpStatus: res.statusCode,
+            });
+            return;
+          }
+          resolve(data);
+          return;
+        }
         try {
           const parsed = JSON.parse(data);
           if (isLoginExpired(parsed)) {

package/lib/document/document-markdown.js

@@ -0,0 +1,113 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { createAuthRef, createYidaClient } = require('../core/yida-client');
+const { throwUsage } = require('../core/command-errors');
+
+const API_PATH = '/query/document/markdown.json';
+
+function parseArgs(args) {
+  const parsed = { docUrl: '', output: '', json: false, help: false };
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index];
+    if (arg === '--help' || arg === '-h') {
+      parsed.help = true;
+    } else if (arg === '--json') {
+      parsed.json = true;
+    } else if ((arg === '--output' || arg === '-o') && args[index + 1]) {
+      parsed.output = args[++index];
+    } else if (!arg.startsWith('--') && !parsed.docUrl) {
+      parsed.docUrl = arg;
+    } else {
+      throwUsage('Usage: openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]');
+    }
+  }
+  return parsed;
+}
+
+function validateDocUrl(docUrl) {
+  if (!docUrl) {
+    throwUsage('Usage: openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]');
+  }
+  let parsed;
+  try {
+    parsed = new URL(docUrl);
+  } catch {
+    throw new Error('docUrl must be a valid HTTP(S) URL');
+  }
+  if (!['http:', 'https:'].includes(parsed.protocol)) {
+    throw new Error('docUrl must be a valid HTTP(S) URL');
+  }
+  return parsed.toString();
+}
+
+function unwrapMarkdownResponse(response) {
+  if (typeof response !== 'string') {
+    const detail = response && (response.errorMsg || response.message);
+    throw new Error(detail || 'Failed to fetch document Markdown');
+  }
+
+  const trimmed = response.trim();
+  if (!trimmed.startsWith('{')) {
+    return response;
+  }
+
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return response;
+  }
+
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    return response;
+  }
+  if (parsed.success === false) {
+    throw new Error(parsed.errorMsg || parsed.message || 'Failed to fetch document Markdown');
+  }
+  if (typeof parsed.content === 'string') {
+    return parsed.content;
+  }
+  return response;
+}
+
+async function fetchDocumentMarkdown(docUrl, options = {}) {
+  const authRef = options.authRef || createAuthRef();
+  const client = options.client || createYidaClient({ authRef });
+  const response = await client.get(API_PATH, { docUrl: validateDocUrl(docUrl) }, {
+    responseType: 'text',
+    timeout: options.timeout || 300000,
+  });
+  return unwrapMarkdownResponse(response);
+}
+
+async function run(args) {
+  const parsed = parseArgs(args);
+  if (parsed.help) {
+    console.log('Usage: openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]');
+    return { help: true };
+  }
+  const docUrl = validateDocUrl(parsed.docUrl);
+  const content = await fetchDocumentMarkdown(docUrl);
+  if (parsed.output) {
+    const outputPath = path.resolve(parsed.output);
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, content, 'utf8');
+    const result = { success: true, docUrl, output: outputPath, length: content.length };
+    console.log(JSON.stringify(result, null, 2));
+    return result;
+  }
+  const result = { success: true, docUrl, content };
+  console.log(parsed.json ? JSON.stringify(result, null, 2) : content);
+  return result;
+}
+
+module.exports = {
+  API_PATH,
+  parseArgs,
+  validateDocUrl,
+  unwrapMarkdownResponse,
+  fetchDocumentMarkdown,
+  run,
+};

package/lib/document/tingji.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const { createAuthRef, createYidaClient } = require('../core/yida-client');
+const { throwUsage } = require('../core/command-errors');
+
+const API_PATH = '/query/document/tingji.json';
+
+function parseArgs(args) {
+  const parsed = { taskUuid: '', help: false };
+  for (const arg of args) {
+    if (arg === '--help' || arg === '-h') {
+      parsed.help = true;
+    } else if (arg === '--json') {
+      continue;
+    } else if (!arg.startsWith('--') && !parsed.taskUuid) {
+      parsed.taskUuid = arg;
+    } else {
+      throwUsage('Usage: openyida read-dingtalk-tingji <taskUuid> [--json]');
+    }
+  }
+  return parsed;
+}
+
+function validateTaskUuid(taskUuid) {
+  const normalized = String(taskUuid || '').trim();
+  if (!normalized) {
+    throwUsage('Usage: openyida read-dingtalk-tingji <taskUuid> [--json]');
+  }
+  if (normalized.length > 256 || /[\r\n]/.test(normalized)) {
+    throw new Error('taskUuid is invalid');
+  }
+  return normalized;
+}
+
+async function fetchTingjiDetail(taskUuid, options = {}) {
+  const authRef = options.authRef || createAuthRef();
+  const client = options.client || createYidaClient({ authRef });
+  const response = await client.get(API_PATH, { taskUuid: validateTaskUuid(taskUuid) }, {
+    timeout: options.timeout || 300000,
+  });
+  if (!response || response.success === false || response.__needLogin || response.__csrfExpired) {
+    const detail = response && (response.errorMsg || response.message);
+    throw new Error(detail || 'Failed to fetch Tingji detail');
+  }
+  return response.content !== undefined ? response.content : response;
+}
+
+async function run(args) {
+  const parsed = parseArgs(args);
+  if (parsed.help) {
+    console.log('Usage: openyida read-dingtalk-tingji <taskUuid> [--json]');
+    return { help: true };
+  }
+  const taskUuid = validateTaskUuid(parsed.taskUuid);
+  const detail = await fetchTingjiDetail(taskUuid);
+  const result = { success: true, taskUuid, detail };
+  console.log(JSON.stringify(result, null, 2));
+  return result;
+}
+
+module.exports = { API_PATH, parseArgs, validateTaskUuid, fetchTingjiDetail, run };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.7.26-beta.2",
+  "version": "2026.7.27-beta.1",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",

package/yida-skills/SKILL.md

@@ -99,7 +99,7 @@ OpenYida builder 默认使用 `create-app / create-form / create-page / generate
 - 已解析到目标自定义页面 URL / `formUuid` / bound page 时，默认写源码并发布到该页面，不执行 `yida-create-page`；只有缺少目标 display page 且本次意图允许新增页面时才创建。
 - 已解析到目标表单 `formUuid` 时，字段结构诉求默认走 `yida-create-form-page` 的 update/patch/rule/bind-datasource 模式，不创建同名或同类表单。
 - 已解析到目标流程表单 / `processCode` 时，默认走 `yida-process-rule` 配置/更新流程，不从零执行 `yida-create-process`。
-- 完整应用 `fast_build` 也遵守本规则：`resolve app → resolve forms → resolve main page → create missing resources only → update/publish`。
+- 完整应用 `fast_build` 也遵守本规则：先占位主页面，再建表单，最后回填发布。
 
 验收心智模型：
 
@@ -134,7 +134,7 @@ OpenYida builder 默认使用 `create-app / create-form / create-page / generate
 > 用户说“按默认方案 / 不要追问 / 直接创建 / 尽快搭建”时，`yida-app` 选择 `fast_build`：先解析并复用已有资源，只创建缺失且允许创建的应用/表单/页面，最后发布并输出链接。
 > `yida-app fast_build` 使用常规 OpenYida 命令编排。
 
-**默认链路**：`fast_build` 必须只做 `resolve app → resolve forms → resolve main page → create missing resources only → 编写/更新主页面源码 → 发布 → 返回访问链接`。不要因为应用名里有“看板 / 系统 / 管理”就升级到 `deep_design` 或 `full_demo`。
+**默认链路**：`fast_build` 必须只做 `resolve app → reserve main page → resolve forms → 编写/更新主页面源码 → 发布 → 返回访问链接`。若需要首页/工作台/智能助手/门户门面且主页面缺失，先创建空 display page 占位，再建表单，最后回填发布；不要因此默认执行导航重排。不要因为应用名里有“看板 / 系统 / 管理”就升级到 `deep_design` 或 `full_demo`。
 
 **fast_build 默认加载边界**：只加载 `yida-app` 和当前阶段必需的子技能。`yida-create-app`、`yida-create-page`、`yida-create-form-page` 只有在目标资源缺失且本次意图允许创建时才加载；已有资源时进入对应 update / publish 分支。页面默认走 Code Canvas；当用户明确要求普通自定义页面 JSX/Jsx 组件链路，或页面强依赖普通自定义页实例桥（`this.$(fieldId)` / `this.utils.yida.*` / `this.dataSourceMap` / 表单提交或字段双向绑定深度耦合）时，选择 `yida-custom-page`。不要默认加载 `yida-page-uiux`、`yida-data-source-connectors`、`yida-data-management`、`yida-nav-group`、`yida-dashboard`，也不要默认深读 `references/`。
 
@@ -167,13 +167,15 @@ OpenYida builder 默认使用 `create-app / create-form / create-page / generate
 | `yida-skills/integration` | 连接器、外部 API、执行动作、设计器数据源、集成自动化、逻辑流 | `yida-integration`、`yida-connector`、`yida-connector-safe-actions`、`yida-data-source-connectors` |
 | `yida-skills/access` | 平台/应用/表单/页面权限、公开访问、分享 | `yida-corp-manager`、`yida-app-permission`、`yida-form-permission`、`yida-page-config` |
 | `yida-skills/ops` | Sequence、主键冲突、VOC 反馈 | `yida-db-seq-fix`、`yida-voc` |
-| `yida-skills/agent` | 导出对话、会议纪要/闪记转 PRD | `yida-export-conversation`、`yida-flash-note-to-prd` |
+| `yida-skills/agent` | 导出对话、读取钉钉文档/听记、会议纪要/闪记转 PRD | `yida-export-conversation`、`yida-document-markdown`、`yida-tingji`、`yida-flash-note-to-prd` |
 
 ### 高频分歧
 
 | 用户意图 | 选哪个 |
 |------|------|
 | 从零搭一个完整应用/系统 | `yida-app`；默认 `fast_build`，不要自动升级到深度设计 |
+| 读取钉钉在线文档正文 | `yida-document-markdown`，使用登录态接口获取 Markdown |
+| 按 taskUuid 读取钉钉听记 | `yida-tingji`，将听记任务 ID 原样传入命令 |
 | 只创建应用壳并拿 appType | `yida-create-app` |
 | 创建自定义展示页资源 | `yida-create-page`，之后默认接 `yida-canvas-custom-page` 和 `yida-publish-page` |
 | 开发表单字段结构 / 增删改字段 | `yida-create-form-page` |

package/yida-skills/skills/yida-app/SKILL.md

@@ -13,7 +13,7 @@ description: 宜搭完整应用开发编排技能。对普通 OpenYida 应用做
 
 用户说“按默认方案”“不要追问”“直接创建”“尽快搭建”等，必须选择 `fast_build`，用合理 MVP 假设直接执行，不展开深度 PRD 讨论。
 
-**默认判定**：完整应用搭建或补齐时，只要用户表达“默认方案 / 不要追问 / 直接创建 / 尽快搭建”等快速交付信号，就必须命中 `fast_build`。默认完成链路固定为 `resolve app → resolve forms → resolve main page → create missing resources only → 编写/更新主页面源码 → 发布 → 返回访问链接`。
+**默认判定**：完整应用搭建或补齐时，用户表达“默认方案 / 不要追问 / 直接创建 / 尽快搭建”等快速交付信号，就命中 `fast_build`。默认链路：`resolve app → reserve main page → resolve forms → 编写/更新主页面源码 → 发布 → 返回访问链接`。
 
 > 资源边界：本技能是默认完整应用编排。目标不明时先只读确认或询问用户。
 
@@ -170,8 +170,8 @@ UI 不是独立替代主流程的步骤，而是按模式插入到页面生成
 | 0. 解析资源上下文 | 无 | 合并本轮显式资源、agent bound context、workspace config/cache、会话历史；本轮显式目标覆盖 bound context；判定 app/page/form/process 的 `source` 和 `allowCreate` | 明确复用、创建缺口或需要 ask_human |
 | 1. resolve app | `yida-create-app` 仅在 app 缺失且允许创建时加载；不自动修改应用名称 | 已有 `appType`/应用 URL/bound app 时直接复用；否则创建应用并提取真实 `appType` | 拿到真实目标 `appType`，且不会重复创建同类 app |
 | 2. 记录最小需求 | 无 | 写 `prd/<项目名>.md`：只记录 MVP 假设、核心表单/页面、完成标准；写/更新 `.cache/<项目名>-schema.json` 本地 ID 映射；不要写长 PRD | 业务语义和 ID 存储位置明确 |
-| 3. resolve forms | `yida-create-form-page` | 已有目标表单时 update/patch/rule/bind-datasource；简单字段属性更新直接用 compact changes 让 CLI 内部按 label 读 schema/定位字段并输出 resolved evidence；缺少支撑 MVP 的核心表单且允许创建时才 create；字段配置文件写入 `.cache/openyida/<项目名>/`；页面/数据/流程/公式确需多字段映射时，对每个目标表单最多一次性获取完整 `--field-map-json` 并合并写回 `.cache/<项目名>-schema.json` | 拿到或确认表单 `formUuid`，并在需要时拿到真实 `fieldId` |
-| 4. resolve main page | `yida-create-page` 仅在主页面缺失且允许创建时加载 | 已有页面 URL / `formUuid` / bound page 时直接作为主页面；否则创建一个用户主入口 display page | 拿到真实目标页面 `formUuid`，且不会重复创建页面 |
+| 3. reserve main page | `yida-create-page` 仅在主页面缺失且允许创建时加载 | 已有页面 URL / `formUuid` / bound page 时直接作为主页面；若需要首页/工作台/智能助手/门户门面且缺少主页面，先创建空 display page 占位，暂不写最终源码 | 拿到真实主页面 `formUuid`，且不会重复创建页面 |
+| 4. resolve forms | `yida-create-form-page` | 已有目标表单时 update/patch/rule/bind-datasource；简单字段属性更新直接用 compact changes 让 CLI 内部按 label 读 schema/定位字段并输出 resolved evidence；缺少支撑 MVP 的核心表单且允许创建时才 create；字段配置文件写入 `.cache/openyida/<项目名>/`；页面/数据/流程/公式确需多字段映射时，对每个目标表单最多一次性获取完整 `--field-map-json` 并合并写回 `.cache/<项目名>-schema.json` | 拿到或确认表单 `formUuid`，并在需要时拿到真实 `fieldId` |
 | 5. 编写/更新页面 | 默认 `yida-canvas-custom-page`；明确要求 JSX/Jsx 组件链路或实例桥强依赖时选择 `yida-custom-page` | 生成或修改主页面源码；只实现 MVP 首屏和核心操作。可用已解析表单链接、真实空态、表单入口和轻量指标口径完成主页面；若展示业务列表/看板/详情记录，必须接本轮真实表单 `dataBinding.mode=form`，或先写入 demo records 后再读取；不要加载视觉/密度/报表/数据源等额外技能 | 本地源码通过对应页面技能的基础校验；未执行 publish 时仍是“源码已修改，尚未发布” |
 | 6. 发布页面 | `yida-publish-page` | 按页面链路校验后发布到已解析主页面：Canvas `.canvas.jsx` 使用 `openyida publish` 的 Canvas 编译阶段或 `compileCanvasLocal` 快检；普通自定义页面 `.oyd.jsx` / `.jsx` 跑 `check-page` / `compile`；再执行 `openyida publish <source> <appType> <displayPageFormUuid>` 发布主页面 | 发布成功并获得可访问 URL |
 | 7. 输出结果 | 无 | 返回应用链接、主页面链接、复用/创建/更新的资源摘要、后续可选项 | 用户拿到 URL |

package/yida-skills/skills/yida-create-page/SKILL.md

@@ -25,6 +25,7 @@ description: 创建自定义展示页面（display 类型）并返回 formUuid
 
 - **创建前必须确认**：单点创建页面时，执行创建命令前必须向用户确认页面名称和目标应用。由 `yida-app fast_build` 编排且用户已说“默认方案 / 不要追问 / 直接创建”时，合理命名并直接创建，不再二次追问。
 - 创建成功后，将 formUuid 记录到 `.cache/<项目名>-schema.json`
+- 由 `yida-app fast_build` 编排的首页/工作台/智能助手/门户门面页，可以先于业务表单创建；先占位记录 `formUuid`，待表单 ID 明确后再写源码并发布。
 - 创建页面后，必须继续选择一个页面实现链路编写页面源码，再用 `yida-publish-page` 发布：Code Canvas 链路用 `yida-canvas-custom-page`；普通自定义页面 JSX/Jsx 组件链路用 `yida-custom-page`
 - 用户明确要求 JSX / Jsx 组件 / 普通自定义页，或页面强依赖 `this.$`、`this.utils.yida.*`、`this.dataSourceMap` 时，创建后进入 `yida-custom-page`；涉及成员、部门、附件上传或图片上传时必须读取 `component-jsx-guide.md`，上传还必须读取 `attachment-upload-guide.md`
 - **本技能不读写 memory**：formUuid 等信息输出到 stdout，通过 `.cache/<项目名>-schema.json` 持久化，不依赖跨会话的 memory 状态

package/yida-skills/skills/yida-document-markdown/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: yida-document-markdown
+description: 获取钉钉文档、钉钉在线文档或知识库文档的完整 Markdown 内容。用户提供文档链接并要求读取、提取、总结或继续处理文档内容时使用。
+---
+
+# 获取钉钉文档 Markdown
+
+## 严格要求 (MUST DO)
+
+- 使用 `openyida read-dingtalk-doc "<docUrl>"` 读取文档内容
+- 将用户提供的钉钉文档 URL 原样传给 `docUrl` 参数
+- 仅基于命令返回的 Markdown 执行总结、转 PRD 或其他下游任务
+
+## 命令
+
+```bash
+openyida read-dingtalk-doc "<docUrl>"
+openyida read-dingtalk-doc "<docUrl>" --json
+openyida read-dingtalk-doc "<docUrl>" --output ./document.md
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `docUrl` | 是 | 可访问的钉钉文档 HTTP(S) 链接 |
+| `--json` | 否 | 输出包含原始链接和 Markdown 的 JSON |
+| `--output`, `-o` | 否 | 将 Markdown 写入指定文件；若文件已存在则覆盖 |
+
+## 执行流程
+
+1. 确认用户已提供文档链接。
+2. 默认运行 `openyida read-dingtalk-doc "<docUrl>"` 获取纯 Markdown；需要结构化结果时使用 `--json`。
+3. 仅在用户要求保存文件或后续任务需要文件输入时使用 `--output`，并明确告知写入路径。
+4. 检查命令成功结果，再按用户要求处理 Markdown。
+
+## 异常处理
+
+| 场景 | 处理方式 |
+|------|----------|
+| 未登录或登录失效 | 运行 `openyida auth status`，必要时执行 `openyida login` |
+| 400 | 检查 `docUrl` 是否为空或格式错误 |
+| 文档无权限或不存在 | 请用户确认当前钉钉账号权限与链接有效性 |
+| 请求超时 | 稍后重试；文档转换最长可能等待 300 秒 |
+
+## 完成标准
+
+命令成功返回非推测的 Markdown 内容，或成功写入用户指定文件。

package/yida-skills/skills/yida-tingji/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: yida-tingji
+description: 按 taskUuid 获取钉钉听记、会议录音转写、会议纪要或 AI 听记的完整详情。用户提供听记任务 ID 并要求读取、整理、总结或转 PRD 时使用。
+---
+
+# 获取钉钉听记详情
+
+## 严格要求 (MUST DO)
+
+- 使用 `openyida read-dingtalk-tingji "<taskUuid>"` 读取听记详情
+- 将用户提供的 `taskUuid` 原样传入，不自行转换或校验其格式
+- 读取成功后，根据用户要求提取会议摘要、关键决策、行动项或生成 PRD
+- 默认不要在回复中展示带签名参数的资源 URL；用户明确要求原始结果时再输出完整 JSON
+
+## 命令
+
+```bash
+openyida read-dingtalk-tingji "<taskUuid>"
+openyida read-dingtalk-tingji "<taskUuid>" --json
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `taskUuid` | 是 | 钉钉听记任务 ID，按原值传入 |
+| `--json` | 否 | 显式声明 JSON 输出；当前命令默认即为 JSON |
+
+## 执行流程
+
+1. 从用户输入或听记链接上下文中取得准确的 `taskUuid`；无法确定时请用户补充。
+2. 运行 `openyida read-dingtalk-tingji "<taskUuid>" --json`。
+3. 检查成功结果，再按用户要求提取会议摘要、发言内容、决策或待办。
+
+## 异常处理
+
+| 场景 | 处理方式 |
+|------|----------|
+| 未登录或登录失效 | 运行 `openyida auth status`，必要时执行 `openyida login` |
+| 400 | 检查 `taskUuid` 是否为空 |
+| 听记无权限或不存在 | 请用户确认当前钉钉账号权限和 `taskUuid` |
+| 请求超时 | 稍后重试；接口最长可能等待 300 秒 |
+
+## 完成标准
+
+命令成功返回指定 `taskUuid` 对应的真实听记详情。

package/yida-skills/skills-index.json

@@ -89,6 +89,30 @@
         "基础信息"
       ]
     },
+    {
+      "name": "yida-document-markdown",
+      "path": "skills/yida-document-markdown/SKILL.md",
+      "display_name": "钉钉文档 Markdown",
+      "description": "获取钉钉文档、钉钉在线文档或知识库文档的完整 Markdown 内容。用户提供文档链接并要求读取、提取、总结或继续处理文档内容时使用。",
+      "category": "yida-skills/agent",
+      "tags": ["钉钉文档", "Markdown", "文档链接", "内容提取"],
+      "aliases": ["读取钉钉文档", "文档转 Markdown"],
+      "command_ids": ["read-dingtalk-doc"],
+      "done_when": "命令成功返回真实 Markdown 内容，或成功写入指定文件。",
+      "requires_login": true
+    },
+    {
+      "name": "yida-tingji",
+      "path": "skills/yida-tingji/SKILL.md",
+      "display_name": "钉钉听记详情",
+      "description": "按 taskUuid 获取钉钉听记、会议录音转写、会议纪要或 AI 听记的完整详情。用户提供听记任务 ID 并要求读取、整理、总结或转 PRD 时使用。",
+      "category": "yida-skills/agent",
+      "tags": ["钉钉听记", "会议纪要", "taskUuid", "语音转写"],
+      "aliases": ["读取听记", "获取会议记录"],
+      "command_ids": ["read-dingtalk-tingji"],
+      "done_when": "命令成功返回指定 taskUuid 对应的真实听记详情。",
+      "requires_login": true
+    },
     {
       "name": "yida-business-rule",
       "path": "skills/yida-business-rule/SKILL.md",
@@ -1159,6 +1183,11 @@
       "description": "非宜搭业务资源本身的 agent 辅助能力：导出对话、会议/闪记转 PRD。",
       "signals": [
         "导出对话",
+        "钉钉文档",
+        "读取文档",
+        "Markdown 内容",
+        "钉钉听记",
+        "taskUuid",
         "会议纪要",
         "闪记",
         "PRD"