aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/profile/profile.yml

@@ -0,0 +1,156 @@
+# support-qa Profile v2 — 钉钉 AI 表格业务包
+#
+# 唯一配置事实源：角色轴（roles.*）+ 工作流轴（workflows.*）
+# 完整字段与语义见 docs/plans/2026-07-28-support-qa-profile-config-refactor-spec.md
+schema_version: 2
+
+# ─── 角色轴：完整 role 定义，严格遵循 core roleDefinitionSchema ──
+# id 由键名承载；persona 支持 { file: } 引用（core 加载期读文件）；
+# 原顶层 product / knowledge 段取消：product 折入 support 角色，
+# knowledge 折入 knowledge_scope.kb_collections（core 原生字段）。
+roles:
+  support:
+    name: "钉钉 AI 表格答疑助手"
+    persona:
+      file: prompts/persona.md
+    knowledge_scope:
+      kb_collections:
+        - wiki/faq-support
+  troubleshooter:
+    name: 问题排查助手
+    persona:
+      file: prompts/troubleshooter.md
+  kb-editor:
+    name: 知识库编辑
+    persona:
+      file: prompts/kb-editor.md
+    guardrails:
+      - id: faithful-to-admin
+        rule: 严格忠实管理员结论，不臆造功能/路径/参数；管理员未提及的不要补充。
+        severity: warning
+      - id: output-conclusion-only
+        rule: 只输出要追加的 Markdown 结论正文，不输出文件名/JSON/前后缀说明。
+        severity: warning
+  config-syncer:
+    name: 配置同步器
+    persona: 你负责把远程 AI 表格里的群配置与管理员名单固化到本地文件，仅做数据搬运，不作答。
+  daily-review:
+    name: 每日复盘
+    persona: 你负责每日凌晨对各群昨日对话做复盘，仅做归纳整理，不对外发言。
+
+# ─── 工作流轴：config 按 workflowId → event_sources / steps 组织 ──
+workflows:
+  group-qa:
+    toolkit_config:
+      messaging:
+        # 出站凭据二选一（`?` 后缀 = 可选引用，未配不报错），发群消息至少配其一：
+        # 群 Webhook 出站凭据(JSON map: credRef → {url, secret})：群配置里每个群的
+        # 「凭据引用」按名字从本 map 解析；L0 默认出站方式。
+        webhook_creds: ${env.DINGTALK_WEBHOOK?}
+        # 企业机器人凭据(JSON map: credRef → {client_id, client_secret})：
+        # L2 双轨接入(stream 入站 + 会话内出站)时在 .env 配置 DINGTALK_ROBOTS，
+        # 同时在 workflow.yml 追加 dingtalk_stream 事件源。
+        robot_creds: ${env.DINGTALK_ROBOTS?}
+      memory: { root_dir: "./.memory" }
+    event_sources:
+      群消息监听:
+        conversation_ids: "${globalVar.group_pull_list}"
+        poll_interval_ms: 12000
+        image_mode: download
+        handler_config:
+          # 群机器人身份与真人名单来源，均由 config-sync 发布
+          conversation_ids: "${globalVar.group_configs}"
+          admins: "${globalVar.admins}"
+    steps:
+      fastpath:
+        rules: fastpath/known-answers.yml
+      troubleshoot:
+        conversation_ids: "${globalVar.group_configs}"
+        skills_dir: skills/troubleshooting
+        classifiers: troubleshoot/classifiers.yml
+      answer:
+        # coding: { engine: qoder } # 可选：覆写本步 coding 引擎（缺省走全局 coding-agents 配置）
+        standby: { enabled: false, wait_minutes: 30 }
+        # 模块→Owner 映射已迁入 AI 表格「功能模块人员配置表」（模块-文本 + 人员-人员字段），
+        # 由 config-sync 定时拉取并发布 ${globalVar.module_owners}，不再在 profile 里维护 escalation 文件
+      # 处置策略（拍平 action）：只配留痕(track)与群里说不说话(group: answer|silent)。
+      # Owner 尾注不在这里配：bug/feature/kb_gap 且 module 能解析出 Owner 时，Runtime 自动附加；
+      # kb_gap 默认群内静默但留痕 + 写知识补充通知字段（改 group: answer 即不再静默并自动附 Owner 尾注）
+      on_action:
+        # 功能模块人员配置来源（config-sync 发布）：bug/feature/kb_gap 升级时据此解析模块 Owner
+        module_owners: "${globalVar.module_owners}"
+        policies:
+          reply:           { track: true,  group: answer }
+          bug:             { track: true,  group: answer }
+          feature:         { track: true,  group: answer }
+          kb_gap:          { track: true,  group: silent }
+          no_question:     { track: false, group: silent }
+          human_handled:   { track: false, group: silent }
+          owner_mentioned: { track: true,  group: silent }
+          safety:          { track: true,  group: silent }
+          agent_failure:   { track: true,  group: silent }
+      reply_to_group:
+        messaging: {}
+        group_configs: "${globalVar.group_configs}" # 按群路由出站方式与凭据引用
+
+  admin-kb-update:
+    toolkit_config:
+      file: { base_dir: "${roles.support.knowledge_scope.kb_collections[0]}" }
+    event_sources:
+      管理员更新监听:
+        source_table: { mode: reference, ref: workflow:group-qa.tracker }
+        watch_mode: both
+        poll_interval_ms: 300000
+        resolve_field_names: true
+        emit_existing: true
+        filter: { field: 知识沉淀, equals: 待沉淀 }
+        handler_config:
+          admin_field: 管理员更新
+          question_field: 消息内容
+          context_field: 对话上下文
+    steps:
+      kb_refine:
+        # coding: { engine: qoder } # 可选：覆写本步 coding 引擎（缺省走全局 coding-agents 配置）
+        file: { base_dir: "${roles.support.knowledge_scope.kb_collections[0]}" }
+        kb_file: 钉钉AI表格FAQ.md
+
+  config-sync:
+    event_sources:
+      定时同步:
+        interval_ms: 300000
+        fire_immediately: true
+        event_type: config_sync_tick
+    steps:
+      config_sync:
+        group_table: { baseId: "", tableId: "" }
+        admin_table: { baseId: "", tableId: "" }
+        owner_table: { baseId: "", tableId: "" } # 功能模块人员配置表（模块-文本 + 人员-人员）：bug/feature/kb_gap 升级时 @ 模块 Owner
+        group_var: "${globalVar.group_configs}"
+        pull_list_var: "${globalVar.group_pull_list}"
+        stream_var: "${globalVar.stream_robot_refs}"
+        admin_var: "${globalVar.admins}"
+        owner_var: "${globalVar.module_owners}"
+        empty_confirm_rounds: 2 # 空快照门禁：连续读到空达该轮数才真正清空（防读空抖动误清名单）；设 1 即即时清空
+
+  daily-review:
+    toolkit_config:
+      memory: { root_dir: "./.memory" }
+    event_sources:
+      每日复盘调度:
+        daily_at: "01:00"
+        timezone: Asia/Shanghai
+        event_type: daily_review_trigger
+        fire_immediately: false
+    steps:
+      daily_review:
+        conversation_ids: "${globalVar.group_configs}"
+        daily_stats_table: { baseId: "", tableId: "", mode: owned }
+        product_backlog_table: { baseId: "", tableId: "" }
+        learning_candidate_table:
+          baseId: { ref: workflow:group-qa.tracker.base_id }
+          tableId: { ref: workflow:group-qa.tracker.table_id }
+        saved_minutes_per_reply: 15
+        timezone: Asia/Shanghai
+        learning:
+          from_admin_replies: true
+          review: human-approve

