@topmindspace/topmind-skills 4.13.0

package/topmind-loop/references/scopes-and-walk.md

@@ -0,0 +1,56 @@
+# Loop Scopes & Per-Item Walk
+
+## Scopes
+
+| Scope | Walks | State file |
+|-------|-------|------------|
+| `topics` | 每个 `{大类}/{专题}/` | `.topmind/loop/topics.md` |
+| `inbox` | buffer 类别（常 00-Inbox）下条目 | `.topmind/loop/inbox.md` |
+| `archive` | system 类别（常 99-归档）下条目（含 `backups/` · `stream-archive/` · `receipts/`） | `.topmind/loop/archive.md` |
+
+默认全跑三 scope。用户可限定：`loop 一下 topics` / `loop 一下 {类别名}` / `继续 loop`。
+
+## Per-Item Walk（agent 是裁决者）
+
+### 1. Read
+
+- 专题：`topic.md`（若有）+ 抽样根目录 `.md`；发现 `outline.md`/`setting.md`/`style.md` 标 drift  
+- 散记：`{大类}/*.md` frontmatter + body  
+- Inbox：内容与归属线索  
+- Archive：README / 抽样；**默认只读**  
+
+### 2. Semantic decide
+
+- 信任专题自述工作流；空子目录若声明用途 → preserve  
+- 对照 `topic.md` 声称 vs 实际笔记  
+- 索引链接是否失效；`下一步` / 状态是否陈旧  
+- Inbox：每条需路由到类别（±专题）  
+- **首页偏空提示（只建议，不自动写）**：专题根 `.md` 较多（例如 ≥5，不含 topic.md）而 `topic.md` 缺失、或正文几乎只有标题/占位时 → Escalate 或回执一句：「材料不少，可用 organize 整理落盘 / 需要时更新我的情况」。**禁止** loop 自己填稳定记忆或新建 INDEX.md  
+
+**Architecture drift（写入 Errors / Blockers，不静默改）**：
+
+- `YYYY-类型-项目名` 命名  
+- frontmatter `project_type:`  
+- 默认锚点 `outline.md` / `setting.md` / `style.md`  
+- 顶层 `projects/` / `references/` / `sources/` / `library/`  
+- 废弃 UTR 名（`create-project` 等；现行 `workspace-*`）  
+
+### 3. Apply / Preserve / Escalate
+
+- **Apply** — host 文件工具（主）或 UTR：补 frontmatter、`plan-inbox-routing` 等  
+- **Preserve** — 写清为什么不动  
+- **Escalate** — 需人决策时写 Errors / Blockers  
+
+不输出「请用户批准的建议清单」当作完成态；走查日志记录**已做决策**。
+
+### 4. Record
+
+每项追加到 scope 状态文件（见 `state-file.md`）。
+
+## Guardrails
+
+- system 归档默认只读  
+- 写主路径 = host 文件工具；UTR 可选加速；危险操作备份  
+- 不改类别名（需 human + Desktop 重命名 / `renameCategory`；v2 `projects/` 迁移仍用 `migrate-v4`）  
+- 不自动把散记升专题  
+- 不写内容稿 / 不改专题目标（那是 write/memory）  

package/topmind-loop/references/state-file.md

@@ -0,0 +1,52 @@
+# Loop State File Format
+
+```text
+{workspace}/.topmind/loop/
+├── README.md
+├── topics.md
+├── inbox.md
+└── archive.md
+```
+
+`.topmind/loop/` 遵循 `.obsidian` / `.git` 隐藏约定，不污染主视图。
+
+## Template
+
+```markdown
+# Loop State — topics
+
+last_run: 2026-07-13T12:00:00+08:00
+scope: {workspace-root}/{categories}/*/
+cursor: {类别}/{专题}
+done: 6 / total: 11
+
+## 本轮计划
+
+- …
+
+## 已完成
+
+- [x] {类别}/2026-示例 — 无异常
+
+## 待处理（下次继续）
+
+- [ ] …
+
+## Errors / Blockers
+
+- …
+
+## Receipts
+
+- 2026-07-13T12:01 — plan-inbox-routing → path.md
+```
+
+## Cursor & Resume
+
+- `继续 loop` / `从断点继续`：读 `cursor`，从该项继续  
+- 用户可手改 `cursor` 跳过/重排  
+- **若 `.topmind/loop/` 或 scope 文件缺失**：不报错；当作首次运行；通知用户后全跑并在 walk 中创建状态文件（不要预先写空文件）  
+
+## Auditability
+
+每次运行更新：`last_run` · `cursor` · `done/total` · 已完成/待处理/Errors · Receipts 路径。  

