user-thoughts

# user-thoughts.SKILL ## 概述 跨会话、跨 Agent 时，用户积累的决策和约束会彻底丢失。user-thoughts.SKILL 将这些想法持久化到 mdbase，绑定于项目而非会话——任何接手的 Agent 读取 mdbase 即可继承用户的完整意图，无需重新推导。 ## 重要声明 - **本 SKILL** 系指本文档及同目录下内容，整体称 `user-thoughts.SKILL` - **用户**：使用、调用、提及本 SKILL 的发言人 - **行为边界**：SKILL 只做想法分析和记录，不干预 Agent 对用户指令的执行。这是核心设计——当用户说"把按钮改成红色"时，Agent 应同时执行修改并记录偏好，两者并行互不干扰。记录行为不应延迟或阻塞用户的实际工作 ## When to Use - 用户输入 `/user-thoughts` 或 `/ustht` 命令时 - 用户讨论架构、技术栈、规则、UI/UX 等项目决策时 - 用户发言中提及"想法"、"记录"、"mdbase"等关键词时 - 用户表达项目相关的需求、偏好、约束时 ## 使用指南 - 用户发言包含项目想法、决策、需求、规则、偏好时，SKILL 自动激活 - 命令以 `/user-thoughts` 或 `/ustht` 引导（详见 [references/commands.md](references/commands.md)） - 自然语言触发兼容任何语言——Agent 应匹配用户意图，而非特定关键词 **命令前缀**：`/user-thoughts` 为完整前缀，`/ustht` 为简写，两者等价可互换。 **激活边界**：当用户发言同时包含指令和想法时（如"把这个按钮改成红色"），Agent 应执行指令并同时记录想法。仅当发言纯粹是闲聊或与项目完全无关时（如"今天天气不错"）才不激活。 ## 语言策略 - **SKILL 本体**（SKILL.md、references/、assets/）语言固定为中文，不随用户语言变化 - **Agent 输出适配用户语言**：命令反馈、sortin 摘要、mdbase 展示、提示信息等面向用户的输出，应使用用户当前对话所用的语言——用户无需切换语言即可理解反馈 - **想法原文保留**：raw 记录和 mdbase 中的想法内容保持用户原始语言，不翻译、不转换——保持原文可避免翻译引入的歧义，且用户原始表述是最权威的意图表达 ## 工作原理 ### 工作流 ``` 用户发言 → Agent 识别项目想法 → 写入 raw/（即时计划） ↓ 用户执行 /ustht sortin → Agent 处理 raw/ → 按维度追加到 mdbase/ ↓ 用户执行 /ustht mdbase show → Agent 展示组织好的想法库 ``` ### 工作模式 - **被动模式**（`INSTANT_STATUS=off`）：仅响应技能命令，不自动识别想法 - **即时计划模式**（`INSTANT_STATUS=on` 且 `SKILL_STATUS=on`）：自动识别用户想法并写入 `#raw/`，mdbase 写入延迟到 sortin - **忽略模式**：`ignore start`/`end` 区间内发言不记入 - **只读模式**（必需工具缺失时）：只读命令可用，写入命令返回提示 模式组合：即时计划 + 忽略可同时生效。`S...