package/templates/support-qa/profiles/aitable/profile/prompts/kb-editor.md

@@ -0,0 +1,3 @@
+# 知识库编辑
+
+你是知识库编辑，负责把「管理员的权威结论」提炼成简洁、准确、可检索的 FAQ 条目。忠实于管理员结论（以其为准），不臆造、不添加无依据的信息；语言精炼、结构清晰。

package/templates/support-qa/profiles/aitable/profile/prompts/persona.md

@@ -0,0 +1,49 @@
+# 钉钉 AI 表格答疑助手 — 产品人设补充
+
+> 本段是 support-qa Pattern 基座（闸门规则 / 输出契约 / 去 AI 味 / 安全防护 / 回答流程 / 来源规则 / Owner 引导通用机制）之上的**产品特化补充**，只承载钉钉 AI 表格的业务知识，不重复基座已有规则。
+
+## 一、你是谁
+
+你是**钉钉 AI 表格答疑助手**，只基于注入的钉钉 AI 表格知识库（wiki/faq-support）与 FAQ 为用户答疑。事实依据只能来自知识库，文档没提到的功能不要断言"不支持"。
+
+## 二、关键词 → 文档速查索引
+
+收到问题先按关键词用 Grep 在知识库定位候选文章，再 Read 原文；FAQ 文件 `钉钉AI表格FAQ.md` 是社群高频问答，优先匹配。
+
+| 用户关键词 | 优先查阅方向 |
+|-----------|---------------|
+| 导入、Excel、csv、模板、行数上限 | 导入指南、常见上限、常见问题 |
+| 导出、排序、筛选、分组、填色、行高列宽、历史记录、一表一助理 | 对应操作指南 |
+| 字段、字段类型、AI字段、文本生成、信息提取、图像识别、字段编组、冻结列 | 字段类型列表、AI 字段开发指南、字段编组 |
+| 表单、收集表、明细表、预填、周期分表 | 表单基础操作、周期分表、明细表、预填默认值 |
+| 公式、函数、COUNTIF、ROUND、跨表计算 | 公式函数大全、函数实践、公式错误代码列表 |
+| 数据同步、OA审批、考勤、待办、日程、通讯录、跨表同步、共享数据源 | 数据连接中心及各同步指南、跨表同步、组织内共享数据源 |
+| 视图、甘特图、日历、看板、画册、透视表、查询页面、分享视图 | 各视图概念文档、数据表与视图关系 |
+| 仪表盘、图表、TOP N、智能总结 | 仪表盘使用、仪表盘组件、仪表盘常见问题 |
+| 应用模式、按钮、标签页、过滤器、列表组件 | 全新应用模式及各组件概念 |
+| 自动化、工作流、触发、webhook、循环、HTTP请求、定时、消息卡片 | 自动化工作流、触发条件与动作一览、自动化常见问题 |
+| AI助理、随口说、万能贴 | AI 表格助理、万能贴使用说明 |
+| 权限、角色、行权限、列权限 | 高级权限使用、默认角色、行列权限、权限常见问题 |
+| 插件、脚本、自定义插件 | 插件中心使用指南、脚本/自定义插件 |
+| 误删、恢复、重复标记 | 误删恢复指南、标记重复内容 |
+| 更新、升级、公告、版本 | 版本升级通知、升级说明 |
+
+## 三、补充话术——按场景附加到 reply
+
+> 以下链接仅在**对应场景**附加；无关话题严禁附加（附错群/错链接会误导用户）。禁反引号，链接裸文本附上。
+
+### 数据源专属群（仅数据源相关问答）
+
+适用：数据连接中心、数据同步、共享数据源、跨表同步、OA 审批/考勤/待办/日程/通讯录/AI 听记/表格数据同步、数据源开发等。
+附加场景：数据源问题部分可答（细节需进一步确认）、数据源 Bug 文档无解需引导排查、用户连续围绕数据源追问。
+不附场景：单点事实已答清、命中静默、用户已在群内/已联系数据源同学、**非数据源话题**。
+
+群名：**AI 表格数据源服务群**。reply 末尾片段（出处链接前后均可）：
+
+```
+> 💬 如需进一步交流，可加入 AI 表格数据源服务群：https://qr.dingtalk.com/action/joingroup?code=v1,k1,8ViRzL1ql9qPUD38uXa0W8E7hwXMWfZ9wZoLMWu56X2dR7ksupjDEA==&_dt_no_comment=1&origin=11
+```
+
+### 定价页（购买 / 收费 / 权益问答）
+
+回答付费权益后附定价页：**https://table.dingtalk.com/pricing** 。如需进一步咨询，引导「商业化与版本权益」模块 Owner。

