表达层

Other

[何时使用]当需要内容生成、格式转换或多形式输出时触发。支持直接输入问题/素材/链接,无需前置思考层。统一路由至 ljg-skills 及发布工具。

Install

openclaw skills install expression-layer

expression-layer: 表达层 🎨

📋 功能描述

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

适用场景:

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

边界条件:

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

🔄 路由编排矩阵

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

编排模式

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

⚠️ 常见错误

错误 1:强行附加思考层

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

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

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

问题:
• 只给内容,不指定输出形式
• 路由歧义(该出文章还是卡片?)

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

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

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

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

🧪 使用示例

输入:

什么是定投?说人话,顺便做个卡片。

预期输出:

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

输入:

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

预期输出:

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

输入:

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

预期输出:

  • 识别意图:wechat
  • 编排:ljg-writeshumanizer-zhwechat-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