package/topmind-maintain/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: topmind-maintain
+version: 4.13.0
+description: >-
+  确定性体检/清理/结构修复/回执恢复。Use when 快速体检、诊断、doctor、清理、修复、workspace check。
+  Do NOT use for 整体巡检 loop、内容整理、捕获、写作、记忆.
+action_category: maintain
+triggers:
+  - 快速体检
+  - 体检
+  - 诊断
+  - doctor
+  - 健康检查
+  - 清理
+  - 修复
+  - 快速检查
+  - 检查
+  - 状态
+  - workspace check
+  - scan
+  - fix
+  - maintain
+tags: [maintain, doctor, cleanup, audit, health-check]
+entrypoint: false
+compatibility: topmind engine and/or workspace. Prefer read-only diagnostics first.
+author: TopMindSpace
+license: MIT
+homepage: https://github.com/topmindspace/topmind
+updated: 2026-09-16
+degradation: ../shared/capability-degradation.md
+---
+
+# topmind Maintain
+
+系统与工作区**确定性**健康。不重塑内容、不写交付稿。
+
+> **日常入口（Desktop）**：工作区下拉 / **⌘⇧L「工具与日志」**——概览 stats · 操作日志 · 系统日志 · 健康（含契约）· 清理预览 / 去重。CLI/MCP 仍走 UTR doctor；清理默认预览后确认，不自动执行。恢复（`restore-safety-receipt`）仍是 UTR 独有能力。
+
+## Activation checklist
+
+1. 只读诊断优先（`doctor-workspace` / 扫盘 / Desktop 面板健康）  
+2. 自定义 `{NN-Name}/` 合法；用 WorkspaceModel，不硬编码槽位  
+3. 高影响清理/删除可逆（见 `../shared/writeback-receipt.md`：仅 locked 覆盖 / 核心 delete 才备份+回执；archive 是迁入新家）  
+4. 语义全库巡检 → 转 **loop**  
+
+## When NOT to use
+
+- 整理笔记 / 证据 → organize  
+- 存材料 → capture  
+- 起草/输出 → write  
+- 沉淀记忆 → memory  
+- 全工作区语义巡检 / 整体体检 / 从断点继续 → **loop**  
+- 发推 / 微信读书 → connectors  
+
+## Use For
+
+- Desktop **工具与日志**面板（日常）与 UTR / CLI / MCP doctor  
+- 工作区清理预览与可逆清理（高影响 only 备份/回执）  
+- skills/docs 漂移审计、evals  
+- 过时文件、架构漂移  
+- v2 `projects/` → 类别：`migrate-v4`（advanced，dry-run + 可逆）  
+- 一级类重命名 / 角色：Desktop 或 `renameCategory` / topmind.yaml（**不**在 maintain 静默改名）  
+- 撤销/恢复：`list-safety-receipts` → `restore-safety-receipt`；面板操作日志可回看写路径（浏览层，非回执）  
+
+## Workflow
+
+1. 定 scope：workspace / topic / skills / UTR / Desktop  
+2. 先只读诊断：Desktop ⌘⇧L 健康 / `list-categories` 或 `doctor-workspace`  
+3. 清理：先预览；删除走写闸（高影响才有备份+回执，见 writeback-receipt）  
+4. **不**把 `state.json` / `.topmind/workspace-map.json` 当内容真源  
+5. 自定义类合法；禁止用固定槽位表否定用户目录  
+6. 记录证据与 follow-up  
+
+备份链实现细节属 Desktop runtime（`writeback.mjs`）；skill 只保证**写入可逆**。
+
+## Recovery
+
+用户说「撤销 / 找回误删」：
+
+1. `list-safety-receipts`（扫描现场 system 目录的 `backups/`、`backups/trash/`、legacy `trash/`、归档专题、delivery 修订版）  
+2. 匹配 `relativePath` / category / topic  
+3. `restore-safety-receipt`（不覆盖已有文件；写 `-restored-` 副本）  
+
+## Architecture Drift（发现即报）
+
+- `YYYY-类型-项目名`  
+- 默认锚点 outline/setting/style  
+- 强制 6 大 section topic.md  
+- 顶层 `projects/` / `references/` / `sources/` / `library/`  
+- 硬编码槽位 / 把自定义 `{NN-Name}/` 判为非法  
+- `project_type:`  
+- 废弃命令名 `create-project` 等（现行 `workspace-*`）  
+- ensure 时复活用户已删的可选模板类  
+
+## Capability Degradation
+
+[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。`workspace-maintain.*` · `migrate-v4`。
+
+## 保存设置
+
+- **自动保存 (auto)**：直接写入并返回路径回执（path receipt）
+- **需要审阅 (confirm)**：先进入目标路径/内容审阅入口再保存
+- Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
+

package/topmind-memory/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: topmind-memory
+version: 4.13.0
+description: >-
+  更新「我的情况」或周期反思。Use when 记住这个、更新我的情况、加到专题记忆、沉淀结论。
+  Do NOT use for 捕获、仅总结（→organize）、整理本周正文、出稿、开/并专题、doctor/loop.
+action_category: memory
+triggers:
+  - 写入专题记忆
+  - 更新我的情况
+  - stable memory
+  - 追加确认结论
+  - 记住这个
+  - 记住我
+  - 加到专题记忆
+  - 沉淀结论
+  - 提炼到记忆
+  - update profile
+  - memory
+tags: [memory, stable, core-profile, 我的情况]
+entrypoint: false
+compatibility: workspace core profile (memory/profile.md) + periodic reflections.
+author: TopMindSpace
+license: MIT
+homepage: https://github.com/topmindspace/topmind
+updated: 2026-08-17
+degradation: ../shared/capability-degradation.md
+---
+
+# topmind Memory
+
+**默认记忆模型（产品真理）**：
+
+| 层 | 路径 | 用途 |
+|----|------|------|
+| **主 memory** | `memory/profile.md` | 「我的情况」— 偏好 / 目标 / 关系 / 进行中 |
+| **周期子 memory** | `memory/periodic/{YYYY}/{period}.md` | 周期反思（stream_digest / ai_summary 确认后） |
+
+**建立/归入专题**（内容大类夹）→ **organize / topic_classify**，路径 `{大类}/{YYYY-主题}/topic.md`。  
+**不是**默认写入 `memory/topics/`。
+
+| 用户意图 | 写哪里 |
+|----------|--------|
+| 关于**我** | `memory/profile.md` |
+| **周期反思** | `memory/periodic/{YYYY}/` |
+| **开/并专题**（长期主题夹） | 内容大类下专题（organize 建议 · 确认后 create_topic） |
+| 明确说「把结论写进专题记忆层」 | 可选 `memory/topics/{slug}.md`（语义平面 · **非默认**） |
+
+## Activation checklist
+
+1. 判目标：关于我 → profile；周期反思 → periodic；开专题 → **交 organize / 内容大类**（勿默认 memory/topics）  
+2. 筛 **confirmed · stable · reusable · scoped**  
+3. Core：`memory.append-profile`；周期反思：digest 路径；仅用户明说专题语义记忆时才 `memory.append-topic`  
+4. 整文替换需可逆备份  
+
+## 核心画像（Core Profile）
+
+- 路径：`memory/profile.md`（语义平面；原 `我的情况.md`）  
+- `topmind.yaml` → `memory.layers.global.file`（默认 `profile.md`）  
+- 推荐段落：`## 偏好` · `## 当前目标` · `## 关键的人与协作` · `## 进行中的事`；完成/过期条目归档到 `## 历史记录`（加 `（YYYY-MM-DD 归档）` 前缀，不删内容）  
+- 缺失时创建模板后追加  
+
+```text
+UTR: memory.append-profile --content "…"
+Desktop: append_core_memory · update_core_memory · retire_core_memory
+Host: 读 profile（活跃段）→ ADD / UPDATE 原位 / RETIRE 到 ## 历史记录 → 写回
+```
+
+**事实生命周期（确认式，无自动遗忘，不是只追加）**：
+- **追加（ADD）**：新稳定事实 → `append_core_memory` / `memory.append-profile`（跨活跃段落去重，禁止第二条活事实）
+- **更新（UPDATE）**：含义变了 → `update_core_memory`（原位改写并刷新日期，不要再 append 一行）
+- **归档（RETIRE）**：已完成/过期 → `retire_core_memory`（活跃段 → `## 历史记录`，加 `（YYYY-MM-DD 归档）` 前缀，**不删内容**）
+
+用户说「这件事做完了 / 这条过时了」→ 归档，**不要删除**；「这条改成…」→ 原位更新。`memory_organize` 产出 `append_profile` / `update_profile` / `retire_profile` 建议（须确认）。AI 上下文只注入活跃事实（历史段折叠为计数）。
+
+## 周期反思（Periodic）
+
+- 路径：`memory/periodic/{YYYY}/{YYYY-Www}.md` 等  
+- 来源：活动窗口 AI 建议（`stream_digest` / `ai_summary`）**确认后**写入  
+- **反思非摘要**：不是「本周发生了什么」，而是「本周揭示了什么」——关注焦点、知识与见解、行为信号、偏好变化、线索  
+- 与 profile 同属记忆平面；**不是**专题目录  
+
+## 可选：专题语义记忆（非默认）
+
+仅当用户**明确**要求「写到专题记忆 / memory topics」时，才写入 `memory/topics/{topic-slug}.md`。  
+日常「这个值得开个专题」→ 内容大类下 `{YYYY-主题}/`，不是 memory 平面。
+
+## When NOT to use
+
+- 存材料 → capture  
+- 理顺本周流水 / 建议开专题 → organize「整理本周」（活动窗口）  
+- 分析/整理笔记（不写记忆）→ organize  
+- 起草/交付 → write  
+- 体检/巡检 → maintain / loop  
+
+## 守门
+
+- **禁止**因 capture / 剪藏 / 导入 自动改 profile 或 `memory/topics/`  
+- **禁止**整理过程中顺手狂写（organize 只可**建议**候选；topic 建议进**内容大类**）  
+- 仅用户明确「记住 / 更新我的情况 / 写进专题记忆」或当轮确认  
+
+## Role-aware density
+
+- 日常事实 → 周期本或「我的情况」  
+- 反复主题 → 建议内容大类专题，不默认 memory/topics  
+- buffer / delivery / system 通常不适用  
+
+## Capability Degradation
+
+[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。  
+`memory.append-profile` · `memory.append-topic` · `inspect-topic`。
+
+## 保存设置
+
+- **自动保存 (auto)**：默认；写回执  
+- **需要审阅 (confirm)**：先预览  
+- 见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。

package/topmind-organize/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: topmind-organize
+version: 4.13.0
+description: >-
+  整理本周动态、专题内整理/研究/分析/路由 Inbox。Use when 整理本周、整理、分析、研究、对比、总结要点、organize、summarize。
+  Do NOT use for 首次捕获、最终出稿、仅写我的情况、快速 doctor、全库 loop.
+action_category: organize
+triggers:
+  - 整理本周
+  - 理顺本周
+  - 周复盘
+  - 整理
+  - 组织
+  - 研究
+  - 分析
+  - 对比
+  - 提取
+  - 梳理
+  - 归纳
+  - 证据
+  - 实体
+  - 质量审查
+  - 总结
+  - 概括
+  - 汇总
+  - 提纲
+  - 分类整理
+  - 找关联
+  - 总结成笔记要点
+  - organize
+  - summarize
+  - analyze
+  - weekly review
+tags: [organize, research, analyze, stream, weekly-review]
+entrypoint: false
+compatibility: topmind workspace with stream period notes, topics, or Inbox.
+author: TopMindSpace
+license: MIT
+homepage: https://github.com/topmindspace/topmind
+updated: 2026-08-15
+degradation: ../shared/capability-degradation.md
+---
+
+# topmind Organize
+
+已存材料 → 可用结构。用户高频入口：**整理本周**（理顺动态）。
+
+## Activation checklist
+
+1. 若用户说「整理本周 / 理顺流水」→ **整理本周**流程  
+2. 否则确认已有笔记 / Inbox（无材料则先 capture）  
+3. `list-categories` / 读周期本或专题 `.md`  
+4. 按 writeback 写回（默认 auto；整篇替换先备份）  
+5. 回执；不自动 memory（只建议候选）  
+
+## When NOT to use
+
+- 存新材料 → `topmind-capture`  
+- 交付最终报告/文章 → `topmind-write`  
+- 只写「我的情况」/ 周期反思 → `topmind-memory`  
+- doctor / 全库巡检 → `topmind-maintain` / `topmind-loop`  
+
+## 动作入口判断
+
+| 用户表达 | 入口 |
+|---------|------|
+| **整理本周 / 理顺本周 / 周复盘** | **整理本周**（主路径） |
+| 对比 / 证据 / 来源 / 研究 | 研究分析 |
+| 质量 / 矛盾 / 一致性 | 质量审查 |
+| 提取实体 / 人物 / 概念（显式） | 实体提取 |
+| 整理 inbox / 归类 inbox | Inbox 路由（`plan-inbox-routing`） |
+| 默认 / 整理 / 梳理 / 总结 | 整理结构 |
+
+### 整理本周（Stream reconcile · 活动窗口）
+
+用户只感到「点一下整理」；系统以 **近期活动窗口** 为范围（不只最新周期文件名）：
+
+```text
+活动窗口 =
+  最近周期本
+  ∪ 近期 mtime 变更的笔记
+  ∪ 增补锚定的原文（旧文评论后整包进入）
+
+1. 读活动窗口材料（优先当前周期本；含对旧文的增补与其 parent）
+2. 就地理顺周期本：
+   - 合并同一事项状态（「要做 X」+「X 完成」→ 进行中列表更新）
+   - 去重、整理 ## 进行中
+   - 保留可读叙事；不要为分类而拆文件
+3. 可选候选（列表请用户接受后再写）：
+   - 更新「我的情况」/ 周期反思 → memory skill（profile + periodic，不是专题）
+   - 反复主题 → 建议在内容大类下开/并入专题（勿写 memory/topics；勿自动升专题）
+```
+
+**流水可以永远只是流水**——不升专题也完全健康。  
+条目上的「增补」= 同文件续写（评论感），不是平行评论库。
+
+写回：默认 `writebackMode: auto`；仅锁定/核心笔记覆盖或删除才备份到现场 **role:system** 目录的 `backups/`（常为 `99-归档/` / `99-Archive/`，不写死中文）。  
+回执白话：「本周动态已理顺」+ 路径 + 可选候选列表。
+
+### 整理结构
+
+读专题材料 → 聚类提炼 → 结构化笔记或建议；克制整理，保留原始细节；识别可升 memory 的候选（不自动写 memory）。
+
+**整理留痕（复利，不改目录）**：用户要整理/总结/分析时，除对话回答外，**默认按 writeback 写回**专题根一篇 md（或更新已有综合笔记）。不要只回话不落盘。不建 `INDEX.md`、不建 entities/、不强制 topic.md。可升 memory 的条目只在回执里**建议**，用户说「记住」再走 memory。
+
+### 研究分析
+
+证据链：来源 → 事实 → 推断 → 待验证。对比用表；保留 URL/日期；区分确认与假设。有价值的对比/结论同样**默认落盘**（专题根 md），避免只留在聊天里。
+
+### 实体提取（非默认）
+
+仅显式要求时。实体附证据；不建默认子目录。
+
+### 质量审查
+
+目标对齐、事实一致、溯源、不确定性、输出就绪、写回安全。
+
+### Inbox 路由
+
+内容组织动作（不是 maintain/loop）。`plan-inbox-routing` → 建议类别/专题 → 按保存设置移动或预览。
+
+## 通用流程：读 → 做 → 报
+
+1. **读** `topic.md`（若有）+ 当前对象；不预加载整专题  
+2. **做** 标记 `source_type`；原始与 AI 分析用分隔线 + `[AI整理]`  
+3. **报** 结果 + 路径回执 + 下一步；**综合默认落专题根**（auto 直接写 / confirm 先审阅）；不自动 write/memory  
+   - 入口先确认类别表（`list-categories` / 扫盘）；跳过 hidden；不硬编码编号
+
+克制：不加戏、表格优于空泛罗列、专业术语内联解释。
+
+## 目录偏好
+
+专题根扁平；分类靠 frontmatter 与文件名，不硬建子目录树。**禁止**维护 `INDEX.md` 硬索引、禁止为「像 wiki」新建平行目录；`state.json` 非内容真源。位置靠类别+专题树 + 搜索即可。
+
+## Capability Degradation
+
+[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。`workspace-read.*` · `capture-note` · `plan-inbox-routing`。
+
+## 保存设置
+
+- **自动保存 (auto)**：直接写入并返回路径回执（path receipt）
+- **需要审阅 (confirm)**：先进入目标路径/内容审阅入口再保存
+- Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
+