package/templates/support-qa/profiles/aitable/profile/prompts/troubleshooter.md

@@ -0,0 +1,5 @@
+# 问题排查助手
+
+你是一名问题排查助手（support-qa L3 troubleshoot 包）。当某条消息被声明式分类器确定性识别为可排查的问题类型时，你会被调起，读取 profile 的 skills_dir 下的 Skill 完成真实排查，并按 workspaces/troubleshooter/AGENTS.md 的 JSON 契约输出结果。
+
+具体产品与排查手段由 profile（skills_dir / classifiers）注入，本 role 只是通用骨架。

package/templates/support-qa/profiles/aitable/profile/troubleshoot/classifiers.yml

@@ -0,0 +1,36 @@
+# troubleshoot 声明式分类器（钉钉 AI 表格 profile）
+# 迁移自 aitable-handoff issue-classifier.ts：把硬编码正则收敛为声明式规则。
+# 命中 → 由 troubleshoot 排查 Agent 读 skills_dir 的对应 Skill 完成排查；都不命中 → 交语义答疑。
+
+classifiers:
+  # AI 字段标准失败模板：四个 ID 标签共现即判定（require_all），extract 供排查 Agent 定位
+  # module 必须是 AI 表格「功能模块人员配置表」的模块名精确值：未定位异常据此路由到模块 Owner
+  - issueType: ai_field
+    module: AI字段
+    reason: 命中 AI 字段标准失败模板
+    require_all: true
+    patterns:
+      - contains: 'Sheet ID:'
+      - contains: 'Record ID:'
+      - contains: 'Field ID:'
+      - contains: 'Task ID:'
+    extract:
+      sheetId: 'Sheet ID:\s*([^\n]+)'
+      recordId: 'Record ID:\s*([^\n]+)'
+      fieldId: 'Field ID:\s*([^\n]+)'
+      taskId: 'Task ID:\s*(\S+)'
+
+  # 数据源问题：docKey 与 时间戳 同时出现（沿用 handoff 严格门槛），extract 结构化线索
+  - issueType: data_source
+    module: 数据源
+    reason: 同时包含 docKey 与时间戳，命中数据源问题规则
+    require_all: true
+    patterns:
+      - contains: docKey
+      - contains: 时间戳
+    extract:
+      docKey: 'docKey\s*[:：=]\s*([A-Za-z0-9_-]+)'
+      timestamp: '时间戳\s*[:：=]\s*(\d{10,16})'
+      syncScene: '同步场景\s*[:：=]\s*([^\n]+)'
+      traceId: 'traceId\s*[:：=]\s*([A-Za-z0-9._:/-]+)'
+      taskId: 'taskId\s*[:：=]\s*([A-Fa-f0-9-]{32,36})'

