@huicai/cli 2026.814.0 → 2026.1019.0

package/skills/ai-aiops/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-aiops",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "告警风暴太多了，想上智能降噪",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "值班 Copilot 怎么落地，根因推荐靠谱吗",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "AIOps 立项怎么评估成熟度",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份 Prometheus 告警规则",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次数据库慢查询优化",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-coding/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-coding",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "团队想引入 AI 编码助手，怎么落地",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "AI 写的代码质量怎么治理和评审",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "AI 提效说不清楚，怎么度量接受率",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "帮我审查这个 PR 的逻辑错误",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "设计一套 CI 流水线缓存策略",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-compliance/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-compliance",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "AI 功能要上线对外，要不要做双备案",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "生成式 AI 的内容标识义务怎么落",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "语料来源和个人信息授权链怎么合规",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次等保三级整改",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "起草一份数据处理协议",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-eval/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-eval",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "建一套模型评测集，冒烟回归全量怎么分层",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "总感觉模型变笨了，怎么定量化",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "LLM-as-judge 怎么校准才可信",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "跑一次显著性检验看实验结论",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份接口自动化测试用例",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-llm-app/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-llm-app",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "LLM 接口又慢又贵，怎么做缓存和降级",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "结构化输出老是不稳，怎么加防线",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "上下文窗口超限了怎么做预算",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "设计一套 HTTP 接口的鉴权签名",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次前端首屏性能优化",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-mlops/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-mlops",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "自部署推理怎么做量化和批处理",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "AI 账单失控了，怎么做成本归因",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "模型效果悄悄衰减，怎么监控漂移",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份容器编排的部署清单",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次数据仓库分层设计",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-multimodal/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-multimodal",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "发票合同扫描件识别，OCR 置信度怎么分级转人工",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "语音转写热词和 OCR 置信度分级怎么配",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "图表问答读数不准怎么办",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一段爬虫抓取网页正文",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一份视频号内容规划",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-prompt/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-prompt",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "系统提示越写越长失控了，怎么重构",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "输出不稳定，提示怎么一次一变量迭代",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "提示资产怎么版本化做回归",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份产品需求文档",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "设计一个数据库表结构",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ai-rag/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ai-rag",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "知识库问答答非所问，怎么排查检索质量",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "要不要上 RAG 还是微调还是长上下文",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "检索要做权限过滤和引用溯源",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "训练一个分类模型调参",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次全文检索的分词优化",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/anomaly-detection/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "anomaly-detection",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "帮我找出这批数据里的离群值",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "这些交易有没有造假，用本福特定律查一下",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "数据突然波动，做个可疑筛查",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "设计一个 AB 实验的样本量",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份年度审计计划",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/api-design/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "api-design",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "帮我设计一个 REST 接口的端点和契约",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "评审一下这个 API 的资源建模",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "要加个接口，路径和状态码怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "调用第三方接口需要 HMAC 签名怎么写",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "设计一张订单表的索引",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/api-integration/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "api-integration",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "对接这个第三方 API，文档在这，需要 AK SK 签名",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "调用要加时间戳和 nonce 防重放怎么写",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "接口限流了，分页和重试怎么处理",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "设计一套对外开放的 REST 接口契约",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次网页正文的结构化抽取",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/arch-design/trigger-cases.json

@@ -0,0 +1,12 @@
+{
+  "skill": "arch-design",
+  "purpose": "触发行为规格。与 eng-architecture 是刻意分层：方案文档与画图细则在本技能，子链深耕在 eng-architecture。",
+  "intentionalOverlap": ["eng-architecture"],
+  "cases": [
+    { "id": "design-arch", "prompt": "帮我设计一下这个系统的架构方案", "shouldTrigger": true },
+    { "id": "adr", "prompt": "选型定了，怎么把这个决策记录下来", "shouldTrigger": true },
+    { "id": "tech-debt", "prompt": "技术债台账怎么建", "shouldTrigger": true },
+    { "id": "near-miss-draw", "prompt": "把这个架构画成图放进评审材料", "shouldTrigger": false },
+    { "id": "near-miss-api", "prompt": "这几个接口的出入参怎么定", "shouldTrigger": false }
+  ]
+}

