@yottameta/yotta-skills 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # 更新日志
 
+## v0.1.2 (2026-08-29)
+
+安装方法清晰化：install.sh 用途与 README 中英「安装」章节对齐。
+
+- 修正 install.sh 头部注释：明确其只把「元阁安装器技能」本身装进智能体/目录（自带 SKILL.md，
+  让代理能调用元阁），并提示装齐 22 个 yotta-* 技能需再跑 `node bin/yotta-skills.js install`；
+  避免用户误以为 `bash install.sh` 一次就装齐全家。
+- 版本同步升至 0.1.2。
+
+## v0.1.1 (2026-08-29)
+
+文档修正：明确「元阁是全家安装器、与单个技能安装不同」。
+
+- 更正 README 中英版「安装」章节：先分清「拿到安装器」与「装齐全家」两层（元阁本身不内置 22 个技能本体）；方式二 git clone / 方式三 Download ZIP 示例由 `--list` 改为 `install --dir <目标目录>`；方式四 install.sh 说明「只把安装器技能本身装进智能体目录」，装齐 22 个技能仍需再跑一次 `install`。
+- 澄清：`--list` 只查看清单、不安装；克隆 / 解压只拿到安装器，不含任何技能本体。
+- SKILL.md 增补「与单个技能安装不同」说明；版本同步升至 0.1.1。
+
+
 ## v0.1.0 (2026-08-29)
 
 初始发布：

package/README.md

@@ -85,7 +85,9 @@ Supported agent keys (17): `claude` `cursor` `codex` `gemini` `goose` `amp` `ope
 
 ## Installation
 
-Pick any of the four methods below; the order is the recommended priority. The package always comes from **npm** (GitHub can be slow without a proxy; npm supports mirrors).
+> **Two layers first**: `yotta-skills` (元阁) is a **family installer**, not a skill itself — it ships no skill bodies. It pulls each of the 22 published `yotta-*` skills from its own npm package into your target directory, so **getting 元阁 is not the same as having the skills**. After you have the installer, run `install` once to actually place the whole family. A single skill (e.g. `@yottameta/yotta-memory`) is its own npm package and installs by itself; 元阁 is the **install everything at once** manager, so its install path is different.
+
+Pick any of the four methods below; the order is the recommended priority. The package always comes from **npm** (GitHub can be slow without a proxy; npm supports mirrors). Methods 2/3 only fetch the **installer**; method 4 places only the **installer skill** into an agent's skills directory — in each case you still run `install` to bring the whole family.
 
 ### Method 1: npm one-liner (recommended)
 
@@ -95,7 +97,7 @@ npx -y @yottameta/yotta-skills install --agent <agent-name>      # install the w
 npx -y @yottameta/yotta-skills install --dir <your-skills-dir>   # install the whole family to a directory (e.g. ~/.codex/skills)
 ```
 
-- `npx` fetches the latest `yotta-skills` automatically, so there is no separate installation step.
+- `npx` fetches the latest `yotta-skills` automatically, so there is no separate installation step; this is the only method that both gets the installer and installs the family in one command.
 - `--agent <name>` installs to that agent's default user-level directory; `--list` shows each agent's default directory.
 - `--dir <path>` installs to the given directory; for agents not in the preset list, point `--dir` at their skills directory.
 - If the mirror has not synced the new package (404): add `--registry=https://registry.npmjs.org/` (a proxy may be needed in China), or wait for the mirror cache.
@@ -105,21 +107,25 @@ npx -y @yottameta/yotta-skills install --dir <your-skills-dir>   # install the w
 ```text
 git clone https://github.com/YottaMeta/yotta-skills.git <your-skills-dir>/yotta-skills
 cd <your-skills-dir>/yotta-skills
-node bin/yotta-skills.js --list
+node bin/yotta-skills.js install --dir <your-skills-dir>
 ```
 
+- Cloning only fetches the **installer**; `--list` only prints the manifest and installs nothing. Run `install` to place the whole family into the target directory.
+
 ### Method 3: GitHub Download ZIP (manual / no git)
 
