@topmindspace/topmind-skills 4.15.5 → 4.15.6

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 (23) hide show
  1. package/CHANGELOG.md +12 -6
  2. package/INSTALL.md +97 -187
  3. package/README.en.md +74 -143
  4. package/README.md +74 -148
  5. package/README.zh-CN.md +2 -179
  6. package/evals/evals.json +1 -1
  7. package/integrations/codex/README.md +1 -1
  8. package/integrations/hermes/README.md +1 -1
  9. package/integrations/opencode/README.md +1 -1
  10. package/package.json +2 -2
  11. package/skills.md +25 -35
  12. package/topmind/SKILL.md +2 -2
  13. package/topmind-capture/SKILL.md +2 -2
  14. package/topmind-ledger/SKILL.md +2 -2
  15. package/topmind-loop/DESIGN.md +1 -1
  16. package/topmind-loop/SKILL.md +2 -2
  17. package/topmind-maintain/SKILL.md +3 -2
  18. package/topmind-memory/SKILL.md +3 -3
  19. package/topmind-organize/SKILL.md +4 -4
  20. package/topmind-pack.json +2 -2
  21. package/topmind-weread/SKILL.md +2 -2
  22. package/topmind-write/SKILL.md +2 -2
  23. package/topmind-x/SKILL.md +2 -2
package/CHANGELOG.md CHANGED
@@ -4,6 +4,16 @@ topmind-skills 的版本记录。GitHub 只保留最近 2 个 Release，本文
4
4
 
5
5
  版本真源：`topmind-pack.json`。`package.json`、每个 `SKILL.md` 的 `metadata.version`、`evals/evals.json` 与之一致。
6
6
 
7
+ ## 4.15.6 — 2026-10-24
8
+
9
+ ### 优化
10
+
11
+ - README（中文、英文）、`INSTALL.md`、`skills.md` 按用户视角重写：先讲安装和怎么用，去掉契约块和弃用名单，标题统一用中文。
12
+ - `README.zh-CN.md` 改为跳转页，中文说明只维护 `README.md` 一份。
13
+ - `topmind-loop/DESIGN.md` 的 UTR 命令数按 topmind 仓库 `TOOLS.md` 更新为 8 域 / 38 条。
14
+ - `topmind-memory` 周期反思的说明改写得更直白，语义不变。
15
+ - CHANGELOG 里只涉及发布流程与 CI 的条目压成一行。
16
+
7
17
  ## 4.15.5 — 2026-10-16
8
18
 
9
19
  ### 安装器
@@ -26,10 +36,7 @@ topmind-skills 的版本记录。GitHub 只保留最近 2 个 Release，本文
26
36
  ### 优化
27
37
 
28
38
  - 安装文档 `INSTALL.md` 的技能目录站点链接指向通用页面。
29
- - GitHub Actions 改用 Node 24 运行时的版本：`actions/checkout` v5 → v7、`actions/setup-node` v5 → v7、`actions/setup-python` v5 → v7、`actions/upload-artifact` v5 → v7；CI 与 Release 的 `node-version` 已是 24，不变。
30
- - `runs-on` 由 `ubuntu-latest` 固定为 `ubuntu-24.04`：GitHub 在 2026-10-19 至 11-19 期间把 `ubuntu-latest` 逐步切到 Ubuntu 26.04，先停在当前已验证的镜像，切 26.04 另行验证后再改。
31
- - `.gitignore` 补充 Release 附件、npm pack 输出等再生成产物。
32
- - 技能内容不变，仅版本号随包同步。
39
+ - 其余为发布流程与 CI 调整，技能内容不变。
33
40
 
34
41
  ## 4.15.2 — 2026-10-08
35
42
 
@@ -51,8 +58,7 @@ topmind-skills 的版本记录。GitHub 只保留最近 2 个 Release，本文
51
58
  - 安装器：安装外部技能仓库（没有 `topmind-pack.json` 的普通 Agent Skills 布局，例如写作包）时只装技能目录，不再把仓库根的 `evals/`、`LICENSE`、`README.md`、`INSTALL.md`、`install-targets/` 铺进宿主技能目录；只有 SKILL.md 链接了 `../shared/` 才带上 `shared/`；回执写到单独的 `.topmind-skills-install.<包名>.json`，不再覆盖 topmind 本包的回执。
