helixlife-expert-cli 0.1.0 → 0.3.0

package/README.md

@@ -2,15 +2,13 @@
 
 解螺旋 5.0 后台体系 · **科研专家合集** CLI。一个 npm 包提供六个专家命名空间，Skill 按专家拆分后单独交付，从而对外只暴露当前专家。
 
-不包含会员兑换。
-
-> **Skill 与 CLI 已分离**：`cli/skills/`（含各 `SKILL.md` 与 `references/`）不随本 npm 包发布。发给业务部门的是 Skill 目录，不是改 CLI 安装包。
+> **Skill 与 CLI 已分离**：`cli/skills/` 下各专家目录不随本 npm 包发布。发给用户的是单个专家 Skill 目录，不是改 CLI 安装包。
 
 ## 安装
 
 ```bash
 npm install -g helixlife-expert-cli
-# 请求凭证由外部环境写入 ~/.config/helixlife/user-access-token.txt，本 CLI 不提供授权/鉴权命令
+# 请求凭证由外部环境写入 ~/.config/helixlife/user-access-token.txt
 helixlife-expert upgrade             # 检查并按需升级到 npm 最新版
 ```
 
@@ -19,7 +17,7 @@ Token 与接口基址配置位于 `~/.config/helixlife/`：
 - 配置：`~/.config/helixlife/config.json`
 - Token：`~/.config/helixlife/user-access-token.txt`
 
-与解螺旋其他 CLI 共用同一目录下的凭证文件。本 CLI **不提供** `auth login` / `auth status` / `auth logout`。
+与解螺旋其他 CLI 共用同一目录下的凭证文件。
 
 ## 环境地址
 
@@ -46,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/
 ```
 
 ## 发布
@@ -61,23 +60,29 @@ npm publish
 
 ## Skill 交付
 
-> **发布约定**：本仓库 npm 包**不含** Skill。Agent 侧以 `cli/skills/` 下的目录为入口；替换 Agent 侧 Skill 目录即可，**不必**为此升 CLI 版本。
+> **发布约定**：本仓库 npm 包**不含** Skill。每次发给用户一个专家目录；替换 Agent 侧 Skill 即可，**不必**为此升 CLI 版本。
+
+安装 / 升级 / 错误码的正文只维护在 `cli/skills/_fragments/common.md`。数据分析、课题方案另有 `external-xt.md` / `external-newidea.md`，由 `npm run sync:skills` 追加到对应专家的 `references/common.md`。**不要**把 `_fragments` 或整个 `cli/skills/` 发给用户。
+
+### 交付某一个专家
 
-授权 / 安装 / 升级 / 错误码的正文只维护在 `cli/skills/_fragments/common.md`。修改后执行 `npm run sync:skills`，拷贝到各 Skill 的 `references/common.md`。`_fragments` **不要**发给业务部门。
+每次只发**一个**专家目录，不要发整个 `cli/skills/`（其中含 `_fragments` 与其他专家）。推荐：
 
-### 只提供某一个专家
+```bash
+npm run pack:skill -- meta    # 或 fund / sci / analysis / literature / proposal
+```
 
-只拷贝对应的一个文件夹，例如 Meta 分析专家：
+产物在 `dist-skills/helixlife-expert-meta/`。源目录结构如下：
 
 ```
 cli/skills/helixlife-expert-meta/
 ├── SKILL.md
 └── references/
-    ├── common.md      # 安装 / 授权 / 错误处理（自包含）
+    ├── common.md      # 安装 / 错误处理（自包含）
     └── meta.md        # 本专家细则
 ```
 
-该 Skill 写死只允许 `helixlife-expert meta …`，即使合集 CLI 里还有其他专家命令，Agent 也不会去调。
+该 Skill 写死只允许 `helixlife-expert meta …`，即使本机 CLI 里还有其他专家命令，Agent 也不会去调。
 
 | 专家 | Skill 目录 |
 | ---- | ---------- |
@@ -88,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 收窄到本领域。
-
 ## 目录结构
 
 ```
@@ -125,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.1.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": {