-On the GitHub repository `YottaMeta/yotta-skills`, click **Code → Download ZIP**, unzip it, then either run `node bin/yotta-skills.js --list` from the folder, or copy the `yotta-skills` folder into the agent's skills directory.
+On the GitHub repository `YottaMeta/yotta-skills`, click **Code → Download ZIP**, unzip it, then run `node bin/yotta-skills.js install --dir <your-skills-dir>`. Copying the `yotta-skills` folder into an agent's skills directory only makes the **installer skill** itself callable (it has its own `SKILL.md`) — it does not bring the 22 skills; run `install` for that.
 
 ### Method 4: install.sh (multi-agent one-liner script)
 
 ```text
-bash install.sh --agent <name>   # install this skill itself to the agent's default user-level directory
-bash install.sh --dir <path>     # install this skill itself to the given directory
+bash install.sh --agent <name>   # install the master installer skill to the agent's default user-level directory
+bash install.sh --dir <path>     # install the master installer skill to the given directory
 bash install.sh --list           # list agents -> default directories
 ```
 
+- `install.sh` places the **元阁 installer skill** itself so an agent can invoke the family installer. To install the 22 skills, run `node bin/yotta-skills.js install --agent <name>` (or `--dir <path>`).
+
 > Method 1 uses the npm registry (npmmirror / npmjs) and does not depend on GitHub; Methods 2/3 use GitHub and may fail without a proxy in China.
 
 ## Included skills

package/README.zh-CN.md

@@ -91,7 +91,9 @@ npx -y @yottameta/yotta-skills --dry-run
 
 ## 安装
 
-以下四种方式任选，顺序即推荐优先级；本包一律从 **npm** 获取（GitHub 无代理较慢，npm 支持镜像）。
+> **先分清两层**：`yotta-skills`（元阁）是「全家技能安装器」，本身**不含任何技能本体**。它所做的事是把已发布的 22 个 `yotta-*` 技能从各自 npm 包装进目标目录，所以「拿到元阁」不等于「已装齐技能」——拿到后还需运行一次 `install`，才会把全家真正放进目标目录。单个技能（如 `@yottameta/yotta-memory`）是各自独立的 npm 包、装自己即可；元阁是「一次装齐全家」的管理器，安装方式与此不同。
+
+下面四种方式任选，顺序即推荐优先级；本包一律从 **npm** 获取（GitHub 无代理较慢，npm 支持镜像）。方式二 / 三只「拿到安装器」；方式四只把「安装器技能」本身装进智能体目录——都仍需再跑一次 `install` 才装齐全家。
 
 ### 方式一：npm 一行装（推荐）
 
@@ -101,7 +103,7 @@ npx -y @yottameta/yotta-skills install --agent <智能体名称>      # 装全
 npx -y @yottameta/yotta-skills install --dir <你的技能目录>     # 装全家到指定目录（如 ~/.codex/skills）
 ```
 
-- `npx` 会自动拉取最新版 `yotta-skills`，无需单独安装步骤。
+- `npx` 会自动拉取最新版 `yotta-skills`，无需单独安装步骤；这是唯一「拿到安装器 + 装齐全家」一步到位的方式。
 - `--agent <name>` 自动装到该智能体默认用户级目录；`--list` 可查看各智能体默认目录。
 - `--dir <路径>` 装到指定的技能目录；未收录的智能体用 `--dir` 指到它的技能目录。
 - npmmirror 未同步新包（404）：加 `--registry=https://registry.npmjs.org/`（国内需代理），或稍等镜像缓存。
@@ -111,22 +113,25 @@ npx -y @yottameta/yotta-skills install --dir <你的技能目录>     # 装全
 ```text
 git clone https://github.com/YottaMeta/yotta-skills.git <你的技能目录>/yotta-skills
 cd <你的技能目录>/yotta-skills
-node bin/yotta-skills.js --list
+node bin/yotta-skills.js install --dir <你的技能目录>
 ```
 
+- 克隆只拿到**安装器**；`--list` 只会打印清单、不安装任何东西。跑 `install` 才会把全家装进目标目录。
+
 ### 方式三：GitHub 下载压缩包（手动 / 无 git 环境）
 
