aitable-workflow-cli 0.1.23 → 0.1.24

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

@@ -1,219 +0,0 @@
-# support-qa Profile v2 — 钉钉 AI 表格业务包
-#
-# 唯一配置事实源：角色轴（roles.*）+ 工作流轴（workflows.*）
-# 完整字段与语义见 docs/plans/2026-07-28-support-qa-profile-config-refactor-spec.md
-schema_version: 2
-
-# 共享知识映射：scaffold / bundle 时按此声明从 _shared/<source>/ 复制到模板目标位置。
-shared_knowledge:
-  wiki/faq-support: aitable-faq
-
-# ─── 角色轴：完整 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: 你负责每日凌晨对各群昨日对话做复盘，仅做归纳整理，不对外发言。
-  # thread 级分析师（旁路试点）。具体分类与结论口径在 workspaces/thread-observer/AGENTS.md，
-  # 该文件是可定制的业务口径：换场景只改它，不改代码。
-  thread-observer:
-    name: 会话线程分析师
-    persona: 你只分析已收敛的会话线程并产出结构化结论，不对外发言。
-
-# ─── 工作流轴：config 按 workflowId → event_sources / steps 组织 ──
-workflows:
-  group-qa:
-    toolkit_config:
-      messaging:
-        # 凭据全部来自群配置表四列(webhookUrl/webhookSecret/appKey/appSecret)，
-        # config-sync 定时拉取后发布到 globalVar，本地不配 .env；加群只改表。
-        # 首轮 config-sync 完成前为空——webhook 出站会报 configError 阻塞待配置，属预期。
-        # 群 Webhook 出站凭据(map: groupId → {url, secret})。
-        webhook_creds: "${globalVar.webhook_creds}"
-        # 企业机器人凭据(map: appKey → {client_id, client_secret})：
-        # stream 入站建连与会话内(session)出站共读；启用 stream 时在 workflow.yml 追加
-        # dingtalk_stream 事件源(robot_refs/robot_creds 同引 globalVar)。
-        robot_creds: "${globalVar.robot_creds}"
-      memory: { root_dir: "./.memory" }
-    event_sources:
-      群消息监听:
-        # dingtalk_event 长连接无轮询，不配 poll_interval_ms。
-        # all-group：单进程监听全部群，conversation_ids 退化为本地白名单（空名单=全丢弃）；
-        # 内存与群数解耦，名单热更不动进程。退回每群一进程把 kind 改成 group。
-        kind: all-group
-        conversation_ids: "${globalVar.group_pull_list}"
-        image_mode: download
-        handler_config:
-          # 群机器人身份与真人名单来源，均由 config-sync 发布
-          conversation_ids: "${globalVar.group_configs}"
-          admins: "${globalVar.admins}"
-          aggregate_window_ms: 5000
-    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}"
-        # Webhook 群必须配置 corpId 才允许真实 @；缺失时 Owner 尾注降级为花名
-        group_configs: "${globalVar.group_configs}"
-        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}" # 按群路由出站方式与 credRef（config-sync 由表内凭据列合成）
-
-  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}"
-        webhook_creds_var: "${globalVar.webhook_creds}" # 群配置表 webhookUrl/webhookSecret 列派生
-        robot_creds_var: "${globalVar.robot_creds}" # 群配置表 appKey/appSecret 列派生
-        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
-
-  # ─── thread-observer：旁路试点，默认不启用 ────────────────────────────
-  # 它与 group-qa 并行监听同一个试点群，但**不回复、不调主链、不写 group-qa 的表**，
-  # 只往自己的观察表写「一条 thread 一行」。目的是用真实群验证 messageId/threadId 归属、
-  # thread 级 SLA、以及抽取四列是否可用。
-  #
-  # 开启方式：把下面 conversation_ids 改成真实的试点群 cid（**建议先只开一个群**）。
-  # 留空数组 = 不监听任何群，等于本工作流空转。
-  #
-  # 成本：R0 刻意**不做事件源 fan-out**，两个工作流各自 poll，同群会多一次 DWS 拉取。
-  # 单群试点可接受；若未来多群长期并行，再设计 core 事件分发器（P1）。
-  thread-observer:
-    event_sources:
-      群消息监听:
-        conversation_ids: [] # ← 填试点群 cid 即启用，如 ["cidXXXX=="]
-        poll_interval_ms: 12000
-        # 试点默认关图片：group-qa 已在同群下载过一遍，重复下载只增成本。
-        # 确需验证「图片 thread」时再改 download。
-        image_mode: off
-        handler_config:
-          bots: "${globalVar.group_configs}" # 取其 botNick；缺失会让机器人消息被当成用户提问
-          answerers: "${globalVar.admins}" # 缺失时 SLA 标不适用，**不猜** answerer
-          group_configs: "${globalVar.group_configs}" # 仅用于反查群名（dingtalk_message 源不返回群名）
-          thread_log_dir: "./.threads" # 不配则完全不碰文件系统（配置即授权）；必须与 .memory 分开
-          thread_log_retain_days: 2
-          thread_idle_close_min: 30 # 静默多久算收敛；试点想更快看结果可调小
-          thread_max_open_hour: 6
-          # 两个归并开关默认关（core 也默认关）。**误合比漏合严重得多**，所以要开就显式开，
-          # 并盯住「归并复核池」视图里的 low 置信样本；一旦发现明显错合，优先在此关掉。
-          thread_enable_mention_merge: true # 提问人锚定 + @人名/称呼；外部群机器人 @ 不了真人，只能靠人名文本
-          thread_enable_heuristic_merge: false # 时间邻近类启发式：准确率未实测，默认不赌
-          # 称呼模式应与机器人回复所用的称呼模板**同源**，否则机器人应答会被拆成独立 thread
-          thread_address_patterns: ["Hi {name}"]
-    steps:
-      thread_observe:
-        bots: "${globalVar.group_configs}"
-        answerers: "${globalVar.admins}"
-        module_owners: "${globalVar.module_owners}" # 模块字典，与答疑链路口径同源
-        max_root_retry: 3
-        max_fail_retry: 3
-        retry_backoff_ms: 600000
-        max_per_round: 3
-        # 试点开关：无真人响应的 thread 也进 LLM 抽取（由 AGENTS.md 口径判类型）。
-        # 默认 false 控成本；验证抽取链路或想沉淀 bot-only 问答时改 true。
-        digest_all: false

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

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

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

@@ -1,49 +0,0 @@
-# 钉钉 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

@@ -1,5 +0,0 @@
-# 问题排查助手
-
-你是一名问题排查助手（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

@@ -1,36 +0,0 @@
-# troubleshoot 声明式分类器（钉钉 AI 表格 profile）
-# 把硬编码正则收敛为声明式分类规则。
-# 命中 → 由 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

@@ -1,58 +0,0 @@
----
-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 时，同步更新本路由表。此文件是本工作区的问题排查入口。