npm - @topmindspace/topmind-skills - Versions diffs - 4.13.0 → 4.13.1 - Mend

@topmindspace/topmind-skills 4.13.0 → 4.13.1

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.

Files changed (18) hide show

package/INSTALL.md CHANGED Viewed

@@ -19,11 +19,41 @@ Dest    examples:  $HOME/.claude/skills   ./.claude/skills   $HOME/.codex/skills
 ```
 Repository: https://github.com/topmindspace/topmind-skills
+npm: [`@topmindspace/topmind-skills`](https://www.npmjs.com/package/@topmindspace/topmind-skills)
 Daily entry after install: **`topmind`**
 ---
-## 0. Via Desktop（推荐 · 探测 + 装/升/卸）
+## 0. Via npm（推荐 · pack-aware · 含 shared/）
+```bash
+# 安装到 Claude Code 用户全局 skills
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
+# 升级（读 dest 回执，重新拉同一源）
+npx @topmindspace/topmind-skills update -g
+# 只看会装什么
+npx @topmindspace/topmind-skills list topmindspace/topmind-skills
+# 指定宿主 / 目标目录
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills --host codex
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills --dest ./.claude/skills
+```
+也可以全局安装 CLI：
+```bash
+npm i -g @topmindspace/topmind-skills
+topmind-skills add topmindspace/topmind-skills -g
+```
+> npm 包与 GitHub 仓库同一内容真源（`topmind-pack.json` 版本对齐）。
+> **GitHub skills 更新不会自动同步到 npm**——需要 bump 版本后 `npm publish`（或走 tag 触发的 Release 自动发布，见下文）。
+---
+## 0b. Via Desktop（推荐 · 探测 + 装/升/卸）
 若已安装 **topmind Desktop**，不必先跑 CLI：
@@ -60,14 +90,56 @@ Daily entry after install: **`topmind`**
    ```
 4. **生态发现与在线安装**：
    发布后，全球开发者即可通过以下方式发现与安装：
+   - **npm（推荐）**：`npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g`
    - **CLI 直接索引**：`npx skills add topmindspace/topmind-skills -g -y`
    - **查看目录**：`npx skills add topmindspace/topmind-skills -l`
    - **网页版浏览**：访问 `https://skills.sh/topmindspace/topmind-skills`
