@topmindspace/topmind-handoff 0.4.6 → 0.4.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## 0.4.7（2026-10-03）
+
+包格式仍是 1.1。
+
+- 优化导出前核对：`generator` 和 `skills_manifest` 的版本必须是当次刚读到的。读不到就标未核实，或不放进清单。技能已更新就新开一份包，不在旧包上改指引却留着旧版本。
+
+
 ## 0.4.6（2026-10-03）
 
 包格式仍是 1.1。

package/README.md

@@ -25,7 +25,7 @@ Open Memory Protocol（提案）、W3C AI Agent Memory Interoperability CG（极
 ### 安装
 
 ```bash
-# npm 安装（v0.4.6+）
+# npm 安装（v0.4.7+）
 npm i @topmindspace/topmind-handoff
 # 或直接 clone
 git clone https://github.com/topmindspace/topmind-handoff.git
@@ -74,7 +74,7 @@ topmind-handoff/
 ---
 handoff_version: "1.1"
 generated_at: 2026-10-01T15:30:00+08:00
-generator: "Claude Code + topmind-handoff 0.4.6"
+generator: "Claude Code + topmind-handoff 0.4.7"
 language: zh-CN
 scope: private
 ---
@@ -103,4 +103,4 @@ scope: private
 
 ## 版本
 
-当前技能版本 `0.4.6`，交接包格式 `1.1`。更新记录见 `CHANGELOG.md`。
+当前技能版本 `0.4.7`，交接包格式 `1.1`。更新记录见 `CHANGELOG.md`。

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-handoff
-version: 0.4.6
+version: 0.4.7
 description: >-
   Cross-tool user handoff: export working habits, preferences, projects and
   memories into one portable Markdown package (Markdown + YAML frontmatter),
@@ -111,7 +111,9 @@ updated: 2026-10-03
    （是否建议过自行 commit/push、记下的分支 / 短 sha / remote、工作区是否仍脏、
    大文件的云端位置、小资料包相对路径）。用户点头后再落盘。
 7. **落盘**：按 `references/spec.md` 写 `<称呼>-handoff-YYYYMMDD.md`，
-   接收指引按 `language` 从规范照抄中文或英文模板，步骤相同，不混用。回执只给路径、各节条数、`origin_id`、技能清单、第 8 节摘要、第 9 节摘要。
+   接收指引按 `language` 从规范照抄中文或英文模板，步骤相同，不混用。
+   交出去之前核对：`generator` 里的技能版本、`skills_manifest` 里每一条，都是这次落笔前刚读到的（本机技能文件，或发布记录）。读不到就写「未核实」，或不放进清单，不要沿用旧包上的版本。技能已经更新，就新开 `package_id` 和新的 `generated_at`。不要改旧包的指引，却把 `generator` 留在旧版本。
+   回执只给路径、各节条数、`origin_id`、技能清单、第 8 节摘要、第 9 节摘要。
    云端未配置：先问要不要用、私有仓库和目录，不静默推送。公开仓库拒绝。
    已配置且用户没说「只本地」：先读云端 `generated_at` 最新的一份，把它当作当前事实；
    它没写清的，才看其他来源各自最新的一份。本环境看得到的照实写进新包，没看到且不矛盾的带上并注明来源，不写成「没有」。
@@ -188,6 +190,7 @@ updated: 2026-10-03
    见 `references/privacy.md`。
 4. **冲突不替用户拍板**。日期不同可以把较新日期列为建议；同一天或没日期必须问。
    `generated_at` 只选出哪一份包是当前事实，不决定包里某一条谁赢。锚点永不自动覆盖。
+   包上的技能版本必须是当次读到的。对不上就重开一份，不在旧包上留旧版本。
 5. **格式版本**：`handoff_version` 仍为 1.1。遇到不支持的大版本先停下，不强行解析。
    不认识的可选字段忽略，不报错。
 6. **不过度工程**：不搭服务、不装 SDK、不做签名、不写解析器、CRDT、数据库或自动合并代码。不自动安装技能。

package/assets/handoff-template.md

@@ -1,7 +1,7 @@
 ---
 handoff_version: "1.1"
 generated_at: YYYY-MM-DDTHH:MM:SS+08:00
-generator: "工具名 + topmind-handoff 0.4.6"
+generator: "工具名 + topmind-handoff 0.4.7"
 subject: "称呼（可选，可省略）"
 language: zh-CN
 scope: private

package/package.json

@@ -1 +1 @@
-{"author": "TopMindSpace", "bugs": {"url": "https://github.com/topmindspace/topmind-handoff/issues"}, "description": "跨工具用户上下文交接技能：把工作习惯、偏好、项目与记忆导出为便携 Markdown 交接包，或接收别家工具的交接包并安全合并。Cross-tool user handoff skill for AI agents.", "engines": {"node": ">=18"}, "files": ["SKILL.md", "references", "assets", "README.md", "LICENSE", "CHANGELOG.md"], "homepage": "https://github.com/topmindspace/topmind-handoff#readme", "keywords": ["agent-skills", "ai-skills", "handoff", "memory-portability", "user-profile", "onboarding"], "license": "MIT", "name": "@topmindspace/topmind-handoff", "publishConfig": {"access": "public"}, "repository": {"type": "git", "url": "git+https://github.com/topmindspace/topmind-handoff.git"}, "version": "0.4.6"}
+{"author": "TopMindSpace", "bugs": {"url": "https://github.com/topmindspace/topmind-handoff/issues"}, "description": "跨工具用户上下文交接技能：把工作习惯、偏好、项目与记忆导出为便携 Markdown 交接包，或接收别家工具的交接包并安全合并。Cross-tool user handoff skill for AI agents.", "engines": {"node": ">=18"}, "files": ["SKILL.md", "references", "assets", "README.md", "LICENSE", "CHANGELOG.md"], "homepage": "https://github.com/topmindspace/topmind-handoff#readme", "keywords": ["agent-skills", "ai-skills", "handoff", "memory-portability", "user-profile", "onboarding"], "license": "MIT", "name": "@topmindspace/topmind-handoff", "publishConfig": {"access": "public"}, "repository": {"type": "git", "url": "git+https://github.com/topmindspace/topmind-handoff.git"}, "version": "0.4.7"}

package/references/spec.md

@@ -146,7 +146,7 @@ frontmatter 之后、正文 `#` 标题之前，放一块固定的**接收指引*
 ---
 handoff_version: "1.1"          # 包格式版本。当前仍生成 1.1（1.0 包仍兼容）
 generated_at: 2026-10-01T15:30:00+08:00   # 整包导出时间，ISO 8601，带时区
-generator: "Claude Code + topmind-handoff 0.4.6"  # 工具名 + 技能版本
+generator: "Claude Code + topmind-handoff 0.4.7"  # 工具名 + 技能版本
 subject: "张三"                 # 可选
 language: zh-CN                # zh-CN / en
 scope: private                 # 只在用户自己的工具间流转
@@ -182,7 +182,7 @@ cloud_path: "handoff/"         # 可选 1.1：仓库内相对目录，缺省 han
 - `assets_bundle`（可选 1.1 扩展）：该包文件夹内、相对这份 markdown 的路径。没有小资料就省略。新包不再使用同级 `-assets/`。
   不写绝对家目录；用户名用 `~`。
 - `scope`：目前只有 `private`。不得把包发给第三方。
-- `generator` 里的技能版本（如 `topmind-handoff 0.4.6`）与 `package.json`、
+- `generator` 里的技能版本（如 `topmind-handoff 0.4.7`）与 `package.json`、
   `SKILL.md` frontmatter 一致。
   接收方用这个版本和本机技能比较；字符串里没有版本号就不要声称「更旧」。
 - `origin_id`、`package_id`、`device_note`、`cloud_repo`、`cloud_path`：都可选。