52
59
  - `INSTALL.md`：去掉旧包 `@topmindspace/tms-skills` 的提法；写明 `npx skills` 不装 `shared/` 的后果（子文档打不开、路由消歧表缺席、宿主不报错）与补救步骤。
53
60
  - `evals/evals.json`：新增 8 条外部技能路由用例（公众号 2 条，含「不代发」；干货短文、引流短帖、X 长文、研究报告转幻灯片、交接、封面与长图各 1 条），字段 `external_skills` 由测试校验必须出现在消歧表里且不属于本包。
54
- - CI：引擎交叉校验的 checkout 不再 `continue-on-error`，3 项交叉校验每次都跑；新增官方校验器 `agentskills validate`（skills-ref 0.1.1）逐个检查技能。
55
- - Release：缺少 `NPM_TOKEN` 时「Publish to npm」步骤直接失败并给出提示，与其他 topmind 仓库一致，避免 Release 成功而 npm 未发布。
61
+ - 发布流程与 CI 调整（新增官方校验器检查每个技能）。
56
62
  - 新增本 CHANGELOG，并加入 npm 包。
57
63
 
58
64
  ### 包体积
package/INSTALL.md CHANGED
@@ -1,272 +1,182 @@
1
- # Install & update topmind Skills
1
+ # 安装与更新 topmind Skills
2
2
 