+   - **npm 包页**：https://www.npmjs.com/package/@topmindspace/topmind-skills
+---
+## Publishing to npm（@topmindspace/topmind-skills）
+包名：[`@topmindspace/topmind-skills`](https://www.npmjs.com/package/@topmindspace/topmind-skills)
+Org：`topmindspace` · 访问级别：`public` · 版本真源：`topmind-pack.json`（须与 `package.json` `version` 一致）
+```bash
+# 1) 同步版本（package.json + topmind-pack.json + 各 SKILL.md）
+npm test
+# 2) 发布（需 npmjs 登录；scoped public 包）
+npm publish --access public
+# package.json 已配置 publishConfig.access=public，直接 npm publish 亦可
+# 3) 验证
+npm view @topmindspace/topmind-skills
+npx @topmindspace/topmind-skills --help
+```
+### GitHub 更新后 npm 会自动更新吗？
+**不会。** GitHub 仓库 push / skills 内容变更 **不会** 自动发布到 npmjs。
+| 渠道 | 触发 | 是否自动 |
+|------|------|----------|
+| GitHub 仓库 / skills.sh | `git push` | 是（直连索引） |
+| GitHub Release | push tag `v*` | 是（CI 打包 Release） |
+| npm `@topmindspace/topmind-skills` | `npm publish` | **否**（需手动，或依赖下述 tag 自动发布） |
+若要在打 tag 发 Release 时 **自动同步 npm**：
+1. 在 GitHub 仓库 Secrets 配置 `NPM_TOKEN`（Automation 类型 token，来自 npmjs → Access Tokens）
+2. Release workflow 会在创建 GitHub Release 后执行 `npm publish`
+3. 流程：改 skills → 同步 bump `package.json` + `topmind-pack.json` + 各 `SKILL.md` 版本 → commit → `git tag vX.Y.Z && git push origin vX.Y.Z` → CI 自动发 GitHub Release **并** publish npm
+没有 `NPM_TOKEN` 时，npm 发布步骤会跳过，不影响 GitHub Release。
 ---
 ## Two installers (pick one)
+> 优先用上文 **§0 Via npm**（`npx @topmindspace/topmind-skills …`）——它就是 B 的 pack-aware 安装器，且自动带上 `shared/`。下面 A/B 说明底层两种安装路径。
 ### A. Community CLI — `npx skills`（和开源 skills 生态一致）
 已验证：本仓库可被直接发现 pack 内全部 skill（含可选 weread / x / ledger）。
@@ -193,8 +265,15 @@ node bin/install-skills.mjs list topmindspace/topmind-skills
 根脚本别名：
 ```bash
-npm run install -- add topmindspace/topmind-skills -g
+npm run add -- topmindspace/topmind-skills -g
 npm run update -- --dest $HOME/.claude/skills
+npm run list -- topmindspace/topmind-skills
+```
+或直接用 npm 包 CLI（无需 clone）：
+```bash
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
 ```
 私有仓：

package/README.en.md CHANGED Viewed

@@ -2,21 +2,22 @@
 Portable AI skill pack: the same content contract on Claude Code / Codex / OpenCode / Hermes and other hosts.
-[简体中文](README.md) · [English](README.en.md) · [Product](https://github.com/topmindspace/topmind) · [Install](./INSTALL.md) · [Publish to skills.sh](./INSTALL.md#publishing-to-skillssh--open-agent-skills-registry)
+[简体中文](README.md) · [English](README.en.md) · [Product](https://github.com/topmindspace/topmind) · [Install](./INSTALL.md) · [Publish to skills.sh](./INSTALL.md#publishing-to-skillssh--open-agent-skills-registry) · [npm](https://www.npmjs.com/package/@topmindspace/topmind-skills)
 ```bash
-# 1) Community CLI (fast try; may omit shared/)
+# 1) npm (recommended · pack-aware · includes shared/)
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
+# upgrade
+npx @topmindspace/topmind-skills update -g
+# 2) Community CLI (fast try; may omit shared/)
 npx skills add topmindspace/topmind-skills -g -y
-# 2) Pack-aware installer (recommended · includes shared/ · writes receipt)
-# From a topmind-skills checkout:
-npm run install -- add topmindspace/topmind-skills -g
+# 3) Pack-aware installer (from a source checkout)
+npm run add -- topmindspace/topmind-skills -g
 npm run update -- --dest $HOME/.claude/skills
-# Or without clone — run installer from GitHub:
-npx --yes github:topmindspace/topmind-skills install -g
-# 3) From GitHub Release (pinned version / offline)
+# 4) From GitHub Release (pinned version / offline)
 node bin/install-skills.mjs add release:latest -g
 # or after downloading topmind-skills-<ver>.zip:
 # node bin/install-skills.mjs add ./unpacked --dest $HOME/.claude/skills

package/README.md CHANGED Viewed

@@ -2,21 +2,22 @@
 可移植 AI 技能包：在 Claude Code / Codex / OpenCode / Hermes 等 Host 上使用同一套内容约定。
-[简体中文](README.md) · [English](README.en.md) · [产品总览](https://github.com/topmindspace/topmind) · [安装与发布](./INSTALL.md) · [发布到 skills.sh](./INSTALL.md#publishing-to-skillssh--open-agent-skills-registry)
+[简体中文](README.md) · [English](README.en.md) · [产品总览](https://github.com/topmindspace/topmind) · [安装与发布](./INSTALL.md) · [发布到 skills.sh](./INSTALL.md#publishing-to-skillssh--open-agent-skills-registry) · [npm](https://www.npmjs.com/package/@topmindspace/topmind-skills)
 ```bash
-# 1) 社区 CLI（快速试用；可能不含 shared/）
+# 1) npm（推荐 · pack-aware · 含 shared/）
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
+# 升级
+npx @topmindspace/topmind-skills update -g
+# 2) 社区 CLI（快速试用；可能不含 shared/）
 npx skills add topmindspace/topmind-skills -g -y
-# 2) Pack-aware 安装器（推荐生产 · 含 shared/ · 可写回执）
-# 在 topmind-skills 仓内：
-npm run install -- add topmindspace/topmind-skills -g
+# 3) Pack-aware 安装器（源码仓内）
+npm run add -- topmindspace/topmind-skills -g
 npm run update -- --dest $HOME/.claude/skills
-# 或不 clone，直接用 npx 跑 GitHub 上的安装器：
-npx --yes github:topmindspace/topmind-skills install -g
-# 3) 从 GitHub Release 装（离线/固定版本）
+# 4) 从 GitHub Release 装（离线/固定版本）
 node bin/install-skills.mjs add release:latest -g
 # 或下载 topmind-skills-<ver>.zip 后：
 # node bin/install-skills.mjs add ./unpacked --dest $HOME/.claude/skills
@@ -157,6 +158,10 @@ degradation: ../shared/capability-degradation.md
 ## 安装目标
 已打包的 skill 目录（7 个核心 + 2 个可选连接器 + 可选记账）可以符号链接或复制到 Claude Code、Codex、OpenCode、Hermes 等。
-优先使用 pack-aware 安装器，保证 `shared/` 与 `topmind-pack.json` 完整 — 见 [`INSTALL.md`](./INSTALL.md)。
+优先使用 npm / pack-aware 安装器，保证 `shared/` 与 `topmind-pack.json` 完整 — 见 [`INSTALL.md`](./INSTALL.md)。
+```bash
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
+```
 Host 适配器**不得**改变内容真源、新增并列日常入口，或把内容存进 agent 运行态。见 [`../PRODUCT-BOUNDARIES.md`](../PRODUCT-BOUNDARIES.md)。

package/README.zh-CN.md CHANGED Viewed

@@ -2,21 +2,22 @@
 可移植 AI 技能包：在 Claude Code / Codex / OpenCode / Hermes 等 Host 上使用同一套内容约定。
-[简体中文](README.md) · [English](README.en.md) · [产品总览](https://github.com/topmindspace/topmind) · [安装与发布](./INSTALL.md) · [发布到 skills.sh](./INSTALL.md#publishing-to-skillssh--open-agent-skills-registry)
+[简体中文](README.md) · [English](README.en.md) · [产品总览](https://github.com/topmindspace/topmind) · [安装与发布](./INSTALL.md) · [发布到 skills.sh](./INSTALL.md#publishing-to-skillssh--open-agent-skills-registry) · [npm](https://www.npmjs.com/package/@topmindspace/topmind-skills)
 ```bash
-# 1) 社区 CLI（快速试用；可能不含 shared/）
+# 1) npm（推荐 · pack-aware · 含 shared/）
+npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
+# 升级
+npx @topmindspace/topmind-skills update -g
+# 2) 社区 CLI（快速试用；可能不含 shared/）
 npx skills add topmindspace/topmind-skills -g -y
-# 2) Pack-aware 安装器（推荐生产 · 含 shared/ · 可写回执）
-# 在 topmind-skills 仓内：
-npm run install -- add topmindspace/topmind-skills -g
+# 3) Pack-aware 安装器（源码仓内）
+npm run add -- topmindspace/topmind-skills -g
 npm run update -- --dest $HOME/.claude/skills
-# 或不 clone，直接用 npx 跑 GitHub 上的安装器：
-npx --yes github:topmindspace/topmind-skills install -g
-# 3) 从 GitHub Release 装（离线/固定版本）
+# 4) 从 GitHub Release 装（离线/固定版本）
 node bin/install-skills.mjs add release:latest -g
 # 或下载 topmind-skills-<ver>.zip 后：
 # node bin/install-skills.mjs add ./unpacked --dest $HOME/.claude/skills

package/evals/evals.json CHANGED Viewed

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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-skills",
-  "version": "4.13.0",
+  "version": "4.13.1",
   "description": "topmind Agent Skills pack — portable markdown skills for capture, organize, write, memory, maintain, loop.",
   "type": "module",
   "license": "MIT",

package/topmind/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind
-version: 4.13.0
+version: 4.13.1
 description: >-
   topmind 总入口与多意图路由（类别/专题/笔记/交付）。Use when 用户说 topmind、意图模糊、或需要
   收→整→写 分步。单意图明确时直接用 topmind-capture|organize|write|memory|maintain|loop|weread|x|ledger|wechat。

package/topmind-capture/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-capture
-version: 4.13.0
+version: 4.13.1
 description: >-
   把链接、摘录、随手记收进动态周期本、Inbox 或专题。Use when 记一下、收进、剪藏、保存链接、capture、save URL/idea。
   Do NOT use for 整理本周、出稿、写我的情况、doctor/loop、微信读书、X.

package/topmind-ledger/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-ledger
-version: 4.13.0
+version: 4.13.1
 description: >-
   通用记账到记忆平面（默认个人/自己账本，用户自建账本与分类）。Use when 记账、记一笔、花了、存入、查看账单、账户余额。
   Do NOT use for 记一下到动态、待办、微信读书、发推、Feishu/lark-cli.

package/topmind-loop/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-loop
-version: 4.13.0
+version: 4.13.1
 description: >-
   可中断的工作区语义巡检（走专题/Inbox，.loop 断点续跑）。Use when 跑一遍 loop、巡检、整体体检、复盘、
   继续 loop、audit。Do NOT use for 快速 doctor（→maintain）、单专题整理、捕获、写作、仅记忆.

package/topmind-maintain/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-maintain
-version: 4.13.0
+version: 4.13.1
 description: >-
   确定性体检/清理/结构修复/回执恢复。Use when 快速体检、诊断、doctor、清理、修复、workspace check。
   Do NOT use for 整体巡检 loop、内容整理、捕获、写作、记忆.

package/topmind-memory/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-memory
-version: 4.13.0
+version: 4.13.1
 description: >-
   更新「我的情况」或周期反思。Use when 记住这个、更新我的情况、加到专题记忆、沉淀结论。
   Do NOT use for 捕获、仅总结（→organize）、整理本周正文、出稿、开/并专题、doctor/loop.

package/topmind-organize/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-organize
-version: 4.13.0
+version: 4.13.1
 description: >-
   整理本周动态、专题内整理/研究/分析/路由 Inbox。Use when 整理本周、整理、分析、研究、对比、总结要点、organize、summarize。
   Do NOT use for 首次捕获、最终出稿、仅写我的情况、快速 doctor、全库 loop.

package/topmind-pack.json CHANGED Viewed

@@ -4,8 +4,8 @@
   "label": "topmind",
   "description": "topmind skill pack: single daily entry topmind + progressive disclosure (shared/ + references/), Agent Skills open-standard aligned, capture-first template-driven categories, optional weread/x connectors and optional ledger (记账). File-system-first content truth; UTR optional.",
   "daily_entry": "topmind",
-  "version": "4.13.0",
-  "updated": "2026-09-23",
+  "version": "4.13.1",
+  "updated": "2026-09-24",
   "license": "MIT",
   "locales": {
     "default": "zh-CN",

package/topmind-wechat/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-wechat
-version: 4.13.0
+version: 4.13.1
 description: >-
   公众号文章全生命周期子技能（write 族）：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
   支持 forward（底稿→公众号）、reverse（选题原创→回推）、站外拉取（在线精选站→reverse+pending）三条路径；

package/topmind-weread/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-weread
-version: 4.13.0
+version: 4.13.1
 description: >-
   同步微信读书划线/想法/统计到专题。Use when 微信读书、划线同步、weread、读书笔记。
   Do NOT use for 普通 URL 捕获、仅整理、出稿、X.

package/topmind-write/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-write
-version: 4.13.0
+version: 4.13.1
 description: >-
   写作/润色/出稿到专题或交付层（role:delivery）。Use when 写、起草、续写、润色、出稿、交付、write、draft、deliver。
   Do NOT use for 仅捕获、仅结构整理、只写记忆、doctor/loop、社交连接器.

package/topmind-x/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: topmind-x
-version: 4.13.0
+version: 4.13.1
 description: >-
   X/Twitter：归档/搜索（Bearer）、发帖（xurl）、Agent 可用官方 MCP。Use when 发推、推特、twitter、x.com。
   Do NOT use for 微信读书、非 X 捕获、doctor、长文交付.