expression-layer: 表达层 🎨#

📋 功能描述#

帮助用户 统一调度内容生成与可视化输出。不依赖前置思考层，直接接收问题/素材/链接，按意图路由至对应 skill，支持单步/串联/并行/发布编排。

适用场景：

• 直接问概念/问题 → 口语化解释/深度文章
• 提供素材/草稿 → 写作 + 人性化 + 多形式输出
• 论文/单词/城市 → 解读 + 可视化卡片
• 完整文章 → 公众号发布

边界条件：

• 不负责深度分析/数据查询（由上游工作流或思考层提供）
• 输出格式依赖上游指定或意图自动识别
• 新增 skill 需更新路由矩阵

---

🔄 路由编排矩阵#

输入类型触发意图编排路径输出形式典型场景专业概念/问题plain``ljg-plain大白话文本（≤200字）“什么是PE？说人话”观点/素材/草稿writes``ljg-writes → humanizer-zh深度文章（1000-1500字）“把这段写成公众号文章”任何文本/数据card``ljg-card（-l/-i/-c/-w/-b）PNG 卡片“做个信息图/漫画/大字”文本/大纲present``ljg-presentHTML 高桥流“做成演讲PPT”论文链接/PDFpaper_flow``ljg-paper → ljg-card解读Markdown + PNG“读论文并做漫画卡片”英文单词word_flow``ljg-word → ljg-card解析Markdown + PNG“解词并做信息图”城市/主题travel``ljg-travel研究报告 + PNG卡片“做西安旅行功课”完整文章/解读wechat``wechat-publisher公众号推文（HTML+封面）“发到公众号”

编排模式：

• 单步：直接路由到 1 个 skill
• 串联：A 输出 → B 输入（如 ljg-paper → ljg-card）
• 并行：同时生成多个形式（如 大白话 + 卡片 + 文章）
• 发布：内容 → wechat-publisher → 公众号

---

⚠️ 常见错误#

错误 1：强行附加思考层

text

问题：
• 用户只问“什么是定投”，却先跑降秩/追本分析
• 输出冗长，偏离直接表达需求

解决：
✓ 表达层是独立入口，不依赖思考层
✓ 直接按意图路由到 ljg-plain / ljg-writes
✓ 如需深度分析，由上游工作流调用，非表达层职责

错误 2：忽略输出格式指定

text

问题：
• 只给内容，不指定输出形式
• 路由歧义（该出文章还是卡片？）

解决：
✓ 优先按关键词自动识别意图（如“说人话”→plain，“做卡片”→card）
✓ 歧义时主动询问：“需要大白话解释、深度文章，还是可视化卡片？”
✓ 支持并行输出：plain + card + writes

错误 3：新增 skill 未更新路由

text

问题：
• 安装了新 skill，但路由矩阵未更新
• 表达层无法调度新能力

解决：
✓ 新增 skill 后，同步更新 SKILL.md 路由矩阵
✓ 在 references/orchestration-matrix.md 维护完整映射
✓ 提交版本升级（patch version）

---

🧪 使用示例#

输入：

text

什么是定投？说人话，顺便做个卡片。

预期输出：

• 识别意图： multi (plain + card)
• 编排：并行执行 ljg-plain + ljg-card -i
• 输出：大白话文本 + PNG 信息图

输入：

text

读这篇论文 https://arxiv.org/abs/xxx，做成漫画卡片。

预期输出：

• 识别意图： paper_flow
• 编排：串联执行 ljg-paper → ljg-card -c
• 输出：论文解读 Markdown + 漫画风格 PNG

输入：

text

把刚才的消费分析写成公众号文章发出去。

预期输出：

• 识别意图： wechat
• 编排： ljg-writes → humanizer-zh → wechat-publisher
• 输出：公众号草稿（已排版+封面+合规检查）

---

🔧 故障排查#

问题检查项不触发description 是否包含触发词？用户输入是否匹配意图？路由错误意图识别是否准确？是否歧义未询问？输出为空上游 skill 是否安装？（ljg-plain/ljg-card/wechat-publisher）新增 skill 不调用路由矩阵是否更新？references 是否同步？格式错误输出格式是否指定？并行输出是否超出上下文限制？

---

🔗 相关资源#

• 路由编排矩阵： references/orchestration-matrix.md
• 投教工作流编排分析： references/ie-orchestration.md
• 输出模板： templates/output-template.md
• 标准参考： docs/SKILL-STANDARD-v3.md