3
- [简体中文](./README.md) · [English](./README.en.md) · [产品](https://github.com/topmindspace/topmind)
3
+ [简体中文](./README.md) · [English](./README.en.md) · [产品总览](https://github.com/topmindspace/topmind)
4
4
 
5
- Repository: https://github.com/topmindspace/topmind-skills
6
- npm: [`@topmindspace/topmind-skills`](https://www.npmjs.com/package/@topmindspace/topmind-skills)
7
- Daily entry after install: **`topmind`**
5
+ 仓库：https://github.com/topmindspace/topmind-skills
6
+ npm：[`@topmindspace/topmind-skills`](https://www.npmjs.com/package/@topmindspace/topmind-skills)（需要 Node.js 20.11+）
7
+ 装好后的日常入口：`topmind`
8
8
 
9
- ```text
10
- canonical <base>/.agents/skills ← pack body (one copy)
11
- universal tools that read .agents/skills need nothing else
12
- private Claude Code / MiMoCode / Hermes … ← relative symlink (or --copy)
13
- ```
14
-
15
- 安装模型与开源生态 [`npx skills`](https://github.com/vercel-labs/skills) / [skills.sh](https://skills.sh) 对齐。旧包 `@topmindspace/tms-skills` 已不再维护，请改用 `@topmindspace/topmind-skills`。
9
+ 旧包 `@topmindspace/tms-skills` 已停止维护，请改用 `@topmindspace/topmind-skills`。
16
10
 
17
- ---
18
-
19
- ## Quick start
11
+ ## 快速开始
20
12
 
21
13
  ```bash
22
- # npm（推荐 · pack-aware · 含 shared/）
14
+ # 推荐：装到全局，自动给检测到的助手建链接
23
15
  npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
24
- npx @topmindspace/topmind-skills update -g
25
16
 
26
- # 社区 CLI（快速试用；不含 shared/ — 见下文）
27
- npx skills add topmindspace/topmind-skills -g -y
17
+ # 升级
18
+ npx @topmindspace/topmind-skills update -g
28
19
 
29
- # 从 GitHub Release（离线 / 固定版本）
30
- node bin/install-skills.mjs add release:latest -g
20
+ # 从 GitHub Release 安装（固定版本）
21
+ npx @topmindspace/topmind-skills add release:latest -g
31
22
  ```
32
23
 
33
- 已装 **topmind Desktop** 时也可在 **设置 → 关于与更新** 里对探测到的宿主一键安装 / 升级 / 卸载。
24
+ 已装 topmind Desktop 时，也可以在「设置 → 关于与更新」里对检测到的助手一键安装、升级或卸载。
34
25
 
35
- ---
26
+ ## 装到了哪里
36
27
 
37
- ## 安装模型（canonical + agents）
28
+ 安装方式和社区工具 [`npx skills`](https://github.com/vercel-labs/skills) 一致：整包只存一份，其他助手通过软链接读同一份。
38
29
 
39
- | 概念 | 路径 | 说明 |
40
- |------|------|------|
41
- | **Canonical** | `<base>/.agents/skills/` | 整包只存一份（project base = cwd，global base = `~`） |
42
- | **Universal** | 就是 `.agents/skills` | Codex / Cursor / Gemini CLI / Warp / Zed… 项目级**直接读** |
43
- | **Private** | `.claude/skills` · `.mimocode/skills` · `~/.codex/skills` … | 相对**软链**到 canonical（默认）；`--copy` 改为独立副本 |
30
+ | 位置 | 路径 | 说明 |
31
+ |---|---|---|
32
+ | 主目录 | `<base>/.agents/skills/` | 整包只存这一份。全局安装时 `<base>` 是用户主目录，项目安装时是当前目录 |
33
+ | 直接读主目录的助手 | 同上 | Codex、Cursor、Gemini CLI 等在项目级直接读 `.agents/skills` |
34
+ | 有自己目录的助手 | `.claude/skills`、`.mimocode/skills`、`~/.codex/skills` 等 | 默认建相对软链接指向主目录；加 `--copy` 改为独立副本 |
44
35
 
45
- 装完结构（global 示例）：
36
+ 全局安装后的样子：
46
37
 
47
38
  ```text
48
- ~/.agents/skills/ ← canonical（真身 + receipt）
49
- ├── topmind/SKILL.md ← 日常唯一入口
39
+ ~/.agents/skills/
40
+ ├── topmind/SKILL.md ← 日常入口
50
41
  ├── topmind-*/
51
42
  ├── shared/
52
43
  ├── topmind-pack.json
53
- └── .topmind-skills-install.json
44
+ └── .topmind-skills-install.json ← 安装记录，update 时读取
54
45
 
55
46
  ~/.claude/skills/topmind → ../../.agents/skills/topmind
56
47
  ~/.claude/skills/shared → ../../.agents/skills/shared
57
- ~/.config/mimocode/skills/topmind → ../../../.agents/skills/topmind
58
- …
59
48
  ```
60
49
 
61
- `../shared/*.md` 渐进披露：在 canonical 内解析到 `~/.agents/skills/shared`；经软链进入时同样落在 canonical 的 `shared/`（相对链接指向同一真身）。
62
-
63
- | 命令 | 作用 |
64
- |------|------|
65
- | `add <source>` | 默认 **matrix**：canonical + 已检测智能体 |
66
- | `add … -g` / `-p` | 全局 `~/.agents/skills` / 项目 `./.agents/skills` |
67
- | `add … -a claude-code -a mimocode` | 指定智能体（可多个；`'*'` 全部） |
68
- | `add … --copy` | 私有目录独立副本（默认软链） |
69
- | `add … --dest <dir>` | **只**装进一个目录（单宿主 / 兼容旧用法） |
70
- | `add … --host claude-code` | 兼容旧用法：单宿主默认 dest |
71
- | `update -g` | 从 canonical 里的 receipt 重装 |
72
- | `agents` · `paths` · `doctor [--repair]` | 智能体矩阵 / 路径 / 修复断链 |
73
-
74
- ---
75
-
76
- ## Installers
77
-
78
- ### A. npm / Pack-aware（推荐）
50
+ 技能文档里的 `../shared/*.md` 链接，无论从主目录还是从软链接进入，都指向同一份 `shared/`。
79
51
 
80
- 装齐 skill 目录 + `shared/` + `topmind-pack.json`，保证 `../shared/*.md` 渐进披露可用。
52
+ ## 常用命令
81
53
 
82
54
  ```bash
83
- # 矩阵：canonical .agents + 已检测智能体（全局）
84
- npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
85
-
86
- # 只喂给部分智能体
87
- npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g -a claude-code -a mimocode
55
+ # 只装给部分助手
56
+ npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g -a claude-code -a codex
88
57
 
89
- # 项目级
58
+ # 装到当前项目
90
59
  npx @topmindspace/topmind-skills add topmindspace/topmind-skills -p
91
60
 
92
- # 单目录（旧 --dest 仍可用）
61
+ # 只装进一个目录（不建链接）
93
62
  npx @topmindspace/topmind-skills add topmindspace/topmind-skills --dest ~/.claude/skills
94
63
 
95
- # 升级（读 receipt）：包里更新 → 直接覆盖，不备份，打印 Upgraded <skill> <旧> -> <新>；同版本 → Already up to date；已装更新 → 拒绝降级，需 --force
96
- npx @topmindspace/topmind-skills update -g
64
+ # 先看会装什么，不实际写入
65
+ npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g --dry-run
97
66
 
98
- # 查看
67
+ # 查看助手列表、安装路径；检查并修补断掉的软链接
99
68
  npx @topmindspace/topmind-skills agents
100
69
  npx @topmindspace/topmind-skills paths -g
101
70
  npx @topmindspace/topmind-skills doctor --repair
102
-
103
- # 本地开发：symlink 热更新（单目录）
104
- node bin/install-skills.mjs add . --mode symlink --dest ~/.claude/skills
105
-
106
- # Release zip
107
- node bin/install-skills.mjs add release:latest -g
108
71
  ```
109
72
 
110
- 私有仓：`export GH_TOKEN=…`（或 `GITHUB_TOKEN`）后再 `add`。
73
+ 升级规则：包里版本更新时直接覆盖，不留备份，打印 `Upgraded <技能> <旧> -> <新>`；版本相同跳过，打印 `Already up to date`（加 `--force` 重装）；已装版本比包里新时不降级，加 `--force` 才降级。
111
74
 
112
- ### B. Community CLI — `npx skills`
75
+ 私有仓库：先 `export GH_TOKEN=…`（或 `GITHUB_TOKEN`）再执行 `add`。
113
76
 
114
- 适用于认 Agent Skills 目录布局的 host。
77
+ ## 社区 CLI npx skills
78
+
79
+ 适合认 Agent Skills 目录结构的助手：
115
80
 
116
81
  ```bash
117
82
  npx skills add topmindspace/topmind-skills -g -y
118
- npx skills add topmindspace/topmind-skills -g -y -s topmind -s topmind-capture
83
+ npx skills add topmindspace/topmind-skills -g -y -s topmind -s topmind-capture # 只装部分技能
119
84
  npx skills update -g -y
120
- npx skills add topmindspace/topmind-skills -l
85
+ npx skills add topmindspace/topmind-skills -l # 只列出技能
121
86
  ```
122
87
 
123
- **注意：社区 CLI 不会装 `shared/`。** topmind skill 有 `../shared/*.md` 链接，缺了的后果：
88
+ 社区 CLI 不会装 `shared/`。缺了它：
124
89
 
125
- - 路由消歧表（`trigger-disambiguation.md`）、写回回执、能力降级、自动建议等子文档打不开，宿主只能按 SKILL.md 正文行事，碰撞词更容易路由错；
126
- - 用 `-s` 只装单个子技能时同样如此，且 router 不在场，多意图拆步不可用；
127
- - 宿主不会报错，看起来「装上了」，所以要主动补齐。
90
+ - 路由分工表、写回回执、能力降级、自动建议等文档打不开，助手只能按 `SKILL.md` 正文判断，相近的说法更容易路由错；
91
+ - 用 `-s` 只装单个技能时同样如此，而且没有入口 `topmind`，多步请求拆不开；
92
+ - 助手不会报错，看起来装上了，需要自己补齐。
128
93
 
129
- 补救：装完后再跑一次 pack-aware（或手动拷 `shared/`），然后用 `doctor` 检查：
94
+ 补齐方法：再用本包安装器装一次，然后检查：
130
95
 
131
96
  ```bash
132
97
  npx @topmindspace/topmind-skills add topmindspace/topmind-skills -g
133
- # 或
134
- cp -R /path/to/topmind-skills/shared ~/.agents/skills/shared
135
- # 检查
136
98
  npx @topmindspace/topmind-skills doctor
137
99
  ```
138
100
 
139
- 日志末尾若出现 `Failed to install 9` 且指向 **PromptScript**，是该 host 不支持 global 安装，可忽略；topmind 本身已装上。
140
-
141
- ---
101
+ 社区 CLI 日志末尾如果出现 `Failed to install 9` 并指向 PromptScript，是那个助手不支持全局安装，可以忽略。
142
102
 
143
- ## Source / options
103
+ ## 安装来源与参数
144
104
 
145
- | Source | 含义 |
146
- |--------|------|
147
- | `topmindspace/topmind-skills` | GitHub `owner/repo`，默认分支，pack 在仓根 |
148
- | `topmindspace/topmind-skills@v*` | 指定 ref / tag |
149
- | `https://github.com/topmindspace/topmind-skills.git` | 任意 git URL |
150
- | `./` / 绝对路径 | 本地 pack 根 |
105
+ | 来源 | 含义 |
106
+ |---|---|
107
+ | `topmindspace/topmind-skills` | GitHub 仓库默认分支 |
108
+ | `topmindspace/topmind-skills@v4.15.6` | 指定 tag 或分支 |
109
+ | `https://github.com/topmindspace/topmind-skills.git` | 任意 git 地址 |
110
+ | `.` 或绝对路径 | 本地检出 |
151
111
  | `release:latest` | GitHub Release 里的 `topmind-skills-*.zip` |
152
112
 
153
- | Option | 含义 |
154
- |--------|------|
155
- | `-g` / `--global` | **全局 scope**（canonical `~/.agents/skills`）— 与 `npx skills -g` 同义 |
156
- | `-p` / `--project` | 项目 scope（canonical `./.agents/skills`） |
157
- | `-a` / `--agent <ids>` | 目标智能体（可多个；`'*'` 全部） |
158
- | `--copy` | 私有目录复制而非软链 |
159
- | `--dest <dir>` | 只装进这个 skills 根（绕过矩阵） |
160
- | `--host <name>` | 兼容旧用法：单宿主默认 dest |
161
- | `--mode copy\|symlink` | 单目录安装模式（默认 copy） |
162
- | `--skill <id>` | 只装列出的 skill id |
163
- | `--locale en-US` | locale overlay（当前未提供 overlay，回退中文正文） |
113
+ | 参数 | 含义 |
114
+ |---|---|
115
+ | `-g` / `--global` | 全局安装，主目录 `~/.agents/skills`，与 `npx skills -g` 相同 |
116
+ | `-p` / `--project` | 项目安装，主目录 `./.agents/skills` |
117
+ | `-a` / `--agent <id>` | 目标助手，可重复或用逗号分隔；`'*'` 表示全部 |
118
+ | `--copy` | 给有自己目录的助手复制独立副本，不建软链接 |
119
+ | `--dest <dir>` | 只装进这一个目录 |
120
+ | `--host <name>` | 旧用法，按助手名选默认目录，等同单目录安装 |
121
+ | `--mode copy\|symlink` | 单目录安装的方式，默认 copy |
122
+ | `--skill <id>` | 只装指定技能 |
123
+ | `--locale <code>` | 安装语言版本；目前只有中文，其他值回退中文 |
164
124
  | `-n` / `--dry-run` | 只打印计划 |
165
- | `--force` | 允许降级（已装版本比包里新）、同版本重装、symlink 模式下替换无关目录。之前装过的同名 skill 普通目录（SKILL.md name 一致）在 symlink 模式下会直接换成软链，不需要 --force |
125
+ | `--force` | 允许降级、同版本重装，或在 symlink 模式下替换无关的同名目录 |
166
126
 
167
- ### Agents
127
+ ### 支持的助手
168
128
 
169
- | id | 项目路径 | 全局路径 | 类型 |
170
- |----|----------|----------|------|
171
- | `universal` | `.agents/skills` | `~/.agents/skills` | canonical |
172
- | `claude-code` | `.claude/skills` | `~/.claude/skills` | private |
173
- | `mimocode` | `.mimocode/skills` | `~/.config/mimocode/skills` | private |
174
- | `codex` | `.agents/skills` | `~/.codex/skills` | 项目 universal / 全局 private |
129
+ | id | 项目路径 | 全局路径 | 方式 |
130
+ |---|---|---|---|
131
+ | `universal` | `.agents/skills` | `~/.agents/skills` | 主目录 |
132
+ | `claude-code` | `.claude/skills` | `~/.claude/skills` | 软链接 |
133
+ | `mimocode` | `.mimocode/skills` | `~/.config/mimocode/skills` | 软链接 |
134
+ | `codex` | `.agents/skills` | `~/.codex/skills` | 项目直接读主目录，全局软链接 |
175
135
  | `cursor` | `.agents/skills` | `~/.cursor/skills` | 同上 |
176
136
  | `gemini-cli` | `.agents/skills` | `~/.gemini/skills` | 同上 |
177
137
  | `opencode` | `.agents/skills` | `~/.config/opencode/skills` | 同上 |
178
- | `hermes` | `.hermes/skills` | `~/.hermes/skills` | private |
179
- | `github-copilot` | `.agents/skills` | `~/.copilot/skills` | 项目 universal / 全局 private |
180
-
181
- 无 skill 系统的 host：把 `topmind/SKILL.md` 当 system 片段粘贴，`shared/` 按链接手动附上。
182
-
183
- ---
184
-
185
- ## Update
138
+ | `hermes` | `.hermes/skills` | `~/.hermes/skills` | 软链接 |
139
+ | `github-copilot` | `.agents/skills` | `~/.copilot/skills` | 项目直接读主目录，全局软链接 |
186
140
 
187
- 安装后 **canonical** 会写入 `.topmind-skills-install.json`（记录 `source` / `scope` / `agents` / `version`）：
141
+ 没有技能系统的助手：把 `topmind/SKILL.md` 当系统提示粘贴，`shared/` 里的文档按需附上。各助手的接入说明见 [`integrations/`](./integrations/)。
188
142
 
189
- ```bash
190
- npx @topmindspace/topmind-skills update -g
191
- # 或
192
- node bin/install-skills.mjs update -g
193
- # 社区 CLI
194
- npx skills update -g -y
195
- ```
196
-
197
- ---
198
-
199
- ## Zip 加载报 `SKILL.md not found`？
143
+ ## Release 压缩包
200
144
 
201
- Release 包是 **多 skill 组合包**：
145
+ Release 里的 `topmind-skills-<版本>.zip` 是多技能组合包：
202
146
 
203
147
  ```text
204
- topmind-skills-<ver>.zip
205
- └── topmind-skills-<ver>/
206
- ├── SKILL.md ← 根入口 = router
207
- ├── topmind/SKILL.md ← 推荐日常入口
208
- ├── topmind-*/
209
- └── shared/
148
+ topmind-skills-<版本>/
149
+ ├── SKILL.md ← 包根入口，内容同 topmind
150
+ ├── topmind/SKILL.md ← 推荐的日常入口
151
+ ├── topmind-*/
152
+ └── shared/
210
153
  ```
211
154
 
212
- | Host 行为 | 正确处理 |
213
- |-----------|----------|
214
- | 在 zip 根找 `SKILL.md` | 用包内根 `SKILL.md`（router） |
215
- | 扫描 `*/SKILL.md` | 装全部 `topmind*` 目录 + `shared/` |
216
- | `npx skills add` | 从 GitHub 仓根装（不依赖 zip 根） |
217
-
218
- `skills.md` 是包索引，不是 `SKILL.md` 的替代名。
219
-
220
- ---
155
+ 助手报 `SKILL.md not found` 时：在压缩包根找 `SKILL.md` 的，用包根入口；扫描 `*/SKILL.md` 的，把全部 `topmind*` 目录和 `shared/` 一起装。`skills.md` 是包索引，不能代替 `SKILL.md`。
221
156
 
222
- ## 发布（GitHub Release + npm）
157
+ ## 发布（维护者）
223
158
 
224
- 版本真源：`topmind-pack.json`（须与 `package.json` `version`、各 `SKILL.md` / `evals` 一致）。
159
+ 版本以 `topmind-pack.json` 为准，`package.json`、各 `SKILL.md` 的 `metadata.version`、`evals/evals.json` 要与它一致。
225
160
 
226
161
  ```bash
227
- # 1) 同步 bump 版本后校验
228
162
  npm test
229
- npm run pack # 可选：本地 dist 产物
230
-
231
- # 2) 提交并打 tag（推荐发版方式）
232
- git add . && git commit -m "chore: topmind-skills x.y.z"
163
+ npm run pack # 可选：本地生成 dist/ 产物
233
164
  git tag vX.Y.Z
234
165
  git push origin main vX.Y.Z
235
166
  ```
236
167
 
237
- push tag `v*` 后 CI 自动：
238
-
239
- 1. 测试 + 打包
240
- 2. 创建 GitHub Release（附 zip / tar.gz / manifest / SHA256SUMS / latest.json）
241
- 3. `npm publish` → [`@topmindspace/topmind-skills`](https://www.npmjs.com/package/@topmindspace/topmind-skills)（需仓库 Secret `NPM_TOKEN`，Automation token）
242
- 4. **只保留最近 2 个 GitHub Release**（删旧 Release 与附件）。git tag 保留。
168
+ 推送 `v*` tag 后 CI 会：
243
169
 
244
- | 渠道 | 触发 | 自动 |
245
- |------|------|------|
246
- | GitHub 仓库 / skills.sh | `git push` | 是（直连索引） |
247
- | GitHub Release | tag `v*` | 是 |
248
- | npm | tag `v*`（有 `NPM_TOKEN`） | 是 |
249
-
250
- 手动兜底（无 CI 时）：
251
-
252
- ```bash
253
- npm publish --access public
254
- ```
255
-
256
- ### skills.sh
257
-
258
- 公开 GitHub 仓即可被 `npx skills` / [skills.sh](https://skills.sh) 索引，无需额外注册：
259
-
260
- ```bash
261
- npx skills add topmindspace/topmind-skills -g -y
262
- npx skills add topmindspace/topmind-skills -l
263
- ```
170
+ 1. 跑测试并打包；
171
+ 2. 创建 GitHub Release（附 zip、tar.gz、manifest、SHA256SUMS、latest.json）；
172
+ 3. 发布 npm 包（需要仓库 Secret `NPM_TOKEN`，缺少时这一步直接失败）；
173
+ 4. 只保留最近 2 个 GitHub Release，git tag 保留。
264
174
 
265
- ---
175
+ 公开仓库会被 [skills.sh](https://skills.sh) 自动收录，不需要另外登记。
266
176
 
267
- ## Security
177
+ ## 安全
268
178
 
269
- - Skills 是 Markdown 指令；不信任的 fork 先审再装。
270
- - API Key 不要写进 skill 文件。
271
- - 安装器只写 canonical 与所选智能体技能根，不改其他目录。
272
- - 断链（第三方卸载残留）用 `doctor --repair` 修复，不要手删整棵技能树。
179
+ - 技能是 Markdown 指令，来路不明的 fork 先读再装。
180
+ - 不要把 API Key 写进技能文件。
181
+ - 安装器只写主目录和所选助手的技能目录，不动其他位置。
182
+ - 软链接断了（例如别的工具卸载后留下的）用 `doctor --repair` 修补，不要手动删整个技能目录。