semantic-split
/install semantic-split
\r \r
语义拆分与智能规划技能 (Semantic Split v2.0)\r
\r
概述\r
\r 将用户自然语言输入拆分为结构化的需求块,并基于规则级/能力级 json 渐进加载机制生成串并行规划步骤,实现「一次使用 → 沉淀 json → 下次复用」的自增强闭环。\r \r 核心逻辑:识别主语划分块 → 提取目的/行为/动机 → 结构化输出 → 用户确认 → 渐进加载 json → 生成规划 → 询问执行 → [可选] 生成能力级 json\r \r ---\r \r
第一部分:语义拆分规则\r
\r
一、划分块(Block)\r
\r
识别主语,划分语义块:\r
\r
| 主语类型 | 识别方式 | 块标记 |\r
|---------|---------|--------|\r
| 用户("我") | 说话者本人 | 块1:用户 |\r
| AI助手("你") | 执行者、帮助者 | 块2:执行者 |\r
| 第三方("他/她/它") | 提及的其他角色 | 块3:第三方-N |\r
\r
块内元素提取:\r
\r
| 元素 | 定义 | 示例 |\r
|-----|------|-----|\r
| 目的 (Purpose) | 最终要达成的目标 | "明天要介绍产品" |\r
| 行为/诉求 (Request) | 需要执行的具体操作或交付物 | "做一个PPT"、"写一份报告" |\r
| 动机 (Motivation) | 为什么会产生这个需求 | "PPT太难做了"、"时间紧迫" |\r
\r
二、诉求聚合(Request Aggregation)\r
\r 将同一目的下的所有诉求点聚合,包括:\r
- 核心诉求(主要交付物)\r
- 支撑信息(背景、条件、约束)\r
- 附加细节(特征、规格、要求)\r \r
三、常见主语映射表\r
\r | 文本中的词 | 映射为 | 备注 |\r |-----------|-------|------|\r | 我、咱们、俺 | 用户 | 说话者本人 |\r | 你、您 | 执行者 | AI助手 |\r | 我们 | 用户(含其团队) | 视为用户群体 |\r | 他/她/它 + [名称] | 第三方 | 需标注具体身份 |\r | [公司/产品名] | 第三方 | 实体对象 |\r \r
四、边界情况处理\r
\r | 情况 | 处理方式 |\r |-----|---------|\r | 单用户无明确主语 | 默认主语为"用户",生成1个块 |\r | 多个并列诉求 | 在同一块内以编号列表呈现 |\r | 隐含目的(没说"为了X") | 根据上下文推断,在动机中标注"[推断]" |\r | 情绪/语气词 | 归入动机,标注"[情绪]" |\r | 时间约束 | 归入目的或诉求中的约束条件 |\r | 预算/资源限制 | 归入诉求中的约束条件 |\r | json 库为空 | 跳过①②,直接进入③模型思考 |\r | json 部分匹配 | 取最佳匹配,渐进加载补充 |\r \r ---\r \r
第二部分:完整执行流程\r
\r
步骤 1:接收输入\r
\r
用户输入 → 保留原文,记录原始输入\r
```\r
\r
### 步骤 2:识别主语 & 划分块\r
\r
扫描文本,识别所有主语代词和指代:\r
- 第一人称:我、咱们、俺\r
- 第二人称:你、您、咱们\r
- 第三人称:他、她、它、以及具体名称\r
\r
每个独立主语 = 一个块\r
\r
### 步骤 3:提取块内元素\r
\r
对每个块,逐句分析:\r
\r
```\r
对于 [主语] 说的每句话:\r
→ 目的:这句话要达成什么?(找"为了"、"要"、"想"等关键词)\r
→ 行为:需要做什么具体操作?(找动词)\r
→ 动机:为什么会这么说?(找原因、背景、情绪)\r
```\r
\r
### 步骤 4:结构化输出\r
\r
```\r
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\r
┃ 语义拆分结果 ┃\r
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛\r
\r
【原始输入】\r
[用户原话完整引用]\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
【拆分结果】\r
\r
## 块 N:[主语名称]\r
角色:[用户/执行者/第三方]\r
目的:[该主语要达成的核心目标]\r
诉求:\r
1. [诉求点1 - 核心交付物]\r
2. [诉求点2 - 支撑信息/细节]\r
动机:[产生该需求的背景/原因/情绪]\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
【确认询问】\r
以上拆分是否完整准确?如有遗漏或错误,请补充或纠正。\r
```\r
\r
### 步骤 5:用户确认\r
\r
- 如有遗漏 → 用户补充 → 更新结构\r
- 如全部正确 → 进入步骤 6\r
\r
### 步骤 6:渐进加载与规划生成\r
\r
> ⚠️ **本步骤需要加载参考文档。执行前读取以下文件:**\r
> - `references/loading_decision_tree.md` — 渐进加载决策树(必须加载)\r
> - `references/planning_rules.md` — 规划规则详情(模型思考时加载)\r
> - `references/json_schema.md` — json 结构规范(生成 json 时加载)\r
\r
按决策树执行:\r
1. 扫描规则级 json 库 → 命中则加载并展示规划\r
2. 不命中则扫描能力级 json 库 → 命中则加载并展示规划\r
3. 均不命中则**模型思考**生成规划(需加载 `references/planning_rules.md`)\r
4. 展示规划 → 询问用户是否执行(含调整/新建 json 选项)\r
\r
### 步骤 7:执行与 json 生成\r
\r
- 用户确认执行 → 执行任务\r
- 仅分支③(不命中 + 确认执行)→ 执行完成后生成通用化能力级 json(需加载 `references/json_schema.md`)\r
- 其他分支 → 不生成新 json(除非用户主动要求更新/新建)\r
\r
---\r
\r
## 第三部分:触发条件\r
\r
当用户出现以下意图时,必须触发本技能:\r
\r
1. 提出任务请求("帮我做..."、"请你...")\r
2. 表达需求("我需要..."、"我想...")\r
3. 委托工作("交给你了..."、"你去...")\r
4. 描述问题寻求帮助("有个问题...帮我...")\r
5. 用户未明确说但有明显需求意图时\r
\r
**注意**:简单问答("今天天气怎么样")、闲聊("你好")无需拆分。\r
\r
---\r
\r
## 脚本工具\r
\r
> **json_manager.py** — 统一管理能力级/规则级 json 的 CLI 工具,位于 `scripts/json_manager.py`。零外部依赖。\r
\r
| 子命令 | 功能 | 典型用法 |\r
|--------|------|---------|\r
| `scan` | 按关键词扫描匹配 json 库 | `scan --keywords ppt 制作 --top 5` |\r
| `categorize` | 按 tags 归类统计,判断是否达到规则级阈值 | `categorize --threshold 5` |\r
| `generalize` | 字段替换通用化(params模式)/ 自动检测占位符(auto模式) | `generalize --input xxx.json --params "钛合金=[产品名称]"` |\r
| `rule-gen` | 从多个能力级 json 生成规则级 json 框架 | `rule-gen --tag ppt` 或 `rule-gen --files a.json b.json` |\r
| `list` | 列出所有 json 文件(支持类型/标签过滤) | `list --type capability --verbose` |\r
| `create` | 创建新 json 骨架文件 | `create --type capability --name make_report_v1` |\r
| `validate` | 验证 json 格式正确性 | `validate --file xxx.json` |\r
| `info` | 显示 json 文件详情 | `info --file xxx.json` |\r
\r
**脚本路径**:`~/.workbuddy/skills/semantic-split/scripts/json_manager.py`\r
\r
---\r
\r
## 参考文档(渐进加载)\r
\r
| 文件 | 内容 | 加载时机 |\r
|------|------|---------|\r
| `references/loading_decision_tree.md` | 渐进加载决策树 + json 生成条件总结 | 进入步骤 6 时**必须加载** |\r
| `references/planning_rules.md` | 串并行规划规则详情(原子拆解/并行/热度/milestone/输出格式) | 模型思考生成步骤时加载 |\r
| `references/json_schema.md` | 能力级/规则级 json 结构 + 通用化规则 | 生成或更新 json 时加载 |\r
| `references/automation_tasks.md` | 轻量级/重量级定时任务 + json 存储结构 | 用户要求定时任务时加载 |\r
\r
---\r
\r
## 拆分示例\r
\r
### 示例输入\r
\r
> "这个PPT太难搞了,我想让你为我做个PPT,明天要介绍产品的,就一个钛合金马扎,我们研发了200多天,开了200次产品会就为了精益求精,他主要成分就是钛合金,和常见的马扎功能一样,但是防水、耐磨、不易损坏,承担了这些优势的情况下还很轻,你为我做PPT把。"\r
\r
### 拆分结果\r
\r
```\r
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\r
┃ 语义拆分结果 ┃\r
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛\r
\r
【原始输入】\r
这个PPT太难搞了,我想让你为我做个PPT,明天要介绍产品的,就一个钛合金马扎,我们研发了200多天,开了200次产品会就为了精益求精,他主要成分就是钛合金,和常见的马扎功能一样,但是防水、耐磨、不易损坏,承担了这些优势的情况下还很轻,你为我做PPT把。\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
【拆分结果】\r
\r
## 块 1:用户("我")\r
角色:requester(需求方)\r
目的:明天要介绍产品\r
诉求:\r
1. 做一个PPT(核心交付物)\r
2. 介绍钛合金马扎产品\r
3. 研发周期:200多天\r
4. 产品会议:200次\r
5. 品质追求:精益求精\r
6. 主要成分:钛合金\r
7. 功能:与常见马扎同质\r
8. 优势:防水、耐磨、不易损坏\r
9. 附加优势:轻便(同比质量小)\r
动机:用户觉得PPT太难做\r
\r
## 块 2:执行者("你")\r
角色:executor(执行方)\r
目的:制作一个符合用户诉求的PPT\r
诉求:\r
1. 使用技能或MCP等进行完整的PPT制作\r
2. 涵盖产品核心卖点(钛合金材质、轻便耐用)\r
3. 体现研发投入(200天、200次会议)\r
4. 突出精益求精的品质追求\r
动机:块1的所有要求\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
【确认询问】\r
以上拆分是否完整准确?如有遗漏或错误,请补充或纠正。\r
```\r
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install semantic-split - 安装完成后,直接呼叫该 Skill 的名称或使用
/semantic-split触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
semantic-split 是什么?
语义拆分与智能规划技能。将自然语言拆分为结构化需求块,基于规则级/能力级json渐进加载生成串并行规划步骤,支持自增强json沉淀机制。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 35 次。
如何安装 semantic-split?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install semantic-split」即可一键安装,无需额外配置。
semantic-split 是免费的吗?
是的,semantic-split 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
semantic-split 支持哪些平台?
semantic-split 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 semantic-split?
由 Lighthexuish(@ldxs001)开发并维护,当前版本 v2.0.0。