@topmindspace/topmind-skills 4.13.5 → 4.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.en.md CHANGED
@@ -43,7 +43,7 @@ topmind-skills/ # pack root = repo root
43
43
  ├── topmind-weread|x/ # optional connectors
44
44
  ├── topmind-ledger/ # optional bookkeeping (memory-plane ledgers)
45
45
  ├── topmind-wechat/ # optional WeChat write sub-skill (not a peer entry)
46
- ├── shared/ # write receipts · degradation · capture …
46
+ ├── shared/ # write receipts · degradation · auto-suggest · capture …
47
47
  ├── install-targets/ # host install shapes
48
48
  ├── evals/evals.json
49
49
  ├── bin/install-skills.mjs # pack-aware installer (shared/ aware)
@@ -71,12 +71,14 @@ Content truth: topmind-workspace
71
71
  Capability model: action-first
72
72
  Save settings: auto | confirm
73
73
  Safety model: reversible by default
74
+ Suggestions: L0 auto-land · L1 auto-prepare · L2 confirm-apply — shared/auto-suggest.md
74
75
  ```
75
76
 
76
77
  Expose only `topmind` as the daily entry. Host session state must not become topmind content truth.
77
78
  **Desktop is not required** for this pack. **UTR is optional** — use host file tools when UTR is absent.
78
79
 
79
80
  Workflow: `收进来 -> 继续做 -> 交付/沉淀 -> 找回/调整`
81
+ **Capture whenever / use whenever:** capture lands with zero questions; classification alternatives, todo extraction, and memory candidates are prepared as L1 suggestions for one-word accept ([`shared/auto-suggest.md`](./shared/auto-suggest.md)). `memory/todo.md` is a satellite — not a sixth concept.
80
82
  (If the user says “capture this”, “note it”, “organize”, “write it up”, or “run a loop”, the router infers category / topic / action.)
81
83
 
82
84
  ---
@@ -133,14 +135,14 @@ Loose note: `{category}/{note}.md` when no topic yet.
133
135
 
134
136
  Do not hardcode absolute paths — infer `workspace_root` from the host or ask.
135
137
 
136
- ### 6 条核心规约
138
+ ### 6 core rules
137
139
 
138
- 1. **大类不重叠**
139
- 2. **专题自然涌现**
140
- 3. **动态类特殊**(默认平铺)
141
- 4. **兜底类清理**(约 30 天)
142
- 5. **参考资料定位**
143
- 6. **大类命名稳定**(rename via migration)
140
+ 1. **Categories never overlap**
141
+ 2. **Topics emerge** (do not force-create)
142
+ 3. **Dynamic/stream category is special** (flat-default)
143
+ 4. **Catch-all cleanup** (~30 days)
144
+ 5. **Reference materials stay reference-only**
145
+ 6. **Category names stay stable** (rename via migration)
144
146
 
145
147
  Full rules: [`shared/project-model-brief.md`](./shared/project-model-brief.md).
146
148
 
@@ -155,7 +157,7 @@ Full rules: [`shared/project-model-brief.md`](./shared/project-model-brief.md).
155
157
  - `source_type`: `user-original` | `external-capture` | `ai-derived`
156
158
  - UTR is optional — host file tools preserve the same contract
157
159
  - Save settings protocol: `writeback_mode: auto | confirm`
158
- - Locked/final files → revision copy (`文章 - 修订版.md`), not in-place auto-edit
160
+ - Locked: editable under auto (task-level first-write snapshot); permanent delete of locked/core is user-only
159
161
  - Desktop is not required for this pack
160
162
  - **Compound discipline (no structure change):** organize leaves synthesis on disk; write reads optional `topic.md` first; memory only on explicit confirm; capture never edits `topic.md`; **no** hard `INDEX.md` / parallel wiki trees (see `shared/project-model-brief.md`)
161
163
 
package/README.md CHANGED
@@ -43,7 +43,7 @@ topmind-skills/ # pack 根 = 仓库根
43
43
  ├── topmind-weread|x/ # 可选连接器
44
44
  ├── topmind-ledger/ # 可选记账(记忆平面账本)
45
45
  ├── topmind-wechat/ # 可选公众号 write 子技能(不是并列入口)
46
- ├── shared/ # 写回回执 · 降级 · 捕获 …
46
+ ├── shared/ # 写回回执 · 降级 · 自动建议 · 捕获 …
47
47
  ├── install-targets/ # Host 安装形状(claude-code / codex / mimocode / …)
48
48
  ├── evals/evals.json
49
49
  ├── bin/install-skills.mjs # pack-aware + agent matrix 安装器
@@ -71,6 +71,7 @@ Content truth: topmind-workspace
71
71
  Capability model: action-first
72
72
  Save settings: auto | confirm
73
73
  Safety model: reversible by default
74
+ Suggestions: L0 auto-land · L1 auto-prepare · L2 confirm-apply — shared/auto-suggest.md
74
75
  ```
75
76
 
76
77
  日常入口只暴露 `topmind`。Host 会话状态不得成为 topmind 内容真源。
@@ -79,6 +80,8 @@ Safety model: reversible by default
79
80
  工作流:`收进来 -> 继续做 -> 交付/沉淀 -> 找回/调整`
80
81
  (用户说「收一下」「记一下」「整理」「写成稿」「跑一遍 loop」— router 推断类别 / 专题 / 动作。)
81
82
 
83
+ **想记就记 / 随用随记**:捕获零提问落盘(L0);分类备选 / 待办 / 记忆候选默认 L1 准备——显式行动语待办在 auto 下同轮写入 `memory/todo.md`,其余建议点头再落([`shared/auto-suggest.md`](./shared/auto-suggest.md))。
84
+
82
85
  ---
83
86
 
84
87
  ## SKILL.md frontmatter
@@ -155,7 +158,7 @@ degradation: ../shared/capability-degradation.md
155
158
  - `source_type`: `user-original` | `external-capture` | `ai-derived`
156
159
  - UTR 可选 — Host 文件工具遵守同一契约
157
160
  - 保存设置协议:`writeback_mode: auto | confirm`
158
- - 锁定/定稿文件 → 修订副本(`文章 - 修订版.md`),不要原地自动改
161
+ - locked:auto 下可编辑(任务级首写快照);永久删 locked/core 仅用户
159
162
  - 本 pack 不要求 Desktop
160
163
  - **复合纪律(不改结构):** organize 把综合写回磁盘;write 先读可选 `topic.md`;memory 仅在明确确认后写;capture 从不改 `topic.md`;**不要**硬造 `INDEX.md` / 平行 wiki 树(见 `shared/project-model-brief.md`)
161
164
 
package/README.zh-CN.md CHANGED
@@ -1,4 +1,176 @@
1
- # topmind Skills(简体中文)
1
+ # topmind Skills
2
2
 