package/skills/arch-diagram/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: arch-diagram
+description: 工程绘图（系统总体架构图/技术架构图/业务架构图、部署拓扑、业务流程与数据流、接口时序图、数据模型图、功能结构图、演进路线图）。当用户说"画架构图/画个图/出一套图/把方案画出来/根据源码画架构/概要设计的图"时使用。产出矢量 SVG + 高清 PNG，放大不模糊。
+version: 1.0.0
+---
+
+# 工程绘图（从方案/设计/源码到能进评审材料的图）
+
+工具：`render_diagram(spec)` 出图，`diagram_schema(type)` 查字段。
+**你只出内容结构，版式由引擎负责**——绝不手写 SVG/HTML/mermaid，也不要用 matplotlib 画架构图。
+
+## 先定图型（选错图型，画得再漂亮也白搭）
+
+| 要表达什么 | 图型 | 典型出处 |
+|---|---|---|
+| 系统由哪些层/哪些部件构成、各自职责 | `layered` | 概要设计「系统总体架构」、技术方案 |
+| 用什么技术栈、各层选型 | `layered`（节点用 tags 挂技术） | 技术架构章节 |
+| 业务分几个域、每域有哪些能力 | `layered`（层=业务域，组=子域，节点=能力） | 业务架构、能力地图 |
+| 部署在哪些节点、走什么链路 | `flow`（LR）或 `layered` | 部署方案、运维手册 |
+| 事情按什么顺序流转、谁在什么条件下做什么 | `flow`（多角色时加 lanes 泳道） | 业务流程、数据流 |
+| 一次调用里各方怎么来回交互 | `sequence` | 详细设计的接口时序 |
+| 有哪些表、字段、表间关系 | `er` | 详细设计、数据库设计说明书 |
+| 功能怎么逐级分解 | `tree` | 功能结构图、WBS、模块分解 |
+| 分几期做、每期交付什么 | `timeline` | 可研报告、项目建议书、实施方案 |
+
+一份完整交付通常是**一套图**，不是一张：
+总体架构 + 技术架构 + 业务架构 + 关键流程 + 核心时序 + 数据模型 + 功能结构 + 演进路线。
+多张图相互独立时，**同一轮里并行多次调用 render_diagram**，别一张张串行等。
+
+## 先读懂，再动笔（图错了比图丑严重得多）
+
+- **有设计文档**：读全文，抽出「模块清单 / 层次划分 / 依赖关系 / 技术选型 / 接口清单 / 表清单 / 分期计划」。
+  文档里的名词直接用，不要自己改名（评审时对不上就是事故）。
+- **只有源码**：`list_files` 看目录骨架 → `search_code` 按概念找入口/分层 → `read_file` 确认关键依赖。
+  按「目录结构 + 依赖方向 + 部署单元」三条线还原架构，别照着想象画。
+  Java 看 pom/模块划分与 `@FeignClient`；Node 看 package.json workspaces 与 import；前端看路由与 store。
+- **既有文档又有源码**：以源码为准，文档与代码不一致的地方在 `notes` 里点出来（这是很高的附加值）。
+- 拿不准的部件**宁可不画**，也不要臆造；确实需要但尚未实现的，用 `style:"dashed"` 标成规划中。
+
+## 画到「精致详细」的硬标准
+
+一张能进评审材料的图，下面每条都要满足：
+
+1. **有图名**：`title` 必填，写成「XX系统总体架构图」这种正式名；`subtitle` 一句话点明视角。
+   `meta:["V1.0","2026-08"]` 挂版本与日期，正式交付材料都要。
+2. **节点不是光秃秃的方块**：每个节点给 `desc`（一句话职责，≤20 字）+ `tags`（技术栈/协议/规格，1~3 个）。
+   只有名字的方块是草图，不是交付物。
+3. **层/域的职责写进 `layer.desc`**，别塞进节点名。层名 2~6 字（接入层/应用层/服务层/数据层/基础设施层）。
+4. **一层 3~6 个节点**最耐看；超过 8 个说明这层该拆组（`groups`）或该拆图。
+5. **配色有含义**：同层同色，用 `legend` 说明色彩代表什么（自研/外采/复用/待建）。不要为了花哨换色。
+6. **贯穿性支撑体系走 `sidebars`**：安全保障体系、标准规范体系、运维保障体系——中国式架构图的标配，
+   放右侧竖栏比硬塞进某一层准确得多。
+7. **`notes` 写关键约定**：数据流向、部署边界、与既有系统的关系、图与代码不一致之处。
+8. **重点节点 `emphasis:true`** 实底强调（本次新建/本次改造的部分），一张图不超过 3 个。
+
+## 各图型的实操要点
+
+### layered：三种架构图的层次惯例
+
+- **总体架构**：用户/终端层 → 接入层（网关、负载）→ 应用层（业务模块）→ 服务层（公共服务/中台）→ 数据层 → 基础设施层。
+- **技术架构**：同样分层，但节点写**技术组件**（Nginx / Spring Cloud Gateway / Redis / Kafka…），`tags` 写版本。
+- **业务架构**：层 = 业务域（获客域/交易域/履约域/结算域/管理域），组 = 子域，节点 = 业务能力（动词短语，如"额度审批"）。
+  业务架构图里**不出现任何技术名词**——出现了就说明画串了。
+- 需要表达自上而下的调用/数据方向时加 `"flow":"down"`。
+
+### flow：流程图
+
+- 起止用 `shape:"round"`，判断用 `"diamond"`，存储用 `"cylinder"`，输入输出用 `"parallelogram"`。
+- 判断节点必须**每个分支都有出边且带 label**（"是/否"、"通过/驳回"），没有出口的判断是错误。
+- 涉及多个角色/部门 → 加 `lanes` 变成跨职能泳道图，每个节点标 `lane`。
+- 主干竖着走（TB），链路型/部署型横着走（LR）。回边（重试、驳回）引擎会自动虚线绕行，直接写就行。
+
+### sequence：时序图
+
+- `actors` 按调用顺序从左到右排（用户 → 前端 → 网关 → 服务 → 存储），排乱了线会来回穿。
+- 一图一场景（"登录鉴权"而不是"用户模块"），消息 8~15 条最佳，超过 20 条就拆图。
+- 返回消息用 `kind:"return"`，异步用 `"async"`；重要约束写进 `note`（超时、重试、幂等、锁定策略）。
+- 分支/循环用 `frames`（alt/loop/opt/par），`from`/`to` 填消息下标。
+
+### er：数据模型图
+
+- 字段只保留**主键、外键、业务关键字段**，别把 40 个字段全塞进去（`comment` 补说明）。
+- `pk:true` / `fk:true` 一定标；`kind` 用 `1-n` / `n-m` 并给 `label`（"拥有"/"包含"/"引用"）。
+- 一张图 ≤ 12 张表，超了按业务域拆（订单域一张、用户域一张）。分库分表的表在 `comment` 里注明分片键。
+
+### tree：功能结构图
+
+- 三层为宜：系统 → 一级模块 → 二级功能。四层以上改用多张图。
+- 一级模块给 `color` 区分，下级自动继承分支色；叶子多时引擎自动竖排成列。
+- 节点名用**名词短语**（"权限管理"而非"管理权限"），同级粒度要一致。
+
+### timeline：演进路线图
+
+- 3~4 期最好读。每期给 `period`（时间）、`items`（交付物清单）、`goal`（验收目标，要有数字）。
+- 已完成项标 `done:true`。`goal` 里写"日均 1 万单、可用性 99.9%"这类可验收的话，别写"提升效率"。
+
+## 出图与交付
+
+```
+render_diagram(path="docs/diagrams/总体架构图.svg", spec={...})
+```
+- 默认同时产出 **SVG（矢量，放大任意倍率不模糊，Word/WPS/PPT 都能直接插入并无损缩放）**
+  和 **PNG（3 倍设备像素比，贴微信/邮件/网页不糊）**。
+- 印刷/投标材料：`scale=4`；黑白复印件：`theme="print"`；深色汇报底：`theme="dark"`。
+- 要 PDF 单页矢量：`format="pdf"`。
+- **改图就改 spec 重新生成，绝不手改 SVG**。把 spec 存成 `docs/diagrams/<图名>.json`，
+  以后文档变更只改 JSON 重跑一次，图和文档就不会脱节。
+
+## 交付前自查
+
+- [ ] 图名/版本齐全，一眼能看出这是什么系统的什么视角
+- [ ] 名词与源码/设计文档完全一致，没有臆造的模块
+- [ ] 每个节点有职责说明，关键节点有技术栈标注
+- [ ] 分层/分域逻辑自洽，同层粒度一致，没有"一层只有一个方块"
+- [ ] 判断分支都有出口且有标注；时序图角色顺序不来回穿
+- [ ] 有图例说明配色含义，有注记说明关键约定
+- [ ] 工具返回的「提醒」（名称过长、连线悬空）已逐条处理
+- [ ] 一套图之间口径一致（总体架构里的模块名 = 功能结构里的模块名）