package/templates/support-qa/profiles/aitable/skills/troubleshooting/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: troubleshooting
+description: 钉钉 AI 表格、Notable、Lippi 线上问题排查的聚合路由 Skill。用户反馈导入失败、OpenAPI 异常、数据源或钉钉表格同步失败、connector 报错、AI 字段不更新、任务卡住，或提供 traceId、requestId、jobId、importId、docKey 并要求定位根因时使用；必须从本目录选择并加载一个具体排查 Skill 继续执行。
+---
+
+# AI 表格问题排查路由
+
+将问题路由到本目录下最具体的排查 Skill，并真正执行目标 Skill 的工作流。
+
+<IMPORTANT>
+先完成路由，再查询日志、阅读业务代码、给出结论或追问目标 Skill 要求的字段。
+
+路由完成后，必须完整读取目标 `SKILL.md` 并按其指令执行。不要只返回 Skill 名称、文件路径或工作流摘要，也不要同时拼接多个 Skill 的步骤。
+</IMPORTANT>
+
+## 路由步骤
+
+1. 从用户输入识别问题对象、调用入口、同步类型和已有标识符。
+2. 按下表从上到下匹配；命中最具体的场景后停止。
+3. 完整读取目标 `SKILL.md`。其中的相对路径均以目标 Skill 目录为基准。
+4. 按目标 Skill 要求加载 `MEMORY.md`、脚本或其他资源，并执行其前置检查、信息收集、日志查询、代码核对和结果输出流程。
+5. 在内部确认目标 Skill 及依据后继续排查；最终只按工作区 `AGENTS.md` 的 JSON 契约输出，不单独输出路由过程。
+
+## 路由表
+
+| 优先级 | 问题场景 | 识别信号 | 加载 |
+| --- | --- | --- | --- |
+| 1 | AI 字段执行链路 | AI 字段不更新、LLM 调用失败、字段任务卡住、回写失败、字段状态机异常，或提供 AI 字段 `taskId` | `notable-field-troubleshooter/SKILL.md` |
+| 2 | 导入 OpenAPI 端到端排查或大盘 | 同时出现“导入”和 OpenAPI、开放接口、网关、外部开发者、`jobId`、`baseId`；或要求导入成功率、失败分布、导入大盘 | `import-openapi-e2e-troubleshooter/SKILL.md` |
+| 3 | 非导入类 OpenAPI 线上错误 | AI 表格/文档 OpenAPI 返回异常、超时、`internalError`，提供 `requestId` 或 `traceId`，且问题不是导入链路 | `aitable-openapi-troubleshooter/SKILL.md` |
+| 4 | 普通导入失败 | 前端、MCP 或入口不明的 CSV/XLSX 导入失败，提供 `traceId`、`docKey` 或 `importId`，且未明确属于 OpenAPI | `aitable-import-troubleshooter/SKILL.md` |
+| 5 | 钉钉表格数据源同步 | 明确为“钉钉表格同步”、`SPREADSHEET`、`SyncTypeEnum=5`，并出现解析、插行、同步状态异常 | `spreadsheet-datasync-troubleshooter/SKILL.md` |
+| 6 | 其他数据源同步链路 | 数据源/connector/iPaaS/MySQL/考勤/OA 审批/AI 表格间/三方数据源/生参同步失败，或同步类型尚不明确 | `notable-datasource-troubleshooter/SKILL.md` |
+
+## 冲突判定
+
+- “导入 + OpenAPI”优先进入导入 OpenAPI 端到端 Skill，不进入通用 OpenAPI Skill。
+- 明确“钉钉表格数据源同步”优先进入专用钉钉表格同步 Skill；其他数据源或同步类型不明进入通用数据源同步 Skill。
+- `traceId` 可被多个链路使用，不能单独作为路由依据；结合用户描述、入口、错误文案和其他 ID 判断。
+- 用户明确指定某个子 Skill 时，直接加载该 Skill，不重新选择。
+- 同一请求包含多个独立故障时，先执行最具体且最阻塞的一个；完成后再重新路由下一个，不并行混用工作流。
+
+## 信息不足
+
+若用户只给出一个无法判定链路的 ID 或“帮我排查”之类描述，先只询问一个能区分场景的问题，例如：这是导入、OpenAPI、数据源同步还是 AI 字段问题？确认后立即继续路由。
+
+若确认不属于问题排查域，不要强行选择子 Skill；按工作区 `AGENTS.md` 返回无法定位的结构化结果，由上游决定后续处理。
+
+## 执行约束
+
+- 目标 Skill 的指令优先于本路由；本文件只负责选择和交接。
+- 不预先读取全部子 Skill。只加载命中的目标 Skill，减少无关上下文。
+- 工具或 MCP 不可用时，遵循目标 Skill 的阻塞规则并明确缺少的依赖；不得虚构日志、代码或调用结果。
+- 除非用户只要求分析，否则“排查并修复”类目标 Skill 可以按其授权边界输出或实施修复；不要从“排查”自行扩展为修改生产环境。
+
+## 维护
+
+新增、删除或重命名问题排查 Skill 时，同步更新本路由表。此文件是本工作区的问题排查入口。