helixlife-expert-cli 0.2.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 解螺旋 5.0 后台体系 · **科研专家合集** CLI。一个 npm 包提供六个专家命名空间，Skill 按专家拆分后单独交付，从而对外只暴露当前专家。
 
-> **Skill 与 CLI 已分离**：`cli/skills/`（含各 `SKILL.md` 与 `references/`）不随本 npm 包发布。发给业务部门的是 Skill 目录，不是改 CLI 安装包。
+> **Skill 与 CLI 已分离**：`cli/skills/` 下各专家目录不随本 npm 包发布。发给用户的是单个专家 Skill 目录，不是改 CLI 安装包。
 
 ## 安装
 
@@ -44,7 +44,8 @@ helixlife-expert --version
 npm run dev           # 直接跑 TypeScript 入口
 npm run typecheck     # 类型检查
 npm test              # 单元测试
-npm run sync:skills   # 将共用环境说明同步到各 Skill 的 references/common.md
+npm run sync:skills          # 将共用环境说明同步到各 Skill 的 references/common.md
+npm run pack:skill -- meta   # 导出单个专家目录到 dist-skills/helixlife-expert-meta/
 ```
 
 ## 发布
@@ -59,13 +60,19 @@ npm publish
 
 ## Skill 交付
 
-> **发布约定**：本仓库 npm 包**不含** Skill。Agent 侧以 `cli/skills/` 下的目录为入口；替换 Agent 侧 Skill 目录即可，**不必**为此升 CLI 版本。
+> **发布约定**：本仓库 npm 包**不含** Skill。每次发给用户一个专家目录；替换 Agent 侧 Skill 即可，**不必**为此升 CLI 版本。
 
-安装 / 升级 / 错误码的正文只维护在 `cli/skills/_fragments/common.md`。修改后执行 `npm run sync:skills`，拷贝到各 Skill 的 `references/common.md`。`_fragments` **不要**发给业务部门。
+安装 / 升级 / 错误码的正文只维护在 `cli/skills/_fragments/common.md`。数据分析、课题方案另有 `external-xt.md` / `external-newidea.md`，由 `npm run sync:skills` 追加到对应专家的 `references/common.md`。**不要**把 `_fragments` 或整个 `cli/skills/` 发给用户。
 
-### 只提供某一个专家
+### 交付某一个专家
 
-只拷贝对应的一个文件夹，例如 Meta 分析专家：
+每次只发**一个**专家目录，不要发整个 `cli/skills/`（其中含 `_fragments` 与其他专家）。推荐：
+
+```bash
+npm run pack:skill -- meta    # 或 fund / sci / analysis / literature / proposal
+```
+
+产物在 `dist-skills/helixlife-expert-meta/`。源目录结构如下：
 
 ```
 cli/skills/helixlife-expert-meta/
@@ -75,7 +82,7 @@ cli/skills/helixlife-expert-meta/
     └── meta.md        # 本专家细则
 ```
 
-该 Skill 写死只允许 `helixlife-expert meta …`，即使合集 CLI 里还有其他专家命令，Agent 也不会去调。
+该 Skill 写死只允许 `helixlife-expert meta …`，即使本机 CLI 里还有其他专家命令，Agent 也不会去调。
 
 | 专家 | Skill 目录 |
 | ---- | ---------- |
@@ -86,23 +93,6 @@ cli/skills/helixlife-expert-meta/
 | 文献调研 | `cli/skills/helixlife-expert-literature/` |
 | 课题方案 | `cli/skills/helixlife-expert-proposal/` |
 
-### 提供全部专家
-
-拷贝 `cli/skills/` 下所有 `helixlife-expert-*` 目录（主 Skill + 六个专家 Skill），不要包含 `_fragments`。
-
-```
-cli/skills/
-├── helixlife-expert-cli/          # 全量路由入口
-├── helixlife-expert-meta/
-├── helixlife-expert-fund/
-├── helixlife-expert-sci/
-├── helixlife-expert-analysis/
-├── helixlife-expert-literature/
-└── helixlife-expert-proposal/
-```
-
-主 Skill 做意图路由，命中后只读对应专家 Skill；专家 Skill 的 description 收窄到本领域。
-
 ## 目录结构
 
 ```
@@ -123,7 +113,7 @@ helixlife-expert-cli/
     │       ├── literature/
     │       └── proposal/
     ├── tests/
-    └── skills/              # 本地开发用，不随 npm 发布
+    └── skills/              # 各专家 Skill，不随 npm 发布
 ```
 
 ## 命令命名空间

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helixlife-expert-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "helixlife 科研专家合集后台命令行工具",
   "bin": {
@@ -18,6 +18,7 @@
     "typecheck": "tsc -p cli/tsconfig.json --noEmit",
     "test": "tsx --test cli/tests/*.test.ts",
     "sync:skills": "node scripts/sync-skills.mjs",
+    "pack:skill": "node scripts/pack-skill.mjs",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {