semantic-understandinglisted

# Semantic Understanding · 语义理解层 > 提示词优化改的是**「AI 怎么说」**；这一层改的是**「AI 怎么听」**。 > 沉淀的不是通用技巧，是**这个人**的表意习惯。 ## 定位：与相邻能力的分工 | 能力 | 存什么 | 回答什么问题 | |------|--------|--------------| | `starfounder-experience-alchemy` | 做事的坑、流程、checklist | "这件事怎么做才不踩坑" | | **本技能** | 说话的习惯、误解映射 | **"他这句话到底什么意思"** | | 提示词优化 | 指令措辞 | "怎么把话写清楚" | 三者正交。本技能**不修改** alchemy 或任何其他技能的文件，全部数据位于自身目录内。 ## 常驻机制：它怎么进入上下文（2026-09-25 实装） 技能本体是**懒加载**的 —— 宿主每会话只注入 name + description，`SKILL.md` 正文要触发才读。 所以「装了」不等于「在生效」。真正让它每轮生效的是下面三层： | 层 | 位置 | 性质 | |---|---|---| | **hook 自动注入** | `~/.workbuddy/settings.json` 的 `hooks.UserPromptSubmit` | 硬机制，无需人介入 | | **user memory 硬指令** | `~/.workbuddy/MEMORY.md` 顶部 | 每会话必注入，兜底 | | 显式调用 | `@skill:semantic-understanding` 或直接跑 `su.py` | 手动，最可控 | ### hook 行为（`hook.py`） 用户每发一句话，宿主调用 `hook.py`，它把命中的规则以 `additionalContext` 注入： - **常驻规则**：每会话首批注入一次（靠 `session_id` 状态记录） - **长尾命中**：按当轮这句话现算，命中即注入 - **两重去重**：① 常驻规则有**与 session 无关的 10 分钟窗口保险** —— 万一张口每轮都换 `session_id`，也不至于每轮重复塞 9 条规则；② 同一组长尾连续命中不重复注入。 - **绝不阻塞**：任何异常都静默 `exit 0` 零输出。hook 坏掉最多是没注入，绝不能让你发不出话。 ### 自检（必跑） ```bash python "$SU" doctor ``` 防的是**静默失效**：hook 命令里写的是解释器**绝对路径**，WorkBuddy 升级 managed Python、 版本目录改名后，hook 会无声无息地不再注入 —— 表现只是「AI 怎么又听不懂了」， 没人会想到是配置断了。`doctor` 把它变成可检查的，并直接给出修复要用的解释器路径。 **已知坑**：`~/.workbuddy/settings.json` 里的 hook 命令**不要写成 `bash script.sh`**。 本机 `bash` 这个名字被解析到 `C:\Windows\System32\bash.exe`（WSL 启动器）， 会被安全策略拦截（`wsl.exe` 在黑名单里）。直接写 `"<python.exe 绝对路径>" "<hook.py 绝对路径>"`。 同理，hook 脚本**不要依赖 coreutils**（本