package/skills/arch-diagram/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "arch-diagram",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "帮我画一张系统总体架构图",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "根据源码出一套部署拓扑和时序图",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "把这个方案画成业务流程图",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一份 PPT 汇报材料",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段前端组件的样式",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/arch-distributed/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "arch-distributed",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "跨服务事务怎么设计，要不要上 TCC",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "分布式 ID 怎么生成，时钟回拨怎么办",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "要不要上分布式锁，数据不一致怎么排查",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次单机 JVM 调优",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "设计一张宽表的分区策略",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/arch-multitenant/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "arch-multitenant",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "SaaS 多租户怎么做数据隔离，共表还是分库",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "大客户要独立部署，租户定制边界怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "noisy neighbor 怎么做配额治理",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "设计一个用户登录的鉴权流程",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次缓存穿透的防护",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/audio-brief/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: audio-brief
+description: 把文稿改写成口播稿并合成音频简报（日报/周报/监视简报转成能在路上听的音频）。当用户说"念给我听/做成音频/语音播报/路上听/生成播客/口播稿"，或要求定时任务的产出附一份音频时使用。
+version: 1.0.0
+---
+
+# 音频简报：把要看的东西变成能听的东西
+
+自动化任务每天产出日报、周报、监视简报，而这些东西的阅读场景恰恰是**上班路上、会议间隙**——
+两个不方便看屏幕的场景。这个技能把已有的文字产出加一路音频输出。
+
+**它是文字简报的附加物，不是替代物。**音频不可检索、不可引用、不能跳读，
+文字版必须照旧产出。
+
+## 两步走，分工不能混
+
+| 步骤 | 谁做 | 为什么 |
+|---|---|---|
+| ① 把文稿改写成**口播稿** | **你（模型）** | 需要判断哪些能省、数字怎么读、段落怎么过渡 |
+| ② 切分 → 逐段合成 → 拼接 | **内核工具** | 纯确定性工作，交给模型编排只会每次做法都不一样 |
+
+不要自己写循环去调 TTS，也不要让用户手动拼音频。
+
+## 第一步：改写口播稿
+
+**直接把 Markdown 丢进 TTS 是不行的**——听众会听到「井号井号 三 本周概况」「星号星号 重点 星号星号」。
+清理标记内核会做，但**语体**要你改。六条规则：
+
+1. **短句**。书面语一句能套三个从句，听觉一次只能装一个意思。见到长句就断开。
+2. **数字读法**。`23.5%` 写成「百分之二十三点五」；`2026-08-20` 写成「八月二十号」；
+   `¥1,234,567` 写成「一百二十三万四千多」——**听众记不住精确到个位的大数**，播报要给量级。
+3. **去掉纯视觉元素**。表格改叙述（「三个部门里销售部涨得最多」），图表引用改结论，
+   链接直接删（念一串 URL 是灾难）。
+4. **补过渡**。文字靠标题分节，语音没有标题。段落之间要有「先说第一件事」「接下来是本周的异常」
+   这类路标，否则听众三十秒后就不知道听到哪了。
+5. **开头一句话说清这是什么**。「这是八月二十号的经营日报，一共三件事。」
+   听众按下播放时没有屏幕给他上下文。
+6. **结尾给行动**。「需要你今天确认的是第二件事。」听完不知道要干嘛的播报等于没听。
+
+**长度纪律**：口播稿控制在原文的三到五成。一份两千字的日报，口播稿六百到一千字（约三到五分钟）。
+超过五分钟的播报没人听得完——宁可只播「今天最要紧的三件事」，也不要把全文念一遍。
+
+## 第二步：合成
+
+改写完的口播稿交给内核工具合成。工具会：按句切分（默认每段 400 字）→ 逐段调 TTS →
+按序拼接成一个音频文件。三条内建纪律：
+
+- **超上限直接拒绝**，不静默截断（默认 120 段，约四万八千字）。
+  用户以为整份都念了、实际只念了三分之一，比明确报错糟得多——他不会去核对音频长度。
+- **任一段失败即整体失败**，不返回半截音频。一段没合成上的播报听起来只是「跳了一句」，
+  听的人根本不知道自己漏了什么。
+- **不支持 wav / pcm**：每段自带文件头，裸拼只有开头能播，故直接拒绝而不是给一个坏文件。
+
+## 什么时候不要用
+
+- **需要引用、需要检索、需要跳着看的内容**——那是文字的活。
+- **一次性的短回答**（几十个字）：交互式朗读就够了，不必走这条链路。
+- **默认给所有定时任务加音频**：一份日报要几十次 TTS 调用，按次计费。
+  应当由用户对**特定任务**显式开启。
+
+## 与其它技能的接力
+
+- 上游：`office-automation`（定时产出日报/周报）、`meeting-minutes`（纪要）、
+  `data-report-pro`（数据简报）——它们出文字，本技能出音频。
+- 投递：音频作为交付物落盘；要发给别人走通知中心的邮件渠道（附链接，不要附几 MB 的音频体）。