-在 GitHub 仓库 `YottaMeta/yotta-skills` 点 **Code → Download ZIP**，解压后直接在目录里跑
-`node bin/yotta-skills.js --list`，或把 `yotta-skills` 文件夹放进智能体技能目录。
+在 GitHub 仓库 `YottaMeta/yotta-skills` 点 **Code → Download ZIP**，解压后跑 `node bin/yotta-skills.js install --dir <你的技能目录>` 装齐全家。把 `yotta-skills` 文件夹放进智能体技能目录只让**安装器技能**本身可被调用（它有自己的 `SKILL.md`），并不会把 22 个技能一并带进去——那仍需跑 `install`。
 
 ### 方式四：install.sh（多智能体一键脚本）
 
 ```text
-bash install.sh --agent <name>   # 把本技能本身装到指定智能体默认用户级目录
-bash install.sh --dir <path>     # 把本技能本身装到指定目录
+bash install.sh --agent <name>   # 把「安装器技能」本身装到指定智能体默认用户级目录
+bash install.sh --dir <path>     # 把「安装器技能」本身装到指定目录
 bash install.sh --list           # 列出智能体 -> 默认目录
 ```
 
+- `install.sh` 把「元阁安装器技能」本身装进智能体 / 目录，让代理能调用元阁；要装齐 22 个技能，再执行 `node bin/yotta-skills.js install --agent <name>`（或 `--dir <path>`）。
+
 > 方式一走 npm 源（npmmirror / npmjs），不依赖 GitHub；方式二 / 三走 GitHub，国内无代理可能失败。
 
 ## 全家技能清单

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yotta-skills
-version: 0.1.0
+version: 0.1.2
 description: 元阁 —— 全家技能一键安装 CLI：一条命令把 YottaMeta 已发布的全部 yotta-* 技能（当前 22 个）装进指定智能体或目录；支持 --list 清单 / install / update / --dry-run 预览 / --pin 锁版本；幂等、零依赖（Node.js 18+）、纯 npm 生态，不内置任何技能本体。触发：需要批量安装或更新元阁全家技能、给某个智能体或目录一次性铺齐 yotta-* 技能、预览安装清单、锁版本安装时；或用户说 元阁/装全家/一次装齐/yotta-skills/install-all/更新全家 等。边界（Do NOT trigger）：只做「清单 + 下载 + 落位 + 汇总」，不含技能本体、不做技能内容开发、不 -g 污染全局；装前摘要仅供参考，安装决策由用户确认。
 license: MIT
 metadata:
@@ -14,7 +14,9 @@ metadata:
 `install` 一次装齐、`update` 增量更新、`--dry-run` 先预览、`--pin` 锁版本。
 
 每个技能仍走各自独立的 npm 包（版本源唯一）；本包只做「清单 + 下载 + 落位 + 汇总」，
-**不内置任何技能本体**，体积极小。运行依赖仅 Node.js 18+ / npm / 系统 tar。
+**不内置任何技能本体**，体积极小。运行依赖仅 Node.js 18+ / npm / 系统 tar。
+> **与单个技能安装不同**：元阁是「全家安装器」，本身不含任何技能本体。把它拿到手只代表你有了安装工具；要真正装齐全家，需运行 `install` 把 22 个技能从各自 npm 包装进目标目录。
+
 
 ## 何时使用
 

package/bin/yotta-skills.js

@@ -22,7 +22,7 @@ const os = require('os');
 const { spawnSync } = require('child_process');
 
 const PKG_ROOT = path.join(__dirname, '..');
-let VERSION = '0.1.0';
+let VERSION = '0.1.2';
 try { VERSION = require(path.join(PKG_ROOT, 'package.json')).version; } catch (_) { /* keep fallback */ }
 
 function loadManifest() {

package/install.sh

@@ -1,7 +1,10 @@
 #!/usr/bin/env bash
 # yotta-skills（元阁）多智能体安装脚本（YottaSkills）
+# 用途：把「元阁安装器技能」本身装进智能体/目录（它自带 SKILL.md，让代理能调用元阁）。
+# 注意：这**不是**把 22 个 yotta-* 技能一并装齐——装全家需再跑
+#       `node bin/yotta-skills.js install --agent <name>`（或 --dir <path>）。
 # 用法:
-#   bash install.sh --agent <name>  # 按智能体默认用户级目录安装
+#   bash install.sh --agent <name>  # 把安装器技能装到智能体默认用户级目录
 #   bash install.sh --dir <path>    # 装到指定目录（用户改过目录的智能体）
 #   bash install.sh -g              # 装到全部已知智能体用户级目录
 #   bash install.sh                  # 检测并安装到已存在的项目级目录

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottameta/yotta-skills",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "YuanGe (元阁) — one-command installer for the whole YottaMeta skill family: list, install, and update all published yotta-* skills into any agent (npx one-shot, zero dependencies, Node.js only).",
   "license": "MIT",
   "keywords": [