3
- 中文文档请直接看 **[README.md](./README.md)**。
4
- English: [README.en.md](./README.en.md) · Install & publish: [INSTALL.md](./INSTALL.md)
3
+ 可移植 AI 技能包:在 Claude Code / Codex / OpenCode / Hermes 等 Host 上使用同一套内容约定。
4
+
5
+ [简体中文](README.md) · [English](README.en.md) · [产品总览](https://github.com/topmindspace/topmind) · [安装与发布](./INSTALL.md) · [npm](https://www.npmjs.com/package/@topmindspace/topmind-skills)
6
+
7
+ ```bash
8
+ # 1) npm(推荐 · pack-aware · 含 shared/ · canonical .agents + 多智能体)
9
+ npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
10
+ # 只装给部分智能体
11
+ npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g -a claude-code -a mimocode
12
+ # 升级
13
+ npx @topmindspace/topmind-skills update -g
14
+
15
+ # 2) 社区 CLI(快速试用;不含 shared/ — 见 INSTALL.md)
16
+ npx skills add topmindspace/topmind-skills -g -y
17
+
18
+ # 3) Pack-aware 安装器(源码仓内)
19
+ npm run add -- topmindspace/topmind-skills -g
20
+ npm run update -- -g
21
+
22
+ # 4) 从 GitHub Release 装(离线/固定版本)
23
+ node bin/install-skills.mjs add release:latest -g
24
+
25
+ # 查看矩阵 / 修断链
26
+ node bin/install-skills.mjs agents
27
+ node bin/install-skills.mjs doctor --repair
28
+ ```
29
+
30
+ 安装模型:**canonical `.agents/skills` 一份真身** + 私有目录(Claude Code / MiMoCode…)相对软链;与 [`npx skills`](https://github.com/vercel-labs/skills) / `@topmindspace/tms-skills` 一致。详见 [INSTALL.md](./INSTALL.md)。
31
+
32
+ **版本与清单真源:** [`topmind-pack.json`](./topmind-pack.json)(`npm run versions`)。
33
+ 各 `SKILL.md` 的 `version` **必须**等于 pack 版本。
34
+
35
+ ---
36
+
37
+ ## 结构
38
+
39
+ ```text
40
+ topmind-skills/ # pack 根 = 仓库根
41
+ ├── topmind/ # 唯一日常入口(router)
42
+ ├── topmind-capture|organize|write|memory|maintain|loop/
43
+ ├── topmind-weread|x/ # 可选连接器
44
+ ├── topmind-ledger/ # 可选记账(记忆平面账本)
45
+ ├── topmind-wechat/ # 可选公众号 write 子技能(不是并列入口)
46
+ ├── shared/ # 写回回执 · 降级 · 自动建议 · 捕获 …
47
+ ├── install-targets/ # Host 安装形状(claude-code / codex / mimocode / …)
48
+ ├── evals/evals.json
49
+ ├── bin/install-skills.mjs # pack-aware + agent matrix 安装器
50
+ ├── scripts/build-pack.mjs
51
+ └── topmind-pack.json # 版本真源
52
+ ```
53
+
54
+ | 类型 | 模块 |
55
+ |------|------|
56
+ | **入口** | `topmind` only |
57
+ | **动作** | capture · organize · write · memory · maintain · loop |
58
+ | **连接器** | weread · x(可选) |
59
+ | **可选** | wechat(公众号 write 子技能)· ledger(记账 · 记忆平面账本) |
60
+
61
+ > 子 skill 触发词只服务 Host 路由,**不是**第二前台入口。
62
+
63
+ ---
64
+
65
+ ## 产品契约
66
+
67
+ ```text
68
+ User experience: capture-first
69
+ Data organization: category-first + topic-emerges
70
+ Content truth: topmind-workspace
71
+ Capability model: action-first
72
+ Save settings: auto | confirm
73
+ Safety model: reversible by default
74
+ Suggestions: L0 auto-land · L1 auto-prepare · L2 confirm-apply — shared/auto-suggest.md
75
+ ```
76
+
77
+ 日常入口只暴露 `topmind`。Host 会话状态不得成为 topmind 内容真源。
78
+ 本 pack **不要求 Desktop**。**UTR 可选** — 没有 UTR 时用 Host 文件工具。
79
+
80
+ 工作流:`收进来 -> 继续做 -> 交付/沉淀 -> 找回/调整`
81
+ (用户说「收一下」「记一下」「整理」「写成稿」「跑一遍 loop」— router 推断类别 / 专题 / 动作。)
82
+
83
+ **想记就记 / 随用随记**:捕获零提问落盘(L0);分类备选 / 待办 / 记忆候选默认 L1 准备——显式行动语待办在 auto 下同轮写入 `memory/todo.md`,其余建议点头再落([`shared/auto-suggest.md`](./shared/auto-suggest.md))。
84
+
85
+ ---
86
+
87
+ ## SKILL.md frontmatter
88
+
89
+ ```yaml
90
+ ---
91
+ name: <kebab-case-id> # required; matches directory name
92
+ version: <pack.version> # required; = topmind-pack.json version
93
+ description: >- # required; Use when + Do not use
94
+ …
95
+ action_category: capture # skill taxonomy (not user note category)
96
+ triggers: [...]
97
+ entrypoint: false # only topmind router is true
98
+ author: TopMindSpace
99
+ license: MIT
100
+ homepage: https://github.com/topmindspace/topmind-skills
101
+ degradation: ../shared/capability-degradation.md
102
+ ---
103
+ ```
104
+
105
+ 由 `tests/package-manifest.test.mjs` 强制校验。一个 pack JSON([`topmind-pack.json`](./topmind-pack.json)),无 per-skill 第二清单。
106
+
107
+ ---
108
+
109
+ ## 工作区契约
110
+
111
+ ```text
112
+ {workspace-root}/
113
+ ├── topmind.yaml # contract v4
114
+ ├── memory/ # profile.md · periodic/ · topics/ · todo.md · 可选 ledgers/
115
+ ├── .topmind/ # rebuildable machine state
116
+ ├── 00-Inbox/ # role: buffer (live dir name)
117
+ ├── 10-动态/ … # categories (template-driven)
118
+ ├── 88-交付/ or 88-Delivery/ # role: delivery
119
+ └── 99-归档/ or 99-Archive/ # role: system
120
+ ```
121
+
122
+ 专题:
123
+
124
+ ```text
125
+ {category}/{YYYY-theme}/
126
+ ├── topic.md # optional
127
+ ├── *.md # notes at topic root
128
+ └── images/ # optional
129
+ ```
130
+
131
+ 尚无专题时,散篇放在 `{category}/{note}.md`。
132
+
133
+ **不要创建(已废弃):** 默认 `outline.md` / `setting.md` / `style.md`;`project_type` frontmatter;专题内嵌套 `notes/` 或 `outputs/`;顶层 `projects/`;`YYYY-类型-项目名` 命名。
134
+
135
+ **类别:** 运行时发现 `{NN-Name}/` + `topmind.yaml` v4(`categories.extensions` / `categories.overrides` 含 `hidden`)。共享解析器:引擎 `lib/workspace-model.mjs`。优先按角色路由,不要写死 `10-` / `20-` 编号。
136
+
137
+ 不要硬编码绝对路径 — 从 Host 推断 `workspace_root`,或向用户询问。
138
+
139
+ ### 6 条核心规约
140
+
141
+ 1. **大类不重叠**
142
+ 2. **专题自然涌现**
143
+ 3. **动态类特殊**(默认平铺)
144
+ 4. **兜底类清理**(约 30 天)
145
+ 5. **参考资料定位**
146
+ 6. **大类命名稳定**(rename via migration)
147
+
148
+ 完整规则:[`shared/project-model-brief.md`](./shared/project-model-brief.md)。
149
+
150
+ ---
151
+
152
+ ## 行为规则
153
+
154
+ - 先捕获;不要因为分类不完美而挡住简单保存
155
+ - 信号足够强时自动路由;否则走 **role:buffer**(现场 Inbox 目录,不要只写死 `00-Inbox/`)
156
+ - 专题不清时,散篇放在大类根
157
+ - 每次写入返回回执(路径、路由原因、下一步)
158
+ - `source_type`: `user-original` | `external-capture` | `ai-derived`
159
+ - UTR 可选 — Host 文件工具遵守同一契约
160
+ - 保存设置协议:`writeback_mode: auto | confirm`
161
+ - locked:auto 下可编辑(任务级首写快照);永久删 locked/core 仅用户
162
+ - 本 pack 不要求 Desktop
163
+ - **复合纪律(不改结构):** organize 把综合写回磁盘;write 先读可选 `topic.md`;memory 仅在明确确认后写;capture 从不改 `topic.md`;**不要**硬造 `INDEX.md` / 平行 wiki 树(见 `shared/project-model-brief.md`)
164
+
165
+ ---
166
+
167
+ ## 安装目标
168
+
169
+ 已打包的 skill 目录(7 个核心 + 2 个可选连接器 + 可选记账 + 可选公众号 `topmind-wechat`)可以符号链接或复制到 Claude Code、Codex、OpenCode、Hermes 等。
170
+ 优先使用 npm / pack-aware 安装器,保证 `shared/` 与 `topmind-pack.json` 完整 — 见 [`INSTALL.md`](./INSTALL.md)。
171
+
172
+ ```bash
173
+ npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
174
+ ```
175
+
176
+ Host 适配器**不得**改变内容真源、新增并列日常入口,或把内容存进 agent 运行态。见 [`shared/capability-degradation.md`](./shared/capability-degradation.md)。
package/evals/evals.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "skill_name": "topmind",
3
3
  "daily_entry": "topmind",
4
- "version": "4.13.5",
4
+ "version": "4.14.0",
5
5
  "evals": [
6
6
  {
7
7
  "id": 1,
@@ -231,6 +231,27 @@
231
231
  "primary_skill": "topmind-ledger",
232
232
  "extra_skills": [],
233
233
  "expected_output": "Routes through topmind-ledger as 收入 into the default Personal/自己 book. Does not create ClassFund. Writes via writeback to memory/ledgers/."
234
+ },
235
+ {
236
+ "id": 32,
237
+ "prompt": "记一下:明天要交季度报告,别忘了附上数据表。",
238
+ "primary_skill": "topmind-capture",
239
+ "extra_skills": [],
240
+ "expected_output": "Capture-first: material lands in the stream period note (or topic/Inbox) with provenance + path receipt. Explicit action language also extracts todo item(s) into memory/todo.md (write under writeback auto, or one-word suggest under confirm) per shared/auto-suggest.md. Does not ask the user to choose category/todo/memory modules. Does not write profile.md."
241
+ },
242
+ {
243
+ "id": 33,
244
+ "prompt": "有什么要做的?",
245
+ "primary_skill": "topmind",
246
+ "extra_skills": [],
247
+ "expected_output": "Router reads memory/todo.md active checklist items (todo satellite, not a 6th concept) and lists them with paths. Does not invent a top-level todo/ directory, does not run organize, does not ask the user which skill to use."
248
+ },
249
+ {
250
+ "id": 34,
251
+ "prompt": "整理本周,顺便看看待办有没有要更新的。",
252
+ "primary_skill": "topmind-organize",
253
+ "extra_skills": [],
254
+ "expected_output": "Organize 整理本周 on the activity window: tidies the period note in place, then L1-suggests todo maintain diff (add/complete/update vs memory/todo.md) and optional memory/topic candidates per shared/auto-suggest.md. User accepts before writing todo/memory changes. No auto memory writes, no INDEX.md."
234
255
  }
235
256
  ]
236
257
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topmindspace/topmind-skills",
3
- "version": "4.13.5",
3
+ "version": "4.14.0",
4
4
  "description": "topmind Agent Skills pack — portable markdown skills for capture, organize, write, memory, maintain, loop.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -0,0 +1,120 @@
1
+ # Auto-Suggest Ladder(自动建议阶梯 · Skills 共享)
2
+
3
+ > 产品北极星:**记下来尽可能简单;系统默默准备建议;你点头后再沉淀;文件永远是你的。**
4
+ > 与 Desktop「自动准备建议(默认开)· 高影响确认后执行」同一语义。Host 无 Desktop 时由 Agent 自己扮演建议生成器。
5
+ > 真源对齐:`docs/ARCHITECTURE-RESET.md` §D · `PRODUCT-BOUNDARIES.md`。
6
+
7
+ 用户**不需要**知道内部模块名,也**不需要**在落盘前做分类/记忆/待办的多选题。Agent 默认走阶梯,只在 L2 停下来问一句。
8
+
9
+ ## 三级阶梯
10
+
11
+ ```text
12
+ L0 自动(无询问,直接做)
13
+ 路由落盘 + 路径回执 · frontmatter/provenance · 周期本 append
14
+ —— 「想记就记 / 随用随记」的主路径
15
+
16
+ L1 自动准备建议(默认生成并展示;一键接受;不静默写)
17
+ 分类备选 · 待办提取 · 记忆候选 · 专题升级 · 整理本周下一步
18
+ —— 「自动分类或分类建议 / 提取 todo / 记忆机制」的主路径
19
+
20
+ L2 确认后执行(高影响;一句话确认即可)
21
+ 写 memory/profile.md 或 memory/topics/ · 创建/合并专题
22
+ 删除/归档(confirm 模式)· 批量改待办状态 · 永久删
23
+ ```
24
+
25
+ **纪律**:
26
+
27
+ 1. L1 **只是建议卡片/回执附言**,不改内容真源;用户说「好 / 记上 / 移过去」即接受。
28
+ 2. L2 **不问细节**,只问「要不要写」;接受后一次做完并给路径回执。
29
+ 3. **禁止**为了「更智能」把 L2 静默升成 L0。**禁止**把 L1 做成一长串选择题。
30
+ 4. 子 skill **不**自动 dispatch 下一 skill;L1 的「下一步」是用户面建议,不是链式调用。
31
+ 5. 建议输出语言:用户本轮要求 → 宿主 UI → 工作区 locale(见 [`output-language.md`](./output-language.md))。
32
+
33
+ ## L1 建议类型(按触发)
34
+
35
+ | 建议 | 何时准备 | 接受后写到 | 拒绝 |
36
+ |------|----------|------------|------|
37
+ | **分类备选** | capture 低信心类别 | 用户点名的大类 / 真实目录名 | 留在 Inbox |
38
+ | **待办提取** | 正文含行动语(要做/记得/别忘/截止/待办/todo/need to) | `memory/todo.md`(语义平面卫星) | 只留周期本原文 |
39
+ | **记忆候选** | 稳定个人信息(偏好/目标/关系/进行中/周期洞察) | `memory/profile.md` 或 `memory/periodic/` | 不写 memory |
40
+ | **专题升级** | 同主题反复出现(≥2 次)且尚无专题 | 内容大类 `{YYYY-主题}/` | 流水永远只是流水 |
41
+ | **整理下一步** | capture 完成 / 周期本变脏 | 用户说「整理」再走 organize | 无 |
42
+
43
+ ### 待办提取细则(todo satellite)
44
+
45
+ `memory/todo.md` 是**语义平面卫星**(与 `todo-engine` 同契约),**不是**第 6 个用户概念。用户话术仍是「记一下 / 待办」。
46
+
47
+ ```text
48
+ 显式行动语(「记一下要做 X」「别忘了 X」「待办:X」)
49
+ → L0:材料照常落盘
50
+ → L0/L1:同轮把 X 写入 memory/todo.md(writeback auto 可直接写 + 回执;
51
+ confirm 则建议后写)。语义重复按文本去重。
52
+
53
+ 隐含行动语(「周三截止」「下周要交」)
54
+ → L1:建议提取 1–N 条,用户点头再写
55
+
56
+ 「有什么要做的 / 待办 / todo list」
57
+ → 读 memory/todo.md 活跃项;不新建概念
58
+
59
+ 「X 做完了 / 这条不用了」
60
+ → 勾掉/归档对应 todo(可恢复);同时可在周期本留一行状态(organize 语义)
61
+ ```
62
+
63
+ Host 能力映射:
64
+
65
+ | 能力 | Desktop | UTR | 纯 Host Agent |
66
+ |------|---------|-----|---------------|
67
+ | 提取 | `add_todo` · `todo_maintain` | `memory.add-todo` | 读活动窗口 → 识别行动语 → 写 checklist |
68
+ | 维护 | `toggle_todo` · `maintainTodos` | `memory.toggle-todo` | 对照周期本与 todo.md 做 diff 建议 |
69
+ | 列表 | `list_todos` · Todo 面板 | `memory.list-todos` | 读 `memory/todo.md` 活跃段 |
70
+ | 分类/专题建议 | `topic_classify`(确认后 `create_topic`) | 文件工具 + role 路由 | 按 role + 内容性质给最多 3 候选 |
71
+ | 记忆建议 | `memory_organize`(append/update/retire 建议) | `memory.append-profile` 等(确认后) | 识别稳定事实 → L1 候选 |
72
+
73
+ 写入格式:markdown checklist(`- [ ]` / `- [x]`),可带截止日期;保持简单可编辑。详见引擎 `lib/todo-engine.mjs`。
74
+
75
+ ### 分类备选细则
76
+
77
+ 高信心 → 直接落盘(L0)。低信心 → 仍落 **role:buffer**(L0 不丢数据),回执附 L1:
78
+
79
+ ```text
80
+ 已收进 Inbox。更像是:① 20-研究 ② 10-动态 —— 说「移到研究」即可。
81
+ ```
82
+
83
+ **不要**弹出多选表单;最多 3 个候选,按角色 + 内容性质排序。
84
+
85
+ ### 记忆候选细则
86
+
87
+ - **写**仍属 L2(须用户确认或明说「记住 / 更新我的情况」)。
88
+ - **准备**属 L1:capture / organize / 整理本周 之后,识别稳定事实就附一句候选。
89
+ - 禁止因剪藏/导入自动改 `memory/profile.md` 或 `memory/topics/`(见 [`trigger-disambiguation.md`](./trigger-disambiguation.md))。
90
+
91
+ ## 回执中的建议(统一形状)
92
+
93
+ ```text
94
+ 已记到:10-动态 → 本周动态
95
+ 位置:10-动态/2026/2026-W39.md
96
+ ——
97
+ 顺手建议(说一声即可):
98
+ · 待办:周三前交报告 → 记入清单?
99
+ · 更像 20-研究?可移过去
100
+ · 「换工作了」可进「我的情况」
101
+ ```
102
+
103
+ 一条回执最多 3 条建议;超过的丢弃或留给 loop。建议可整体忽略,不影响 L0 结果。
104
+
105
+ ## 与保存设置
106
+
107
+ | writeback | L0 | L1 | L2 |
108
+ |-----------|----|----|-----|
109
+ | `auto` | 直接写 | **显式行动语的待办可直接写** + 回执;其余仍建议 | 仍须确认(memory / 删档 / 建专题) |
110
+ | `confirm` | 内容直接写(分级) | 全部建议后写 | 确认后写 |
111
+
112
+ 高影响(locked 覆盖、删/归档、永久删)永远走写闸,与本阶梯无关(见 [`writeback-receipt.md`](./writeback-receipt.md))。
113
+
114
+ ## 反模式
115
+
116
+ - 让用户先选「你要 capture 还是 organize 还是 memory?」
117
+ - 记一条笔记弹出分类树 / 标签多选 / 记忆层级选择
118
+ - 静默把整段聊天写进 profile
119
+ - 为提取待办再造一个顶层 `todo/` 目录或第六概念
120
+ - L1 建议不给路径、不给一键接受话术
@@ -30,6 +30,7 @@ Level 3(最低): 仅对话
30
30
  | 看专题 | 列出类别下专题目录 + 根层单篇 `.md` |
31
31
  | 检视专题 | 读 `topic.md`(若有)+ 专题根 `.md` |
32
32
  | 捕获 | 写带 frontmatter 的 `.md` 到专题根 / 大类根 / role:buffer |
33
+ | 待办 | 读写 `memory/todo.md` checklist(卫星);从周期本/活动窗口识别行动语提取 |
33
34
  | 交付 | 写到 role:delivery(常为 `88-交付/`) |
34
35
  | 追加记忆 | 默认 `memory/profile.md`(主)或 `memory/periodic/{YYYY}/`(周期反思);**开专题**写内容大类 `{YYYY-主题}/`;仅用户明说才写 `memory/topics/{slug}.md` |
35
36
  | 健康检查 | 遍历结构、报告缺失 / 垃圾;自定义类合法 |
@@ -43,9 +44,10 @@ Level 3(最低): 仅对话
43
44
  |------|------|
44
45
  | 类别 / 专题 | `list-categories`(WorkspaceModel Descriptor)· `list-topics` · `inspect-topic` · `list-topic-files` · `list-inbox` |
45
46
  | 捕获 / 创建 | `create-topic` · `capture-note` · `save-output` |
46
- | 记忆 | `memory.append-profile` · `memory.append-topic` · `memory.promote` · `memory.digest` |
47
+ | 待办 | `memory.list-todos` · `memory.add-todo` · `memory.toggle-todo` |
48
+ | 记忆 | `memory.append-profile` · `memory.append-topic` · `memory.promote` · `memory.digest` · `memory.retire-profile` · `memory.update-profile` · `memory.compact-history` · `memory.restore-profile` |
47
49
  | Inbox 路由 | `plan-inbox-routing`(primary;整理 inbox 前规划) |
48
- | 检查 / 维护 | `doctor-workspace` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt` · `contract.reseed` |
50
+ | 检查 / 维护 | `doctor-workspace` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt` · `contract.validate` · `contract.reseed` |
49
51
 
50
52
  扩展面见 `TOOLS.md` §Current Command Surface。输入用独立字段 `category` + `topic`。
51
53
 
@@ -9,7 +9,7 @@
9
9
  ## 分层策略
10
10
 
11
11
  ```text
12
- L1 静态 HTTP fetch + Readability / 启发式 ← 默认
12
+ L1 静态 HTTP fetch + Readability / 启发式 / GitHub raw ← 默认
13
13
  L2 Desktop 增强渲染(隐藏 Chromium offscreen) ← SPA 空壳 / 「增强渲染」
14
14
  L3 用户粘贴 / 浏览器复制 ← 永远可用
15
15
  L3+ 浏览器扩展 → Bridge 和/或 工作区直写 ← 推荐日常剪藏
@@ -18,20 +18,42 @@ L3+ 浏览器扩展 → Bridge 和/或 工作区直写 ← 推荐日常
18
18
  | 层 | 入口 | 说明 |
19
19
  |----|------|------|
20
20
  | L1 | `fetchUrl({ url })` | `@mozilla/readability` + `html-to-markdown`;无第二窗口 |
21
+ | L1-GH | 同上,GitHub md/README | `lib/github-md.mjs`:blob/raw 直取 raw + 相对图改写;仓库根/tree 解析 README |
21
22
  | L2 | `fetchUrl({ url, render: true })` | `fetch-render.mjs` + ephemeral 窗(不占 Dock) |
22
23
  | L3 | 手动 | 失败回退 |
23
24
  | L3+ | Extension | 页内 Readability + **预览 / 选区 / 高亮 / 模板 / 落点**;**Bridge**(高质量 MD + 图片本地化 + destinations)或 **工作区目录**(FS Access,无 Desktop)。见 ADR · `browser-extension/` · `docs/capture-clip-matrix.md` |
24
25
 
25
- **复用原则**:扩展负责活 DOM 正文与高亮;Bridge 与工作区直写共用 Desktop `html-to-markdown` 与同一 frontmatter 规约。Bridge 另走落点 API 与写闸;工作区直写是用户手势确认的 companion 路径。落点:Inbox / 类别 / 专题(Bridge 在线时 popup 可选)。
26
+ **复用原则**:扩展负责活 DOM 正文与高亮;Bridge 与工作区直写共用 Desktop `html-to-markdown` 与同一 frontmatter 规约。GitHub URL 语义(解析 / raw / 图片改写)单源在 Kernel `lib/github-md.mjs`,不维护第二套。Bridge 另走落点 API 与写闸;工作区直写是用户手势确认的 companion 路径。落点:Inbox / 类别 / 专题(Bridge 在线时 popup 可选)。
26
27
 
27
28
  Agent host 无 Electron 时停在 L1/L3;扩展 **不强制** Desktop 在线(可配置工作区直写)。
28
29
 
30
+ ## GitHub 专用路径
31
+
32
+ | 输入 | 行为 | `fetch_method` |
33
+ |------|------|----------------|
34
+ | `github.com/.../blob\|raw/<ref>/<path>.md` | 直取 `raw.githubusercontent.com` | `github-raw` |
35
+ | `raw.githubusercontent.com/.../<path>.md` | 直取并改写相对图 | `github-raw` |
36
+ | `github.com/<owner>/<repo>` · `.../tree/<ref>[/subdir]` | README 解析(API `/readme`,失败 raw 探测) | `github-readme` |
37
+ | 其他 GitHub 页(issues / pulls…) | 按普通网页提取 | `readability` / `heuristic` |
38
+
39
+ 相对图片路径改写为 `raw.githubusercontent.com/...`,避免笔记内裂图。标题优先 H1,否则文件名。
40
+
41
+ ## URL 类型提示(UI)
42
+
43
+ 粘贴 / 输入 URL 时提示将抓取什么(不弹多选):
44
+
45
+ - GitHub Markdown 文件 · 将抓取原文
46
+ - GitHub 仓库 · 将抓取 README
47
+ - X 动态 / X 文章 · 将按网页提取
48
+ - 网页 · 将提取正文
49
+
29
50
  ## 长度与截断
30
51
 
31
52
  | 模式 | 上限 |
32
53
  |------|------|
33
54
  | 默认 | 40k 字符 |
34
55
  | 完整抓取 | 200k 字符 |
56
+ | GitHub raw/README | 400KB 字节(与 raw 文件上限一致) |
35
57
 
36
58
  **必须**在 UI 或 frontmatter 标明:截断、约字数、提取方法、清洗后 URL。用户不可见截断 = 产品缺陷。
37
59
 
@@ -41,7 +63,7 @@ Agent host 无 Electron 时停在 L1/L3;扩展 **不强制** Desktop 在线(
41
63
  source_type: external-capture
42
64
  source: https://example.com/article
43
65
  captured_at: 2026-07-13T12:00:00+08:00
44
- fetch_method: readability # readability | heuristic | render | selection | manual
66
+ fetch_method: readability # readability | heuristic | render | github-raw | github-readme | selection | manual
45
67
  fetch_truncated: false
46
68
  word_count: 1200
47
69
  ```
@@ -49,8 +71,9 @@ word_count: 1200
49
71
  ## Desktop UX
50
72
 
51
73
  - QuickCapture:截断 → 完整抓取;SPA → 增强渲染;保存后打开落盘路径
74
+ - URL 类型提示(GitHub README / GitHub 原文 / X / 网页)
52
75
  - Inbox:按 `source_type` 筛选「网页/摘录」
53
- - AI `fetch_url` 支持 `maxLen` + `render`
76
+ - AI `fetch_url` 支持 `maxLen` + `render`;Obsidian `fetch_url` 对 GitHub md 自动走 raw
54
77
 
55
78
  ## 不要做的事
56
79
 
@@ -58,3 +81,4 @@ word_count: 1200
58
81
  - 不静默丢弃后半篇
59
82
  - 不把抓取失败写成「已成功 capture」
60
83
  - 不用常驻第二 BrowserWindow 占 Dock(仅 ephemeral 隐藏窗)
84
+ - 不对 GitHub md 再走 HTML scrape(raw 更干净)
@@ -82,10 +82,10 @@ memory:
82
82
 
83
83
  | 动作 | 纪律 |
84
84
  |------|------|
85
- | organize | 整理/总结默认落盘专题根笔记(按 writeback);不只回话;可建议 memory 候选,不自动写 topic.md |
85
+ | organize | 整理/总结默认落盘专题根笔记(按 writeback);不只回话;L1 建议 memory/todo/专题候选,不自动写 topic.md |
86
86
  | write | 有 `topic.md` 先读再写;无则不强制创建 |
87
- | memory | 仅用户明确沉淀;禁止 capture 自动改 memory/topics/ |
88
- | capture | 只写材料笔记;不改 topic.md、不自动链式 |
87
+ | memory | 写入仅用户明确沉淀(L2);L1 默认准备候选;禁止 capture 自动改 memory/topics/ |
88
+ | capture | 只写材料笔记;不改 topic.md、不自动链式;行动语 → `memory/todo.md`(显式可写,隐含建议) |
89
89
  | loop | 材料多而首页空时只**建议** organize/memory,不代写记忆/不建 INDEX |
90
90
 
91
91
  ## source_type
@@ -9,6 +9,9 @@
9
9
  |--------|--------------|------|
10
10
  | 总结要点 | organize vs memory | 默认 → `topmind-organize`。仅「更新我的情况 / 加到专题记忆 / 沉淀到记忆」→ memory |
11
11
  | 沉淀 | capture vs memory | 默认 → `topmind-capture`。仅「沉淀成稳定结论 / 更新我的情况」→ memory |
12
+ | 记一下要做 X / 别忘了 X | capture vs todo | → `topmind-capture`(材料落盘)+ 待办写入/建议 `memory/todo.md`(见 `auto-suggest.md`) |
13
+ | 待办 / 有什么要做的 | router 直达 | 读 `memory/todo.md` 活跃项;不新建概念、不进 organize |
14
+ | X 做完了 / 这条不用了 | todo vs organize | 清单项 → 勾掉/归档 `memory/todo.md`;整周事项状态 → organize「整理本周」 |
12
15
  | 体检 / 检查 | maintain vs loop | 「快速体检 / 体检 / 检查 / doctor」→ maintain。「整体体检 / 全面检查 / 巡检 / audit / review」→ loop |
13
16
  | 审计 / audit | maintain vs loop | 默认 → loop。maintain 用 doctor / 诊断 / 快速体检 |
14
17
  | 整理 | organize | 「整理 inbox」→ organize + `plan-inbox-routing`。其它 → organize |
@@ -24,9 +27,10 @@
24
27
 
25
28
  | 动作 | 默认写什么 | 禁止 |
26
29
  |------|------------|------|
27
- | capture | 材料笔记 | 改 `topic.md`;自动 organize/memory |
28
- | organize | 专题根综合/结构笔记(留痕) | 自动写稳定记忆;建 `INDEX.md` / entities 树 |
30
+ | capture | 材料笔记;显式行动语可写/建议 `memory/todo.md` | 改 `topic.md`;自动 organize;静默写 memory/profile 或 memory/topics |
31
+ | organize | 专题根综合/结构笔记(留痕);L1 待办/记忆/专题建议 | 自动写稳定记忆;建 `INDEX.md` / entities 树 |
29
32
  | memory | 仅 confirmed stable → `memory/profile.md` 或 `memory/periodic/`(用户明说才写 `memory/topics/`) | 因 capture/整理顺手刷写;把 `topic.md` 当记忆默认落点 |
33
+ | todo(卫星) | `memory/todo.md` checklist | 新建顶层 `todo/`;当第六用户概念 |
30
34
  | write | 稿件 / delivery | 为「补结构」空建 `topic.md` |
31
35
  | loop | 状态 / 可逆修复 | 代写记忆;建硬索引 |
32
36
  | ledger | `{memory.dir}/ledgers/` 追加一行 | 改 `topic.md`;发明 ClassFund/Giggs/Mom;当第六用户概念 |
package/skills.md CHANGED
@@ -32,6 +32,7 @@
32
32
  2. **渐进式披露 (Progressive Disclosure)**:Discovery (`name+description`) → Activation (`SKILL.md`) → Deep Procedures (`shared/` / `references/`)。
33
33
  3. **文件系统即真源**:不引入独立的数据库或 Agent state 依赖。
34
34
  4. **遵从 6 条核心规约**:见 [`shared/project-model-brief.md`](./shared/project-model-brief.md)。
35
+ 5. **自动建议阶梯**:L0 零提问落盘 · L1 默认准备建议(分类/待办/记忆/专题)· L2 确认后写。见 [`shared/auto-suggest.md`](./shared/auto-suggest.md)。待办是 `memory/todo.md` 卫星,不是第六概念。
35
36
 
36
37
  👉 **详细架构、Frontmatter Schema 与安装方法请参阅**:
37
38
  - [Skills README](./README.md)(简体中文) · [English](./README.en.md)
package/topmind/SKILL.md CHANGED
@@ -1,15 +1,20 @@
1
1
  ---
2
2
  name: topmind
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
- topmind 总入口与多意图路由(类别/专题/笔记/交付)。Use when 用户说 topmind、意图模糊、或需要
6
- 收→整→写 分步。单意图明确时直接用 topmind-capture|organize|write|memory|maintain|loop|weread|x|ledger|wechat。
5
+ topmind 总入口与多意图路由(类别/专题/笔记/待办/交付)。Use when 用户说 topmind、意图模糊、
6
+ 待办/有什么要做的/todo list、或需要收→整→写 分步。单意图明确时直接用 topmind-capture|organize|write|memory|maintain|loop|weread|x|ledger|wechat。
7
7
  Do NOT invent parallel front doors; do NOT skip a matching sub-skill.
8
8
  action_category: router
9
9
  triggers:
10
10
  - topmind
11
11
  - 知识库
12
12
  - 工作区
13
+ - 待办
14
+ - 有什么要做的
15
+ - 要做的事
16
+ - todo
17
+ - todo list
13
18
  tags: [router, entrypoint, topmind]
14
19
  entrypoint: true
15
20
  compatibility: >-
@@ -18,7 +23,7 @@ compatibility: >-
18
23
  author: TopMindSpace
19
24
  license: MIT
20
25
  homepage: https://github.com/topmindspace/topmind
21
- updated: 2026-09-22
26
+ updated: 2026-09-28
22
27
  degradation: ../shared/capability-degradation.md
23
28
  ---
24
29
 
@@ -33,7 +38,7 @@ degradation: ../shared/capability-degradation.md
33
38
  3. 读 `topmind.yaml`(contract_version **4**)若存在
34
39
  4. 推断:**category · topic · object · action · writeback_mode**(auto|confirm)
35
40
  5. 派生子 skill 语义(逻辑路由;不假装进程内调用 API)
36
- 6. 回执含路径;**不**自动链式下一 skill;记忆/提升类建议须用户确认
41
+ 6. 回执含路径;**不**自动链式下一 skill;L1 建议默认准备、L2 须用户确认([`../shared/auto-suggest.md`](../shared/auto-suggest.md))
37
42
 
38
43
 
39
44
  ## Quick Reference
@@ -42,6 +47,9 @@ degradation: ../shared/capability-degradation.md
42
47
  用户说什么 → 路由到哪 → 目标位置
43
48
  ─────────────────────────────────────────────────────────────
44
49
  记/存/收/链接/想法 → topmind-capture → 动态周期本 / 专题 / Inbox
50
+ 记一下要做 X / 别忘了 X → topmind-capture → 材料落盘 + 待办写入/建议(memory/todo.md)
51
+ 待办 / 有什么要做的/todo → 本 router → 读 memory/todo.md 活跃项(卫星,非新概念)
52
+ X 做完了 / 这条不用了 → 本 router → 勾掉/归档对应待办(可恢复)
45
53
  整理本周/理顺流水 → topmind-organize → 活动窗口就地理顺 + 建议(确认后写)
46
54
  整理/分析/研究/总结/对比 → topmind-organize → 当前专题 / Inbox 路由 / 活动窗口
47
55
  写/改/稿/交付/导出 → topmind-write → delivery 或专题根
@@ -59,6 +67,8 @@ loop/整体体检/巡检 → topmind-loop → .topmind/loop/ 可恢
59
67
  不确定 / 多意图 → 本 router 拆步 → 先 capture 再建议
60
68
  ```
61
69
 
70
+ 待办是 `memory/todo.md` **卫星**(与 profile 同层),不是第六概念。提取/维护语义见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)。
71
+
62
72
  English: capture → capture · weekly review/organize (activity window) → organize · write → write · about me → memory/profile · period reflection → memory/periodic/{YYYY}/ · new topic folder → organize (content category) · doctor → maintain · loop → loop · bookkeeping/spent/deposited → ledger (`memory/ledgers/`, personal default).
63
73
 
64
74
  读配置:`stream.packing`(默认 weekly)· `stream.year_dir`(默认 true)· `memory.layers.global.file`(`profile.md`)。
@@ -92,8 +102,9 @@ Which category? Which topic (or loose note)? Which object? Which action? Which s
92
102
  - 高信心类别+专题 → `{大类}/{专题}/`
93
103
  - 高信心类别、中信心专题 → 写入专题 + 回执 `route_reason`
94
104
  - 高信心类别、无专题 → `{大类}/*.md`,建议是否升级专题
95
- - 低信心类别 → **role:buffer**(常为 `00-Inbox/`)
105
+ - 低信心类别 → **role:buffer**(常为 `00-Inbox/`)+ L1 分类备选(最多 3)
96
106
  - 跳过 `hidden` 类别
107
+ - 行动语 / 稳定个人信息 → L1 待办提取、记忆候选(不打断落盘)
97
108
 
98
109
  ### Minimum Context
99
110
 
@@ -121,23 +132,23 @@ Connector:[`references/connector-resolution.md`](references/connector-resoluti
121
132
  - 子 skill **不得**自动 dispatch 下一 skill
122
133
  - 下一步由 Router 再裁决或用户显式发起
123
134
  - 例外:回执可**建议**「稍后 organize / loop」——仅用户面
135
+ - L1 建议(待办 / 记忆 / 分类 / 专题)同样只挂在回执上,不是链式调用
124
136
 
125
137
  ## Tool Boundary
126
138
 
127
139
  主路径:host 文件工具 + project-model-brief。Skills pack **不依赖** Pi / `pi-agent-core`;不要编造 bash / shell。宿主若有唯一片段替换,中段改稿优先用它。
128
140
  降级:[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。
129
141
 
130
- UTR 可选(MCP primary+danger 共 23;注册表 32 = 8 域 / 32 命令,见 TOOLS.md):`list-categories` · `list-topics` · `inspect-topic` · `list-topic-files` · `list-inbox` · `create-topic` · `capture-note` · `save-output` · `contract.validate` · `contract.reseed` · `memory.promote` · `memory.digest` · `memory.append-profile` · `memory.append-topic` · `memory.retire-profile` · `memory.update-profile` · `memory.compact-history` · `memory.restore-profile` · `doctor-workspace` · `plan-inbox-routing` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt`。
142
+ UTR 可选(MCP primary+danger 共 26;注册表 35 = 8 域 / 35 命令,见 TOOLS.md):`list-categories` · `list-topics` · `inspect-topic` · `list-topic-files` · `list-inbox` · `create-topic` · `capture-note` · `save-output` · `contract.validate` · `contract.reseed` · `memory.promote` · `memory.digest` · `memory.append-profile` · `memory.append-topic` · `memory.retire-profile` · `memory.update-profile` · `memory.compact-history` · `memory.restore-profile` · `memory.list-todos` · `memory.add-todo` · `memory.toggle-todo` · `doctor-workspace` · `plan-inbox-routing` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt`。
131
143
 
132
144
  字段始终独立 **`category` + `topic`**(真实目录名,非写死编号)。
133
145
 
134
146
  ## 保存设置
135
147
 
136
- - **auto**:直接写 + 路径回执(危险动作可逆)
137
- - **confirm**:先审阅再写
148
+ - **自动保存 (auto)**:直接写 + 路径回执(危险动作可逆)
149
+ - **需要审阅 (confirm)**:分级——内容直接落盘;仅删/归档待确认
150
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
138
151
 
139
- 详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
140
- **6 条核心规约**:见 [`../shared/project-model-brief.md`](../shared/project-model-brief.md)。
141
152
 
142
153
  ## Error Handling
143
154
 
@@ -6,8 +6,10 @@
6
6
  |---------|------|------|
7
7
  | capture + organize | 先 capture,回执中建议 organize | 先确保材料落地 |
8
8
  | capture + memory | 先 capture,回执中建议 memory | 先存笔记再更新我的情况 / 周期反思 |
9
+ | capture + todo | 先 capture;显式行动语同轮写 `memory/todo.md`,隐含则 L1 建议 | 见 `shared/auto-suggest.md` |
9
10
  | organize + write | 先 organize 提炼,再 write 输出 | 分两步 |
10
11
  | organize + memory | 先 organize 候选,再 memory 落盘 | organize 产出列表 |
12
+ | organize + todo | 整理本周后 L1 待办 diff 建议 | 不自动批量改清单 |
11
13
  | write + memory | 先 write,回执中建议 memory | 写作不改 memory/profile |
12
14
  | 整理 inbox | `topmind-organize` + `plan-inbox-routing` | 不是 maintain/loop |
13
15
  | 清理工作区 | `topmind-maintain` | 系统健康 |
@@ -1,8 +1,9 @@
1
1
  ---
2
2
  name: topmind-capture
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
- 把链接、摘录、随手记收进动态周期本、Inbox 或专题。Use when 记一下、收进、剪藏、保存链接、capture、save URL/idea。
5
+ 把链接、摘录、随手记收进动态周期本、Inbox 或专题;行动语自动提取/建议待办。Use when 记一下、收进、
6
+ 剪藏、保存链接、记一下要做/别忘了、capture、save URL/idea。
6
7
  Do NOT use for 整理本周、出稿、写我的情况、doctor/loop、微信读书、X.
7
8
  action_category: capture
8
9
  triggers:
@@ -23,6 +24,9 @@ triggers:
23
24
  - 笔记
24
25
  - 抄下来
25
26
  - 摘录
27
+ - 记一下要做
28
+ - 别忘了
29
+ - 要做
26
30
  - capture
27
31
  - note
28
32
  - save
@@ -32,13 +36,14 @@ compatibility: topmind workspace. Host file tools or optional UTR capture-note.
32
36
  author: TopMindSpace
33
37
  license: MIT
34
38
  homepage: https://github.com/topmindspace/topmind
35
- updated: 2026-08-15
39
+ updated: 2026-09-28
36
40
  degradation: ../shared/capability-degradation.md
37
41
  ---
38
42
 
39
43
  # topmind Capture
40
44
 
41
- 先存材料(用户动词:**记一下**)。不负责重塑、交付、诊断或外部连接。
45
+ 先存材料(用户动词:**记一下**)。不负责重塑、交付、诊断或外部连接。
46
+ **想记就记 / 随用随记**:默认零提问落盘;分类、待办、记忆一律走 [`../shared/auto-suggest.md`](../shared/auto-suggest.md) 的 L1 建议,不弹多选。
42
47
 
43
48
  ## Activation checklist
44
49
 
@@ -47,6 +52,7 @@ degradation: ../shared/capability-degradation.md
47
52
  3. 按内容性质选 **真实目录名**(role;禁止写死编号)
48
53
  4. **日常/动态** → 追加到当前周期本;专题明确 → 专题根;不清 → Inbox
49
54
  5. 写 frontmatter;白话回执(如「已记到每周一本」);**不**自动 organize/write
55
+ 6. **同轮 L1**:扫描行动语 / 稳定个人信息 / 低信心分类 → 回执附最多 3 条建议(见下)
50
56
 
51
57
  ## When NOT to use
52
58
 
@@ -84,6 +90,21 @@ low cat → role:buffer(Inbox)
84
90
 
85
91
  默认不访谈分类。存完可移动。禁止写死类名编号。用户只要「记一下」——不要解释 packing 术语(回执可用「本周动态」)。
86
92
 
93
+ **低信心时不要只丢 Inbox 就完事**:仍落 buffer,回执附分类备选(最多 3 个,真实目录名),如「更像 ① 20-研究 ② 10-动态,说一声即可移」。详见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)。
94
+
95
+ ### 待办与记忆(L1,不打断捕获)
96
+
97
+ 捕获正文只写材料;下列副作用走建议阶梯,**不**为分类/待办向用户提问:
98
+
99
+ | 信号 | L0 | L1 |
100
+ |------|----|----|
101
+ | 显式行动语(要做 / 记得 / 别忘 / 待办 / 截止 / todo) | 材料照常落盘 | 同轮提取到 `memory/todo.md`(auto 可直接写+回执;confirm 则建议) |
102
+ | 隐含行动语(「周三截止」「下周要交」) | 材料照常落盘 | 建议提取 1–N 条待办,点头再写 |
103
+ | 稳定个人信息(偏好 / 目标 / 进行中) | 材料照常落盘 | 建议进「我的情况」(写入仍须确认) |
104
+ | 低信心类别 | Inbox | 分类备选 |
105
+
106
+ 清单是语义平面卫星(`memory/todo.md`),**不是**新概念、**不**新建顶层 `todo/`。去重按文本;拒绝过的条目不要反复再提。
107
+
87
108
  UTR:`capture-note`(自动识别周期本)。Desktop:`ingestInbox` dest.mode=`stream`(默认)。
88
109
 
89
110
  ## Provenance
@@ -106,11 +127,12 @@ status: todo
106
127
  | 层 | 谁 | 能力 |
107
128
  |----|----|------|
108
129
  | L1 | Desktop `fetchUrl` / host fetch | Mozilla Readability + 启发式 |
130
+ | L1-GH | 同上 · GitHub md/README | raw 直取 + 相对图改写(`lib/github-md.mjs`) |
109
131
  | L2 | Desktop 增强渲染 | SPA 空壳(ephemeral Chromium) |
110
132
  | L3 | 手动粘贴 | 永远可用 |
111
133
  | L3+ | 浏览器扩展 Clip Bridge | 活 DOM Readability → Desktop 清洗落盘 |
112
134
 
113
- Agent host 能 fetch 则提取正文,否则保留 URL + 摘录;推荐日常剪藏走 L3+。
135
+ Agent host 能 fetch 则提取正文,否则保留 URL + 摘录;推荐日常剪藏走 L3+。GitHub 仓库 / Markdown 文件优先走 raw/README,不 HTML scrape。
114
136
 
115
137
  ### 本地文档 / Office / 邮件 / 统一捕获
116
138
 
@@ -127,12 +149,13 @@ Agent host 能 fetch 则提取正文,否则保留 URL + 摘录;推荐日常
127
149
  ## Workflow
128
150
 
129
151
  1. 按内容性质推断类别(动态发现),再推断专题
130
- 2. 类别不清 → Inbox
152
+ 2. 类别不清 → Inbox(+ 分类备选建议)
131
153
  3. 保留 provenance;长文标注截断
132
154
  4. 按保存设置写入(见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md))
133
155
  5. 回执:路径、目标、信心、下一步(不自动触发其他 skill)
156
+ 6. L1 建议:待办提取 / 记忆候选 / 分类备选(见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md))
134
157
 
135
- **边界**:只写材料笔记。**禁止**改 `topic.md`、禁止自动 organize/memory。存完可在回执建议「需要时整理」——仅用户面,不自动链式。
158
+ **边界**:只写材料笔记。**禁止**改 `topic.md`、禁止自动 organize、禁止静默写 memory/profile 或 memory/topics。存完可在回执**建议**「需要时整理 / 记入待办 / 更新我的情况」——仅用户面,不自动链式。
136
159
 
137
160
  「刚才收哪」:按 mtime 扫近期 `.md`(或 UTR `list-recent-captures` advanced)。
138
161
 
@@ -143,6 +166,6 @@ Agent host 能 fetch 则提取正文,否则保留 URL + 摘录;推荐日常
143
166
  ## 保存设置
144
167
 
145
168
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
146
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
147
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
169
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
170
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
148
171
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-ledger
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  通用记账到记忆平面(默认个人/自己账本,用户自建账本与分类)。Use when 记账、记一笔、花了、存入、查看账单、账户余额。
6
6
  Do NOT use for 记一下到动态、待办、微信读书、发推、Feishu/lark-cli.
@@ -82,5 +82,5 @@ Desktop 可选小应用(看板 / 流水 / 分类 / 快捷记账)。**如何
82
82
  ## 保存设置
83
83
 
84
84
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
85
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
86
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
85
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
86
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## Why Loop Exists
6
6
 
7
- UTR 提供 **8 域 / 32** 条确定性命令;`doctor-workspace` 做规则健康检查。Loop 在之上增加**语义层**:阅读 `topic.md` 与笔记、对照 skill 契约、再调用 UTR 修复。
7
+ UTR 提供 **8 域 / 35** 条确定性命令;`doctor-workspace` 做规则健康检查。Loop 在之上增加**语义层**:阅读 `topic.md` 与笔记、对照 skill 契约、再调用 UTR 修复。
8
8
 
9
9
  ## Design Choice — Skill + Agent + State File, Not CLI
10
10
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-loop
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  可中断的工作区语义巡检(走专题/Inbox,.loop 断点续跑)。Use when 跑一遍 loop、巡检、整体体检、复盘、
6
6
  继续 loop、audit。Do NOT use for 快速 doctor(→maintain)、单专题整理、捕获、写作、仅记忆.
@@ -104,8 +104,8 @@ Scopes、walk、guardrails 细节:[`references/scopes-and-walk.md`](references
104
104
  ## 保存设置
105
105
 
106
106
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
107
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
108
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
107
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
108
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
109
109
 
110
110
  Loop 写状态文件与可逆修复时同样适用;危险操作先备份。
111
111
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-maintain
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  确定性体检/清理/结构修复/回执恢复。Use when 快速体检、诊断、doctor、清理、修复、workspace check。
6
6
  Do NOT use for 整体巡检 loop、内容整理、捕获、写作、记忆.
@@ -99,6 +99,6 @@ degradation: ../shared/capability-degradation.md
99
99
  ## 保存设置
100
100
 
101
101
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
102
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
103
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
102
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
103
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
104
104
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-memory
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  更新「我的情况」或周期反思。Use when 记住这个、更新我的情况、加到专题记忆、沉淀结论。
6
6
  Do NOT use for 捕获、仅总结(→organize)、整理本周正文、出稿、开/并专题、doctor/loop.
@@ -23,7 +23,7 @@ compatibility: workspace core profile (memory/profile.md) + periodic reflections
23
23
  author: TopMindSpace
24
24
  license: MIT
25
25
  homepage: https://github.com/topmindspace/topmind
26
- updated: 2026-09-25
26
+ updated: 2026-09-28
27
27
  degradation: ../shared/capability-degradation.md
28
28
  ---
29
29
 
@@ -37,7 +37,8 @@ degradation: ../shared/capability-degradation.md
37
37
  | **周期子 memory** | `memory/periodic/{YYYY}/{period}.md` | 周期反思(stream_digest / ai_summary 确认后) |
38
38
 
39
39
  **建立/归入专题**(内容大类夹)→ **organize / topic_classify**,路径 `{大类}/{YYYY-主题}/topic.md`。
40
- **不是**默认写入 `memory/topics/`。
40
+ **不是**默认写入 `memory/topics/`。
41
+ **待办清单** → 卫星 `memory/todo.md`(UTR `memory.*-todo`;capture/organize 提取,见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md))。本 skill 不主写待办,只在周期反思里引用。
41
42
 
42
43
  | 用户意图 | 写哪里 |
43
44
  |----------|--------|
@@ -45,6 +46,7 @@ degradation: ../shared/capability-degradation.md
45
46
  | **周期反思** | `memory/periodic/{YYYY}/` |
46
47
  | **开/并专题**(长期主题夹) | 内容大类下专题(organize 建议 · 确认后 create_topic) |
47
48
  | 明确说「把结论写进专题记忆层」 | 可选 `memory/topics/{slug}.md`(语义平面 · **非默认**) |
49
+ | **记一下要做 X** | 材料 → capture;X → `memory/todo.md`(卫星) |
48
50
 
49
51
  ## Activation checklist
50
52
 
@@ -62,6 +64,7 @@ degradation: ../shared/capability-degradation.md
62
64
 
63
65
  ```text
64
66
  UTR: memory.append-profile · memory.update-profile · memory.retire-profile · memory.restore-profile · memory.compact-history
67
+ UTR todos(卫星): memory.list-todos · memory.add-todo · memory.toggle-todo
65
68
  Desktop: append_core_memory · update_core_memory · retire_core_memory · restore_core_memory · compact_core_memory_history
66
69
  Host: 读 profile(活跃段)→ ADD / UPDATE 原位 / RETIRE 到 ## 历史记录 / RESTORE 回活跃 / COMPACT-HISTORY → 写回
67
70
  ```
@@ -99,7 +102,8 @@ Host: 读 profile(活跃段)→ ADD / UPDATE 原位 / RETIRE 到 ## 历史
99
102
 
100
103
  - **禁止**因 capture / 剪藏 / 导入 自动改 profile 或 `memory/topics/`
101
104
  - **禁止**整理过程中顺手狂写(organize 只可**建议**候选;topic 建议进**内容大类**)
102
- - 仅用户明确「记住 / 更新我的情况 / 写进专题记忆」或当轮确认
105
+ - **写入**仅用户明确「记住 / 更新我的情况 / 写进专题记忆」或当轮确认(L2)
106
+ - **准备候选**是默认行为(L1):capture / organize 看到稳定事实就附建议,用户点头再写——不必让用户先学会说「记住」
103
107
 
104
108
  ## Role-aware density
105
109
 
@@ -110,10 +114,11 @@ Host: 读 profile(活跃段)→ ADD / UPDATE 原位 / RETIRE 到 ## 历史
110
114
  ## Capability Degradation
111
115
 
112
116
  [`../shared/capability-degradation.md`](../shared/capability-degradation.md)。
113
- `memory.append-profile` · `memory.append-topic` · `inspect-topic`。
117
+ `memory.append-profile` · `memory.append-topic` · `memory.list-todos` · `memory.add-todo` · `memory.toggle-todo` · `inspect-topic`。
114
118
 
115
119
  ## 保存设置
116
120
 
117
- - **自动保存 (auto)**:默认;写回执
118
- - **需要审阅 (confirm)**:先预览
119
- - 见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
121
+ - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
122
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
123
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
124
+
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-organize
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  整理本周动态、专题内整理/研究/分析/路由 Inbox。Use when 整理本周、整理、分析、研究、对比、总结要点、organize、summarize。
6
6
  Do NOT use for 首次捕获、最终出稿、仅写我的情况、快速 doctor、全库 loop.
@@ -37,7 +37,7 @@ compatibility: topmind workspace with stream period notes, topics, or Inbox.
37
37
  author: TopMindSpace
38
38
  license: MIT
39
39
  homepage: https://github.com/topmindspace/topmind
40
- updated: 2026-08-15
40
+ updated: 2026-09-28
41
41
  degradation: ../shared/capability-degradation.md
42
42
  ---
43
43
 
@@ -51,7 +51,7 @@ degradation: ../shared/capability-degradation.md
51
51
  2. 否则确认已有笔记 / Inbox(无材料则先 capture)
52
52
  3. `list-categories` / 读周期本或专题 `.md`
53
53
  4. 按 writeback 写回(默认 auto;整篇替换先备份)
54
- 5. 回执;不自动 memory(只建议候选)
54
+ 5. 回执;L1 建议待办/记忆/专题候选,不自动写 memory(见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md))
55
55
 
56
56
  ## When NOT to use
57
57
 
@@ -86,11 +86,14 @@ degradation: ../shared/capability-degradation.md
86
86
  - 合并同一事项状态(「要做 X」+「X 完成」→ 进行中列表更新)
87
87
  - 去重、整理 ## 进行中
88
88
  - 保留可读叙事;不要为分类而拆文件
89
- 3. 可选候选(列表请用户接受后再写):
89
+ 3. L1 候选(列表请用户接受后再写;见 ../shared/auto-suggest.md):
90
+ - **待办维护**:对照 memory/todo.md,新增/完成/更新(todo_maintain 语义)
90
91
  - 更新「我的情况」/ 周期反思 → memory skill(profile + periodic,不是专题)
91
92
  - 反复主题 → 建议在内容大类下开/并入专题(勿写 memory/topics;勿自动升专题)
92
93
  ```
93
94
 
95
+ **待办同步是整理本周的默认建议之一**(不是第六概念):周期本里「要做 / 完成了」与 `memory/todo.md` 对不上时,给出 diff 建议,点头后写。纯 Host 自行 diff;Desktop `todo_maintain`/`maintainTodos`;UTR `memory.list-todos`/`add-todo`/`toggle-todo`。
96
+
94
97
  **流水可以永远只是流水**——不升专题也完全健康。
95
98
  条目上的「增补」= 同文件续写(评论感),不是平行评论库。
96
99
 
@@ -101,7 +104,7 @@ degradation: ../shared/capability-degradation.md
101
104
 
102
105
  读专题材料 → 聚类提炼 → 结构化笔记或建议;克制整理,保留原始细节;识别可升 memory 的候选(不自动写 memory)。
103
106
 
104
- **整理留痕(复利,不改目录)**:用户要整理/总结/分析时,除对话回答外,**默认按 writeback 写回**专题根一篇 md(或更新已有综合笔记)。不要只回话不落盘。不建 `INDEX.md`、不建 entities/、不强制 topic.md。可升 memory 的条目只在回执里**建议**,用户说「记住」再走 memory。
107
+ **整理留痕(复利,不改目录)**:用户要整理/总结/分析时,除对话回答外,**默认按 writeback 写回**专题根一篇 md(或更新已有综合笔记)。不要只回话不落盘。不建 `INDEX.md`、不建 entities/、不强制 topic.md。可升 memory 的条目、可提取的待办只在回执里**建议**(L1),用户说「记住 / 记上」再落。
105
108
 
106
109
  ### 研究分析
107
110
 
@@ -139,6 +142,6 @@ degradation: ../shared/capability-degradation.md
139
142
  ## 保存设置
140
143
 
141
144
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
142
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
143
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
145
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
146
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
144
147
 
package/topmind-pack.json CHANGED
@@ -4,8 +4,8 @@
4
4
  "label": "topmind",
5
5
  "description": "topmind skill pack: single daily entry topmind + progressive disclosure (shared/ + references/), Agent Skills open-standard aligned, capture-first template-driven categories, optional connectors topmind-weread and topmind-x, optional topmind-ledger (记账), optional write sub-skill topmind-wechat. None of the optional skills is an extra user concept. File-system-first content truth; UTR optional.",
6
6
  "daily_entry": "topmind",
7
- "version": "4.13.5",
8
- "updated": "2026-09-25",
7
+ "version": "4.14.0",
8
+ "updated": "2026-09-28",
9
9
  "license": "MIT",
10
10
  "locales": {
11
11
  "default": "zh-CN",
@@ -379,7 +379,10 @@
379
379
  "retire-profile",
380
380
  "update-profile",
381
381
  "compact-history",
382
- "restore-profile"
382
+ "restore-profile",
383
+ "list-todos",
384
+ "add-todo",
385
+ "toggle-todo"
383
386
  ],
384
387
  "lifecycle": [
385
388
  "scan"
@@ -388,8 +391,8 @@
388
391
  "rebuild"
389
392
  ]
390
393
  },
391
- "command_count": 32,
392
- "mcp_default_count": 23,
394
+ "command_count": 35,
395
+ "mcp_default_count": 26,
393
396
  "command_exposure": {
394
397
  "primary": [
395
398
  "workspace-read.list-categories",
@@ -410,7 +413,10 @@
410
413
  "memory.retire-profile",
411
414
  "memory.update-profile",
412
415
  "memory.compact-history",
413
- "memory.restore-profile"
416
+ "memory.restore-profile",
417
+ "memory.list-todos",
418
+ "memory.add-todo",
419
+ "memory.toggle-todo"
414
420
  ],
415
421
  "danger": [
416
422
  "workspace-maintain.archive-topic",
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-wechat
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  公众号文章全生命周期子技能(write 族):交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
6
6
  支持 forward(底稿→公众号)、reverse(选题原创→回推)、站外拉取(在线精选站→reverse+pending)三条路径;
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-weread
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  同步微信读书划线/想法/统计到专题。Use when 微信读书、划线同步、weread、读书笔记。
6
6
  Do NOT use for 普通 URL 捕获、仅整理、出稿、X.
@@ -92,6 +92,6 @@ RPC:`weread.getStatus` · `testConnection` · `listNotebooks` · `syncHighligh
92
92
  ## 保存设置
93
93
 
94
94
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
95
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
96
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
95
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
96
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
97
97
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-write
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  写作/润色/出稿到专题或交付层(role:delivery)。Use when 写、起草、续写、润色、出稿、交付、write、draft、deliver。
6
6
  Do NOT use for 仅捕获、仅结构整理、只写记忆、doctor/loop、社交连接器.
@@ -32,7 +32,7 @@ compatibility: topmind workspace. Delivery role category (often 88-交付 / 88-D
32
32
  author: TopMindSpace
33
33
  license: MIT
34
34
  homepage: https://github.com/topmindspace/topmind
35
- updated: 2026-09-22
35
+ updated: 2026-09-28
36
36
  degradation: ../shared/capability-degradation.md
37
37
  ---
38
38
 
@@ -46,6 +46,7 @@ degradation: ../shared/capability-degradation.md
46
46
  2. 起草或修订;去 AI 腔 / 适配格式
47
47
  3. 落盘专题根或 `save-output` → delivery
48
48
  4. 路径回执;交付勿塞进专题内 `outputs/`
49
+ 5. 可选 L1:稿件里稳定结论/待办可在回执建议(不自动写 memory/todo)— [`../shared/auto-suggest.md`](../shared/auto-suggest.md)
49
50
 
50
51
  ## When NOT to use
51
52
 
@@ -111,6 +112,6 @@ Draft · Continue · Revise · Polish · Deliver — 按用户当前意图,不
111
112
  ## 保存设置
112
113
 
113
114
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
114
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
115
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
115
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
116
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
116
117
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: topmind-x
3
- version: 4.13.5
3
+ version: 4.14.0
4
4
  description: >-
5
5
  X/Twitter:归档/搜索(Bearer)、发帖(xurl)、Agent 可用官方 MCP。Use when 发推、推特、twitter、x.com。
6
6
  Do NOT use for 微信读书、非 X 捕获、doctor、长文交付.
@@ -90,8 +90,8 @@ Bearer 加密存储;不自动关注/点赞/转发;遵守 X API 规则。
90
90
  ## 保存设置
91
91
 
92
92
  - **自动保存 (auto)**:直接写入并返回路径回执(path receipt)
93
- - **需要审阅 (confirm)**:先进入目标路径/内容审阅入口再保存
94
- - Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
93
+ - **需要审阅 (confirm)**:分级——内容新建/更新/编辑直接落盘;仅删除/归档待确认
94
+ - `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
95
95
 
96
96
  发布动作始终二次确认(即使 auto)。
97
97