@topmindspace/topmind-skills 4.15.4 → 4.15.6

package/README.zh-CN.md

@@ -1,180 +1,3 @@
-# topmind Skills
+# topmind-skills
 
-可移植 AI 技能包：在 Claude Code / Codex / OpenCode / Hermes 等 Host 上使用同一套内容约定。
-
-[简体中文](README.md) · [English](README.en.md) · [产品总览](https://github.com/topmindspace/topmind) · [安装与发布](./INSTALL.md) · [npm](https://www.npmjs.com/package/@topmindspace/topmind-skills)
-
-```bash
-# 1) npm（推荐 · pack-aware · 含 shared/ · canonical .agents + 多智能体）
-npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
-# 只装给部分智能体
-npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g -a claude-code -a mimocode
-# 升级
-npx @topmindspace/topmind-skills update -g
-
-# 2) 社区 CLI（快速试用；不含 shared/ — 见 INSTALL.md）
-npx skills add topmindspace/topmind-skills -g -y
-
-# 3) Pack-aware 安装器（源码仓内）
-npm run add -- topmindspace/topmind-skills -g
-npm run update -- -g
-
-# 4) 从 GitHub Release 装（离线/固定版本）
-node bin/install-skills.mjs add release:latest -g
-
-# 查看矩阵 / 修断链
-node bin/install-skills.mjs agents
-node bin/install-skills.mjs doctor --repair
-```
-
-安装模型：**canonical `.agents/skills` 一份真身** + 私有目录（Claude Code / MiMoCode…）相对软链；与 [`npx skills`](https://github.com/vercel-labs/skills) 一致。详见 [INSTALL.md](./INSTALL.md)。
-
-**版本与清单真源：** [`topmind-pack.json`](./topmind-pack.json)（`npm run versions`）。  
-各 `SKILL.md` 的 `metadata.version` **必须**等于 pack 版本。
-
----
-
-## 结构
-
-```text
-topmind-skills/              # pack 根 = 仓库根
-├── topmind/                 # 唯一日常入口（router）
-├── topmind-capture|organize|write|memory|maintain|loop/
-├── topmind-weread|x/        # 可选连接器
-├── topmind-ledger/          # 可选记账（记忆平面账本）
-├── shared/                  # 写回回执 · 降级 · 自动建议 · 捕获 …
-├── install-targets/         # Host 安装形状（claude-code / codex / mimocode / …）
-├── evals/evals.json
-├── bin/install-skills.mjs   # pack-aware + agent matrix 安装器
-├── scripts/build-pack.mjs
-└── topmind-pack.json        # 版本真源
-```
-
-| 类型 | 模块 |
-|------|------|
-| **入口** | `topmind` only |
-| **动作** | capture · organize · write · memory · maintain · loop |
-| **连接器** | weread · x（可选） |
-| **可选** | ledger（记账 · 记忆平面账本） |
-| **外部可选（不随包）** | 公众号 `topmind-wechat-post` 等写作技能（topmind-writing-skills）· `topmind-research` · `topmind-presentation` · `topmind-handoff`；路由见 `shared/trigger-disambiguation.md` |
-
-> 子 skill 触发词只服务 Host 路由，**不是**第二前台入口。
-
----
-
-## 产品契约
-
-```text
-User experience:     capture-first
-Data organization:   category-first + topic-emerges
-Content truth:       topmind-workspace
-Capability model:    action-first
-Save settings:       auto | confirm
-Safety model:        reversible by default
-Suggestions:         L0 auto-land · L1 auto-prepare · L2 confirm-apply — shared/auto-suggest.md
-```
-
-日常入口只暴露 `topmind`。Host 会话状态不得成为 topmind 内容真源。  
-本 pack **不要求 Desktop**。**UTR 可选** — 没有 UTR 时用 Host 文件工具。
-
-工作流：`收进来 -> 继续做 -> 交付/沉淀 -> 找回/调整`  
-（用户说「收一下」「记一下」「整理」「写成稿」「跑一遍 loop」— router 推断类别 / 专题 / 动作。）
-
-**想记就记 / 随用随记**：捕获零提问落盘（L0）；分类备选 / 待办 / 记忆候选默认 L1 准备——显式行动语待办在 auto 下同轮写入 `memory/todo.md`，其余建议点头再落（[`shared/auto-suggest.md`](./shared/auto-suggest.md)）。
-
----
-
-## SKILL.md frontmatter
-
-```yaml
----
-name: <kebab-case-id>           # 必填；与目录名一致
-description: >-                  # 必填；做什么 + Use when + Do NOT use
-  …
-license: MIT
-compatibility: …                # 可选；运行环境说明（≤500 字符）
-metadata:                       # Agent Skills 规范：自定义字段一律放这里，值为字符串
-  version: "<pack.version>"     # 必填；= topmind-pack.json version
-  action_category: "capture"    # skill 分类（不是用户笔记的 category）
-  entrypoint: "false"           # 只有 topmind router 是 "true"
-  triggers: "记一下, 收进, capture"   # 逗号分隔
-  tags: "capture, inbox"
-  author: "TopMindSpace"
-  homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "YYYY-MM-DD"
-  degradation: "../shared/capability-degradation.md"
----
-```
-
-顶层只允许 `name / description / license / compatibility / metadata / allowed-tools`，CI 用官方校验器 `agentskills validate`（skills-ref）逐个检查；字段与版本由 `tests/package-manifest.test.mjs` 强制校验。topmind Desktop 的解析器同时认顶层旧写法与 `metadata.*`。一个 pack JSON（[`topmind-pack.json`](./topmind-pack.json)），无 per-skill 第二清单。
-
----
-
-## 工作区契约
-
-```text
-{workspace-root}/
-├── topmind.yaml                # contract v4
-├── memory/                     # profile.md · periodic/ · topics/ · todo.md · 可选 ledgers/
-├── .topmind/                   # rebuildable machine state
-├── 00-Inbox/                   # role: buffer (live dir name)
-├── 10-动态/ …                  # categories (template-driven)
-├── 88-交付/ or 88-Delivery/     # role: delivery
-└── 99-归档/ or 99-Archive/     # role: system
-```
-
-专题：
-
-```text
-{category}/{YYYY-theme}/
-├── topic.md                 # optional
-├── *.md                     # notes at topic root
-└── images/                  # optional
-```
-
-尚无专题时，散篇放在 `{category}/{note}.md`。
-
-**不要创建（已废弃）：** 默认 `outline.md` / `setting.md` / `style.md`；`project_type` frontmatter；专题内嵌套 `notes/` 或 `outputs/`；顶层 `projects/`；`YYYY-类型-项目名` 命名。
-
-**类别：** 运行时发现 `{NN-Name}/` + `topmind.yaml` v4（`categories.extensions` / `categories.overrides` 含 `hidden`）。共享解析器：引擎 `lib/workspace-model.mjs`。优先按角色路由，不要写死 `10-` / `20-` 编号。
-
-不要硬编码绝对路径 — 从 Host 推断 `workspace_root`，或向用户询问。
-
-### 6 条核心规约
-
-1. **大类不重叠**  
-2. **专题自然涌现**  
-3. **动态类特殊**（默认平铺）  
-4. **兜底类清理**（约 30 天）  
-5. **参考资料定位**  
-6. **大类命名稳定**（rename via migration）  
-
-完整规则：[`shared/project-model-brief.md`](./shared/project-model-brief.md)。
-
----
-
-## 行为规则
-
-- 先捕获；不要因为分类不完美而挡住简单保存  
-- 信号足够强时自动路由；否则走 **role:buffer**（现场 Inbox 目录，不要只写死 `00-Inbox/`）  
-- 专题不清时，散篇放在大类根  
-- 每次写入返回回执（路径、路由原因、下一步）  
-- `source_type`: `user-original` | `external-capture` | `ai-derived`  
-- UTR 可选 — Host 文件工具遵守同一契约  
-- 保存设置协议：`writeback_mode: auto | confirm`  
-- locked：auto 下可编辑（任务级首写快照）；永久删 locked/core 仅用户  
-- 本 pack 不要求 Desktop  
-- **复合纪律（不改结构）：** organize 把综合写回磁盘；write 先读可选 `topic.md`；memory 仅在明确确认后写；capture 从不改 `topic.md`；**不要**硬造 `INDEX.md` / 平行 wiki 树（见 `shared/project-model-brief.md`）  
-
----
-
-## 安装目标
-
-已打包的 skill 目录（7 个核心 + 2 个可选连接器 + 可选记账；4.15.2 起公众号改由写作包的 `topmind-wechat-post` 提供）可以符号链接或复制到 Claude Code、Codex、OpenCode、Hermes 等。  
-优先使用 npm / pack-aware 安装器，保证 `shared/` 与 `topmind-pack.json` 完整 — 见 [`INSTALL.md`](./INSTALL.md)。
-
-```bash
-npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
-```
-
-Host 适配器**不得**改变内容真源、新增并列日常入口，或把内容存进 agent 运行态。见 [`shared/capability-degradation.md`](./shared/capability-degradation.md)。
+中文说明就是 [README.md](./README.md)，本文件只做跳转，内容不再单独维护。English: [README.en.md](./README.en.md)。

package/bin/install-skills.mjs

@@ -32,7 +32,7 @@
  *   --skill <id>        Only install these skill ids (repeatable / comma-separated)
  *   --global / -g       Alias: --host claude-code (user-level ~/.claude/skills)
  *   --dry-run           Print plan only
- *   --force             Replace non-symlink destinations when using symlink mode
+ *   --force             Downgrade / reinstall same version / replace unrelated folder in symlink mode
  *
  * Examples:
  *   # Like `npx skills add topmindspace/topmind-skills -g`
@@ -250,7 +250,12 @@ Options:
   --skill <id>         Only install these skill ids (repeatable / comma-separated)
   --locale <code>      Install locale overlay (e.g. en-US); falls back to topmind_LOCALE env
   -n, --dry-run        Print plan only
-  --force              Replace non-symlink destinations when using symlink mode
+  --force              Allow downgrading a newer installed skill, reinstall an up-to-date one,
+                       or replace an unrelated folder in symlink mode
+Upgrade behaviour: a newer packaged skill overwrites the installed copy in place
+  (no backup, "Upgraded <skill> <old> -> <new>"); the same version is skipped
+  ("Already up to date"); a newer installed version is refused unless --force.
+  In symlink mode a previous plain-folder install of the same skill is replaced.
 
 Examples:
   node bin/install-skills.mjs add topmindspace/topmind-skills -g
@@ -701,12 +706,75 @@ async function applyLocaleOverlay(overlayDir, targetDir) {
   }
 }
 
-async function installCopy(skillsRoot, dest, entries, locale) {
+/** Read name + version from <dir>/SKILL.md frontmatter (metadata.version or top-level version). */
+async function readSkillMeta(dir) {
+  try {
+    const t = await fs.readFile(path.join(dir, "SKILL.md"), "utf8");
+    const fm = (t.match(/^---\r?\n([\s\S]*?)\r?\n---/) || [])[1] || "";
+    const name = ((fm.match(/^name:\s*(.+?)\s*$/m) || [])[1] || "").replace(/^["']|["']$/g, "");
+    const v =
+      fm.match(/^metadata:\s*\n(?:[ \t]+.*\n)*?[ \t]+version:\s*(.+?)\s*$/m) || fm.match(/^version:\s*(.+?)\s*$/m);
+    return { name, version: v ? v[1].replace(/^["']|["']$/g, "") : "" };
+  } catch {
+    return null;
+  }
+}
+
+function parseVer(v) {
+  const m = String(v || "").trim().replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)/);
+  return m ? m.slice(1, 4).map(Number) : null;
+}
+
+/** a vs b: 1 / 0 / -1. Missing or unparseable b counts as oldest (upgrade). */
+function compareVersions(a, b) {
+  const pa = parseVer(a);
+  const pb = parseVer(b);
+  if (!pb) return 1;
+  if (!pa) return -1;
+  for (let i = 0; i < 3; i++) if (pa[i] !== pb[i]) return pa[i] > pb[i] ? 1 : -1;
+  return 0;
+}
+
+/** Existing non-symlink dst is a previous install of this skill (same SKILL.md name) or an installer-owned file. */
+async function isPreviousInstall(src, dst) {
+  const st = await fs.lstat(dst).catch(() => null);
+  if (!st) return false;
+  const sst = await fs.lstat(src).catch(() => null);
+  if (sst && sst.isFile() && st.isFile()) return true;
+  if (!st.isDirectory()) return false;
+  const a = await readSkillMeta(src);
+  const b = await readSkillMeta(dst);
+  return !!(a && b && a.name && a.name === b.name);
+}
+
+async function installCopy(skillsRoot, dest, entries, locale, { force = false } = {}) {
   await fs.mkdir(dest, { recursive: true });
+  // Pre-pass: never silently downgrade a skill that is newer than the packaged one.
+  const plan = new Map();
+  const newer = [];
+  for (const name of entries) {
+    const src = path.join(skillsRoot, name);
+    const dst = path.join(dest, name);
+    const sm = await readSkillMeta(src);
+    if (!sm) continue;
+    const dm = (await fs.lstat(dst).catch(() => null))?.isSymbolicLink() ? null : await readSkillMeta(dst);
+    if (!dm) continue;
+    const cmp = compareVersions(sm.version, dm.version);
+    plan.set(name, { cmp, old: dm.version || "unknown", now: sm.version || "unknown" });
+    if (cmp < 0) newer.push(`${name} ${dm.version} > ${sm.version}`);
+  }
+  if (newer.length && !force) {
+    fail(`installed version is newer than packaged (${newer.join(", ")}); not downgrading — pass --force to downgrade`);
+  }
   for (const name of entries) {
     const src = path.join(skillsRoot, name);
     const dst = path.join(dest, name);
     if (!(await pathExists(src))) continue;
+    const pv = plan.get(name);
+    if (pv && pv.cmp === 0 && !force) {
+      log(`  = Already up to date: ${name} ${pv.now}`);
+      continue;
+    }
     const st = await fs.lstat(src);
     if (await pathExists(dst)) await fs.rm(dst, { recursive: true, force: true });
     if (st.isDirectory()) {
@@ -727,7 +795,9 @@ async function installCopy(skillsRoot, dest, entries, locale) {
     } else {
       await fs.copyFile(src, dst);
     }
-    log(`  + ${name}`);
+    if (pv && pv.cmp > 0) log(`  ↑ Upgraded ${name} ${pv.old} -> ${pv.now}`);
+    else if (pv) log(`  + Reinstalled ${name} ${pv.now} (--force)`);
+    else log(`  + ${name}`);
   }
 }
 
@@ -739,8 +809,8 @@ async function installSymlink(skillsRoot, dest, entries, { force }) {
     if (!(await pathExists(src))) continue;
     if (await pathExists(dst)) {
       const st = await fs.lstat(dst);
-      if (st.isSymbolicLink() || force) await fs.rm(dst, { recursive: true, force: true });
-      else fail(`${dst} exists and is not a symlink (pass --force)`);
+      if (st.isSymbolicLink() || force || (await isPreviousInstall(src, dst))) await fs.rm(dst, { recursive: true, force: true });
+      else fail(`${dst} is an unrelated folder (no matching SKILL.md name) — pass --force to replace it`);
     }
     await fs.symlink(src, dst, "junction");
     log(`  ~ ${name} → ${src}`);
@@ -794,9 +864,9 @@ async function linkPackEntries(canonicalRoot, agentRoot, entryNames, { force })
     if ((await pathExists(dst)) || (await isBrokenSymlink(dst))) {
       const st = await fs.lstat(dst).catch(() => null);
       if (st && st.isSymbolicLink()) await fs.rm(dst, { recursive: true, force: true });
-      else if (force) await fs.rm(dst, { recursive: true, force: true });
+      else if (force || (await isPreviousInstall(src, dst))) await fs.rm(dst, { recursive: true, force: true });
       else {
-        log(`  ! ${dst} exists (not symlink) — skip (pass --force to replace)`);
+        log(`  ! ${dst} is an unrelated folder (no matching SKILL.md name) — skipped; pass --force to replace it`);
         continue;
       }
     }
@@ -845,7 +915,7 @@ async function installViaMatrix(skillsRoot, plan, opts) {
   }
 
   // 1) Full pack body → canonical
-  await installCopy(skillsRoot, canonical, plan.entries, opts.locale);
+  await installCopy(skillsRoot, canonical, plan.entries, opts.locale, opts);
 
   // 2) Private agent dirs: symlink entries (default) or copy
   for (const t of targets) {
@@ -854,7 +924,7 @@ async function installViaMatrix(skillsRoot, plan, opts) {
       continue;
     }
     if (linkMode === "copy") {
-      await installCopy(skillsRoot, t.root, plan.entries, opts.locale);
+      await installCopy(skillsRoot, t.root, plan.entries, opts.locale, opts);
     } else {
       await linkPackEntries(canonical, t.root, plan.entries, opts);
     }
@@ -1014,7 +1084,7 @@ async function cmdAdd(opts, sourceOverride) {
       }
       await installSymlink(skillsRoot, dest, plan.entries, opts);
     } else {
-      await installCopy(skillsRoot, dest, plan.entries, opts.locale);
+      await installCopy(skillsRoot, dest, plan.entries, opts.locale, opts);
     }
 
     await writeInstallReceipt(dest, {

package/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill_name": "topmind",
   "daily_entry": "topmind",
-  "version": "4.15.4",
+  "version": "4.15.6",
   "evals": [
     {
       "id": 1,

package/integrations/codex/README.md

@@ -16,5 +16,5 @@ Codex consumes topmind through the same portable skill pack as other hosts.
 - Content truth is `topmind-workspace`.  
 - Daily entry is `topmind`; no parallel daily entrypoints.  
 - **Desktop is not required** for the skill pack.  
-- Naming and frontmatter follow `PROJECT-MODEL.md` / `TOOLS.md`.  
+- Naming and frontmatter follow `PROJECT-MODEL.md` / `TOOLS.md` in the [topmind](https://github.com/topmindspace/topmind) repo.  
 - Bulk structure fixes may use `workspace-transform.migrate-v4` (UTR advanced).  

package/integrations/hermes/README.md

@@ -16,4 +16,4 @@ Hermes consumes topmind as a portable skill pack, not a second workspace model.
 - Content truth is `topmind-workspace`.  
 - Daily entry is `topmind`; no parallel daily entrypoints.  
 - **Desktop is not required** for the skill pack.  
-- Naming and frontmatter follow `PROJECT-MODEL.md` / `TOOLS.md`.  
+- Naming and frontmatter follow `PROJECT-MODEL.md` / `TOOLS.md` in the [topmind](https://github.com/topmindspace/topmind) repo.  

package/integrations/opencode/README.md

@@ -28,6 +28,6 @@ Repo root `opencode.json` is machine-local (gitignored); share shapes via this e
 ## Must not
 
 - Change content truth or add parallel daily entrypoints  
-- Introduce naming/command surfaces outside `PROJECT-MODEL.md` / `TOOLS.md`  
+- Introduce naming/command surfaces outside `PROJECT-MODEL.md` / `TOOLS.md` (in the [topmind](https://github.com/topmindspace/topmind) repo)  
 - Treat `topmind-loop` as a `topmind-maintain` sub-action (loop is independent)  
 - Treat OpenCode state as workspace content truth  

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@topmindspace/topmind-skills",
-  "version": "4.15.4",
-  "description": "topmind Agent Skills pack — spec-valid Markdown skills for capture, organize, write, memory, maintain, loop.",
+  "version": "4.15.6",
+  "description": "topmind Agent Skills pack: one daily entry (topmind) routing to capture, organize, write, memory, maintain and loop, plus optional WeRead, X and ledger skills.",
   "type": "module",
   "license": "MIT",
   "author": "TopMindSpace",

package/skills.md

@@ -1,40 +1,30 @@
-# topmind Skills Package Index (包索引)
+# topmind Skills 包索引
 
-> [!NOTE]
-> **每日唯一入口**：`topmind` (router)。包内还有 6 个 action、2 个 optional connector、1 个 optional 记账（连 router 共 10 个目录）。公众号 `topmind-wechat-post` 在外部写作包，不计入本包。  
-> **通用与可移植**：兼容 Claude Code / OpenCode / Codex / Hermes 等 Agent Host。  
-> **版本真源**：`topmind-pack.json`（可执行 `npm run versions` 查看完整版本号）。  
-> 详见权威说明：[Skills README](./README.md)（简体中文） · [English](./README.en.md) · [安装与部署指南 (INSTALL.md)](./INSTALL.md)。
+日常入口只有 `topmind`。包内另有 6 个动作技能、2 个可选连接器、1 个可选记账，连入口共 10 个目录。公众号技能 `topmind-wechat-post` 在外部写作包 [topmind-writing-skills](https://github.com/topmindspace/topmind-writing-skills)，不计入本包。
 
----
+版本以 [`topmind-pack.json`](./topmind-pack.json) 为准（`npm run versions`）。使用说明见 [README](./README.md)（[English](./README.en.md)），安装见 [INSTALL.md](./INSTALL.md)。
 
-## Skill 包清单
+## 技能清单
 
-| # | Skill 名称 | 模块类型 | 关键触发词 / 场景 | 职责描述 |
+| # | 技能 | 类型 | 常见说法 | 做什么 |
 |---|---|---|---|---|
-| 1 | `topmind` | **Router** | `topmind` / 记一下 / 整理 / 模糊多意图 | **主入口 router**：解析用户意图与工作区上下文，自动路由动作与大类 |
-| 2 | `topmind-capture` | Action | 记一下 / capture / 抓取链接 | **捕获动作**：处理速记、网页链接、知识文件加工并安全落盘 |
-| 3 | `topmind-organize` | Action | 整理 / organize / 提炼结构 | **整理动作**：归纳笔记、整理专题、提取证据链与知识留痕 |
-| 4 | `topmind-write` | Action | 写 / 起草 / 润色 / 出稿 | **写作动作**：根据专题与参考资料起草长文、润色及生成 Deliverable |
-| 5 | `topmind-memory` | Action | 记住 / 更新我的情况 / memory | **记忆动作**：维护 `memory/profile.md` 与周期反思（非默认写 `topic.md`） |
-| 6 | `topmind-maintain` | Action | doctor / 诊断 / 清理 | **体检动作**：检查目录健康、孤立文件、配置校验与环境诊断 |
-| 7 | `topmind-loop` | Action | loop / 巡检 / 自动盘点 | **巡检动作**：可恢复的工作区全量语义巡检与盘点 |
-| 8 | `topmind-weread` | Connector | 微信读书 / weread | **微信读书连接器**：同步划线、书评与阅读笔记 |
-| 9 | `topmind-x` | Connector | X / 推特 / twitter | **X (Twitter) 连接器**：归档推特帖子、书签与时间线 |
-| 10 | `topmind-ledger` | Memory（可选） | 记账 / 记一笔 / 花了 / 存入 | **记账**：默认个人账本，用户自建账本/分类，写入 `memory/ledgers/` |
-| — | ~~`topmind-wechat`~~ | 4.15.2 起移出 | 公众号 / 微信排版 / 定稿 | 改用写作包 topmind-writing-skills 的 `topmind-wechat-post`（外部可选，不随本包发布）；已装旧 `topmind-wechat` 的请删除 |
-
----
-
-## 核心约定与规约
-
-1. **唯一前台入口**：AI Agent 日常激活只需推荐 `topmind`。
-2. **渐进式披露 (Progressive Disclosure)**：Discovery (`name+description`) → Activation (`SKILL.md`) → Deep Procedures (`shared/` / `references/`)。
-3. **文件系统即真源**：不引入独立的数据库或 Agent state 依赖。
-4. **遵从 6 条核心规约**：见 [`shared/project-model-brief.md`](./shared/project-model-brief.md)。
-5. **自动建议阶梯**：真源 [`shared/auto-suggest.md`](./shared/auto-suggest.md)（材料 L0 落盘；显式行动语待办在 auto 下同轮写入；其余建议点头再落；L2 才动记忆/删档/建专题）。待办是 `memory/todo.md` 卫星，不是第六概念。
-
-👉 **详细架构、Frontmatter Schema 与安装方法请参阅**：
-- [Skills README](./README.md)（简体中文） · [English](./README.en.md)
-- [多 Host 安装教程 (INSTALL.md)](./INSTALL.md)
-- Pack 真源：[`topmind-pack.json`](./topmind-pack.json)
+| 1 | `topmind` | 入口 | topmind、待办、意图不明确或一次说了几件事 | 判断你要做什么，交给对应技能；多件事拆成几步 |
+| 2 | `topmind-capture` | 动作 | 记一下、收进、保存链接 | 速记、链接、文件落盘，行动语提取待办 |
+| 3 | `topmind-organize` | 动作 | 整理本周、整理、总结、对比 | 理顺动态，在专题内整理、研究、分析，分流 Inbox |
+| 4 | `topmind-write` | 动作 | 写、起草、润色、出稿 | 依据专题与资料起草、改稿、交付 |
+| 5 | `topmind-memory` | 动作 | 记住这个、更新我的情况 | 维护 `memory/profile.md` 与周期反思 |
+| 6 | `topmind-maintain` | 动作 | 体检、doctor、清理 | 目录与配置的确定性检查和可回退清理 |
+| 7 | `topmind-loop` | 动作 | 跑一遍 loop、巡检 | 全工作区语义巡检，可中断续跑 |
+| 8 | `topmind-weread` | 连接器（可选） | 微信读书、同步划线 | 同步划线、想法与阅读统计到专题 |
+| 9 | `topmind-x` | 连接器（可选） | 发推、推特、x.com | X 归档、搜索与发帖 |
+| 10 | `topmind-ledger` | 记账（可选） | 记账、记一笔、花了、存入 | 默认个人账本，可自建账本与分类，写入 `memory/ledgers/` |
+
+旧技能 `topmind-wechat` 已在 4.15.2 移出本包，由写作包的 `topmind-wechat-post` 接替。已装旧目录的请删除，否则两者会抢同一批说法。
+
+## 核心约定
+
+1. 只向用户推荐 `topmind` 一个入口，子技能的触发词只服务助手路由。
+2. 按需加载：先读技能名和描述，触发后读 `SKILL.md`，需要细节时再读 `shared/` 和 `references/`。
+3. 文件就是数据来源，不依赖数据库或助手会话状态。
+4. 遵守 6 条工作区规约，见 [`shared/project-model-brief.md`](./shared/project-model-brief.md)。
+5. 自动建议分级见 [`shared/auto-suggest.md`](./shared/auto-suggest.md)：材料直接落盘；明确说了要做的事，auto 模式下同轮写入待办；其余建议等你点头；动记忆、删档、建专题要确认。待办放在 `memory/todo.md`。

package/topmind/SKILL.md

@@ -9,14 +9,14 @@ compatibility: >-
   topmind workspace with {NN-Name}/ categories. Host file tools primary; UTR optional.
   Install with shared/ sibling for progressive disclosure links.
 metadata:
-  version: "4.15.4"
+  version: "4.15.6"
   action_category: "router"
   entrypoint: "true"
   triggers: "topmind, 知识库, 工作区, 待办, 有什么要做的, 要做的事, todo, todo list"
   tags: "router, entrypoint, topmind"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-16"
+  updated: "2026-10-24"
   degradation: "../shared/capability-degradation.md"
 ---
 

package/topmind-capture/SKILL.md

@@ -8,14 +8,14 @@ description: >-
 license: MIT
 compatibility: topmind workspace. Host file tools or optional UTR capture-note.
 metadata:
-  version: "4.15.4"
+  version: "4.15.6"
   action_category: "capture"
   entrypoint: "false"
   triggers: "收集, 收进, 保存, 剪藏, 记一下, 临时存放, 随手记, 想法, 灵感, 暂存沉淀, 记录, 备忘, 存一下, 暂存, 笔记, 抄下来, 摘录, 记一下要做, 别忘了, 要做, capture, note, save, Note it"
   tags: "capture, inbox, note, material"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-16"
+  updated: "2026-10-24"
   degradation: "../shared/capability-degradation.md"
 ---
 

package/topmind-ledger/SKILL.md

@@ -6,14 +6,14 @@ description: >-
 license: MIT
 compatibility: Host file tools or Kernel writeback. Desktop optional mini-app. Feishu/lark-cli is not required.
 metadata:
-  version: "4.15.4"
+  version: "4.15.6"
   action_category: "memory"
   entrypoint: "false"
   triggers: "记账, 记一笔, 花了, 存入, 查看账单, 账户余额, bookkeeping, log expense"
   tags: "ledger, bookkeeping, memory, optional"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-16"
+  updated: "2026-10-24"
   degradation: "../shared/capability-degradation.md"
 ---
 

package/topmind-loop/DESIGN.md

@@ -4,7 +4,7 @@
 
 ## Why Loop Exists
 
-UTR 提供 **8 域 / 35** 条确定性命令；`doctor-workspace` 做规则健康检查。Loop 在之上增加**语义层**：阅读 `topic.md` 与笔记、对照 skill 契约、再调用 UTR 修复。
+UTR 提供 **8 域 / 38** 条确定性命令（以 topmind 仓库 `TOOLS.md` 为准）；`doctor-workspace` 做规则健康检查。Loop 在之上增加**语义层**：阅读 `topic.md` 与笔记、对照 skill 契约、再调用 UTR 修复。
 
 ## Design Choice — Skill + Agent + State File, Not CLI
 

package/topmind-loop/SKILL.md

@@ -6,14 +6,14 @@ description: >-
 license: MIT
 compatibility: topmind workspace. Progress under .topmind/loop/*. Host LLM runs the walk; UTR optional.
 metadata:
-  version: "4.15.4"
+  version: "4.15.6"
   action_category: "loop"
   entrypoint: "false"
   triggers: "跑一遍 loop, loop 一下, 整体体检, 工作区复盘, 把工作区跑一遍, 巡检, 继续 loop, 从断点继续, 全面检查, 复盘, review, audit, walk"
   tags: "loop, audit, walk, resumable, cyclic"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-16"
+  updated: "2026-10-24"
   degradation: "../shared/capability-degradation.md"
 ---
 

package/topmind-maintain/SKILL.md

@@ -6,14 +6,14 @@ description: >-
 license: MIT
 compatibility: topmind engine and/or workspace. Prefer read-only diagnostics first.
 metadata:
-  version: "4.15.4"
+  version: "4.15.6"
   action_category: "maintain"
   entrypoint: "false"
   triggers: "快速体检, 体检, 诊断, doctor, 健康检查, 清理, 修复, 快速检查, 检查, 状态, workspace check, scan, fix, maintain"
   tags: "maintain, doctor, cleanup, audit, health-check"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-16"
+  updated: "2026-10-24"
   degradation: "../shared/capability-degradation.md"
 ---
 
@@ -78,6 +78,7 @@ metadata:
 - `project_type:`  
 - 废弃命令名 `create-project` 等（现行 `workspace-*`）  
 - ensure 时复活用户已删的可选模板类  
+- 跟随指向库外的符号链接，或递归 `.app` / `.framework` / `node_modules` / `dist` 等包与依赖目录  
 
 ## Capability Degradation
 

package/topmind-memory/SKILL.md

@@ -6,14 +6,14 @@ description: >-
 license: MIT
 compatibility: workspace core profile (memory/profile.md) + periodic reflections.
 metadata:
-  version: "4.15.4"
+  version: "4.15.6"
   action_category: "memory"
   entrypoint: "false"
   triggers: "写入专题记忆, 更新我的情况, stable memory, 追加确认结论, 记住这个, 记住我, 加到专题记忆, 沉淀结论, 提炼到记忆, update profile, memory"
   tags: "memory, stable, core-profile, 我的情况"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-16"
+  updated: "2026-10-24"
   degradation: "../shared/capability-degradation.md"
 ---
 
@@ -72,7 +72,7 @@ Host: 读 profile（活跃段）→ ADD / UPDATE 原位 / RETIRE 到 ## 历史
 
 - 路径：`memory/periodic/{YYYY}/{YYYY-Www}.md` 等  
 - 来源：活动窗口 AI 建议（`stream_digest` / `ai_summary`）**确认后**写入  
-- **反思非摘要**：不是「本周发生了什么」，而是「本周揭示了什么」——关注焦点、知识与见解、行为信号、偏好变化、线索  
+- **反思非摘要**：写「本周揭示了什么」，不罗列「本周发生了什么」。重点是关注焦点、知识与见解、行为信号、偏好变化、线索  
 - 与 profile 同属记忆平面；**不是**专题目录  
 
 ## 可选：专题语义记忆（非默认）

package/topmind-organize/SKILL.md

@@ -6,14 +6,14 @@ description: >-
 license: MIT
 compatibility: topmind workspace with stream period notes, topics, or Inbox.
 metadata:
-  version: "4.15.4"
+  version: "4.15.6"
   action_category: "organize"
   entrypoint: "false"
   triggers: "整理本周, 理顺本周, 周复盘, 整理, 组织, 研究, 分析, 对比, 提取, 梳理, 归纳, 证据, 实体, 质量审查, 总结, 概括, 汇总, 提纲, 分类整理, 找关联, 总结成笔记要点, organize, summarize, analyze, weekly review"
   tags: "organize, research, analyze, stream, weekly-review"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-16"
+  updated: "2026-10-24"
   degradation: "../shared/capability-degradation.md"
 ---
 
@@ -103,7 +103,7 @@ metadata:
 
 ## 通用流程：读 → 做 → 报
 
-1. **读** `topic.md`（若有）+ 当前对象；不预加载整专题  
+1. **读** `topic.md`（若有）+ 当前对象；不预加载整专题。扫描跳过库外符号链接、应用包 / 依赖目录，并认 Obsidian `userIgnoreFilters`  
 2. **做** 标记 `source_type`；原始与 AI 分析用分隔线 + `[AI整理]`  
 3. **报** 结果 + 路径回执 + 下一步；**综合默认落专题根**（auto 直接写 / confirm 先审阅）；不自动 write/memory  
    - 入口先确认类别表（`list-categories` / 扫盘）；跳过 hidden；不硬编码编号
@@ -112,7 +112,7 @@ metadata:
 
 ## 目录偏好
 
-专题根扁平；分类靠 frontmatter 与文件名，不硬建子目录树。**禁止**维护 `INDEX.md` 硬索引、禁止为「像 wiki」新建平行目录；`state.json` 非内容真源。位置靠类别+专题树 + 搜索即可。
+专题根扁平；分类靠 frontmatter 与文件名，不硬建子目录树。**禁止**维护 `INDEX.md` 硬索引、禁止为「像 wiki」新建平行目录；`state.json` 非内容真源。位置靠类别+专题树 + 搜索即可。扫描不进入库外链接、`.app` / `.framework` / `node_modules` / `dist`，并跳过 Obsidian `userIgnoreFilters` 排除的路径。
 
 ## Capability Degradation
 

package/topmind-pack.json

@@ -4,8 +4,8 @@
   "label": "topmind",
   "description": "topmind skill pack: single daily entry topmind + progressive disclosure (shared/ + references/), Agent Skills spec-valid frontmatter (custom fields under metadata, checked by agentskills validate), capture-first template-driven categories, optional connectors topmind-weread and topmind-x, optional topmind-ledger (记账). None of the optional skills is an extra user concept. WeChat (公众号) and other writing skills live in the external topmind-writing-skills pack (topmind-wechat-post etc.) and are routed only when installed. File-system-first content truth; UTR optional.",
   "daily_entry": "topmind",
-  "version": "4.15.4",
-  "updated": "2026-10-16",
+  "version": "4.15.6",
+  "updated": "2026-10-24",
   "license": "MIT",
   "locales": {
     "default": "zh-CN",