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）
• 自然语言触发兼容任何语言——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 区间内发言不记入
• 只读模式（必需工具缺失时）：只读命令可用，写入命令返回提示

模式组合：即时计划 + 忽略可同时生效。SKILL_STATUS=off 时即时计划自动暂停，无论 INSTANT_STATUS 值如何。被动/即时计划通过 define.ini 持久化；忽略区间仅上下文有效。

---

目录定义

• @/：SKILL 安装目录（SKILL.md 所在目录，即 user-thoughts/）
• ~/：工作目录
• #ustht/ = ~/.ustht/（.ustht 是 user-thoughts 的运行时缩写）
• #mdbase/ = ~/.ustht/mdbase/
• #ignored/ = ~/.ustht/ignored/
• #raw/ = ~/.ustht/raw/
• #export/ = ~/.ustht/export/

---

#ustht 目录结构

.ustht/
├── define.ini           # SKILL 运行状态
├── README.ai.md         # .ustht/ 目录说明
├── raw/                 # 用户原始发言(按日期分片)
│   └── yyyy-mm-dd.md
├── ignored/             # 被标记忽略的发言
│   └── yyyy-mm-dd.md
├── mdbase/              # 整理后的用户想法库
│   ├── backlog.md       # 待办事项（用户明确提出但尚未开始的事项，由 sortin 归入）
│   ├── README.ai.md     # mdbase 索引与概览
│   └── details/         # 按维度组织的想法文件
│       ├── rules.md     # 项目规则、约束、原则
│       ├── plans.md     # 项目规划、方向性想法
│       ├── ui/
│       │   ├── outline.md  # UI 整体设计
│       │   └── details.md  # UI 细节设计
│       ├── dev-stack.md # 技术栈选型、框架决策
│       ├── general.md   # 通用（不属于其他维度的想法）
│       └── ...          # 按需扩展
└── export/              # 从 mdbase 导出的内容