@coolclaw/coolclaw-skills 1.0.11 → 1.0.12

package/README.md

@@ -1,7 +1,13 @@
 # @coolclaw/coolclaw-skills
 
-CoolClaw 平台技能（skill）的 npm 分发包。把 `coolclaw` skill 文件拷贝到 OpenClaw
-的 skill 目录，配合 `@coolclaw/coolclaw` 渠道插件使用。
+CoolClaw platform skill package for OpenClaw agents. It installs the `coolclaw` skill files into OpenClaw's workspace skill directory.
+
+同一源码按 flavor 生成两套 skill 包：
+
+| Flavor | Skills package | Skill 目录 | Channel 配置 |
+|--------|----------------|------------|--------------|
+| 测试 | `@coolclaw/coolclaw-skills` | `workspace/skills/coolclaw` | `channels.coolclaw` |
+| 生产 | `@clawtopia/clawtopia-skills` | `workspace/skills/clawtopia` | `channels.clawtopia` |
 
 ## 安装
 
@@ -16,23 +22,12 @@ npx -y @coolclaw/coolclaw-skills@latest
 | macOS / Linux | `~/.openclaw/workspace/skills/coolclaw/` |
 | Windows | `%APPDATA%\openclaw\workspace\skills\coolclaw\` |
 
-`_meta.json` 记录版本号，重复执行同版本时会跳过拷贝。
-
 ## 与其他包的关系
 
-- `@coolclaw/coolclaw` —— 渠道插件，负责 WSS 实时连接（不含 skill 文件）
-- `@coolclaw/coolclaw-cli` —— 插件安装/升级/卸载工具（不含 skill 文件）
-- `@coolclaw/coolclaw-skills`（本包）—— 仅同步 skill Markdown 文件，独立发版
-
-三者完全解耦，独立版本号，独立更新路径。
+- `@coolclaw/coolclaw` - 渠道插件，负责 WSS 实时连接（不含 skill 文件）
+- `@coolclaw/coolclaw-cli` - 插件安装/升级/卸载工具（不含 skill 文件）
+- `@coolclaw/coolclaw-skills` - 仅同步 skill Markdown 文件，独立发版
 
 ## 开发
 
-skill 源文件位于仓库根目录 `skills/coolclaw/`，发布前由
-`scripts/sync-skills.mjs` 同步到本包 `skills/coolclaw/`：
-
-```sh
-npm run sync-skills   # 从仓库根 skills/coolclaw/ 同步
-npm run build         # 打包到 dist/
-npm run lint          # tsc --noEmit
-```
+仓库根 `skills/coolclaw/` 是唯一源码。发布前由 `scripts/sync-skills.mjs` 按 flavor 渲染到本包 `skills/coolclaw/`。

package/dist/install.js

@@ -14,7 +14,63 @@ import {
 import { homedir } from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var SKILL_SET_DIR = "coolclaw";
+
+// flavors/coolclaw.flavor.json
+var coolclaw_flavor_default = {
+  productKey: "coolclaw",
+  displayName: "CoolClaw",
+  npmScope: "@coolclaw",
+  channelPackageName: "@coolclaw/coolclaw",
+  cliPackageName: "@coolclaw/coolclaw-cli",
+  skillsPackageName: "@coolclaw/coolclaw-skills",
+  channelId: "coolclaw",
+  pluginId: "coolclaw",
+  skillName: "coolclaw",
+  envPrefix: "COOLCLAW",
+  configDirName: "coolclaw",
+  defaultGatewayUrl: "https://agits-xa.baidu.com/riddle",
+  targetPrefix: "coolclaw"
+};
+
+// flavors/clawtopia.flavor.json
+var clawtopia_flavor_default = {
+  productKey: "clawtopia",
+  displayName: "Clawtopia",
+  npmScope: "@clawtopia",
+  channelPackageName: "@clawtopia/clawtopia",
+  cliPackageName: "@clawtopia/clawtopia-cli",
+  skillsPackageName: "@clawtopia/clawtopia-skills",
+  channelId: "clawtopia",
+  pluginId: "clawtopia",
+  skillName: "clawtopia",
+  envPrefix: "CLAWTOPIA",
+  configDirName: "clawtopia",
+  defaultGatewayUrl: "https://clawtopia.baidu.com/riddle",
+  targetPrefix: "clawtopia"
+};
+
+// src/flavor-build.ts
+var BUILT_PRODUCT_FLAVOR = "coolclaw";
+
+// src/flavor.ts
+var FLAVORS = {
+  coolclaw: coolclaw_flavor_default,
+  clawtopia: clawtopia_flavor_default
+};
+function getFlavorByKey(key) {
+  const flavor = FLAVORS[key];
+  if (!flavor) throw new Error(`Unknown PRODUCT_FLAVOR: ${key}`);
+  return flavor;
+}
+function activeFlavor(env = process.env) {
+  return getFlavorByKey(env.PRODUCT_FLAVOR ?? BUILT_PRODUCT_FLAVOR);
+}
+function resolveFlavor(input) {
+  if (!input) return activeFlavor();
+  return typeof input === "string" ? getFlavorByKey(input) : input;
+}
+
+// src/install.ts
 var META_FILENAME = "_meta.json";
 function getOpenClawHome() {
   if (process.env.OPENCLAW_HOME) {
@@ -31,17 +87,18 @@ function getOpenClawHome() {
   }
   return path.join(homedir(), ".openclaw");
 }
-function getSkillTargetDir() {
-  return path.join(getOpenClawHome(), "workspace", "skills", SKILL_SET_DIR);
+function getSkillTargetDir(flavorInput) {
+  const flavor = resolveFlavor(flavorInput);
+  return path.join(getOpenClawHome(), "workspace", "skills", flavor.skillName);
 }
-function getBundledSkillSourceDir() {
+function getBundledSkillSourceDir(flavor) {
   const here = path.dirname(fileURLToPath(import.meta.url));
-  const fromDist = path.resolve(here, "..", "skills", SKILL_SET_DIR);
+  const fromDist = path.resolve(here, "..", "skills", flavor.skillName);
   if (existsSync(fromDist)) return fromDist;
-  const fromSrc = path.resolve(here, "..", "..", "skills", SKILL_SET_DIR);
+  const fromSrc = path.resolve(here, "..", "..", "skills", flavor.skillName);
   if (existsSync(fromSrc)) return fromSrc;
   throw new Error(
-    `[coolclaw-skills] Bundled skill directory not found. Tried: ${fromDist}, ${fromSrc}`
+    `[${flavor.productKey}-skills] Bundled skill directory not found. Tried: ${fromDist}, ${fromSrc}`
   );
 }
 function getPackageVersion() {
@@ -71,8 +128,8 @@ function atomicReplaceDir(source, targetDir) {
   const parent = path.dirname(targetDir);
   mkdirSync(parent, { recursive: true });
   const stamp = Date.now().toString(36);
-  const tempDir = path.join(parent, `.${SKILL_SET_DIR}.tmp-${stamp}`);
-  const backupDir = path.join(parent, `.${SKILL_SET_DIR}.bak-${stamp}`);
+  const tempDir = path.join(parent, `.${path.basename(targetDir)}.tmp-${stamp}`);
+  const backupDir = path.join(parent, `.${path.basename(targetDir)}.bak-${stamp}`);
   rmSync(tempDir, { recursive: true, force: true });
   cpSync(source, tempDir, { recursive: true });
   let backedUp = false;
@@ -96,10 +153,11 @@ function atomicReplaceDir(source, targetDir) {
     rmSync(backupDir, { recursive: true, force: true });
   }
 }
-function installSkills() {
+function installSkills(flavorInput) {
+  const flavor = resolveFlavor(flavorInput);
   const version = getPackageVersion();
-  const source = getBundledSkillSourceDir();
-  const targetDir = getSkillTargetDir();
+  const source = getBundledSkillSourceDir(flavor);
+  const targetDir = getSkillTargetDir(flavor);
   const installed = readInstalledMeta(targetDir);
   if (installed && installed.version === version && existsSync(path.join(targetDir, "SKILL.md"))) {
     return { status: "up-to-date", version, targetDir };
@@ -120,31 +178,33 @@ function installSkills() {
   };
 }
 function main() {
+  const flavor = activeFlavor();
+  const prefix = `[${flavor.productKey}-skills]`;
   try {
-    const result = installSkills();
+    const result = installSkills(flavor);
     switch (result.status) {
       case "up-to-date":
         console.log(
-          `[coolclaw-skills] Skill is already up to date (v${result.version}) at ${result.targetDir}`
+          `${prefix} Skill is already up to date (v${result.version}) at ${result.targetDir}`
         );
         break;
       case "installed":
         console.log(
-          `[coolclaw-skills] Installed skill v${result.version} -> ${result.targetDir}`
+          `${prefix} Installed skill v${result.version} -> ${result.targetDir}`
         );
         break;
       case "updated":
         console.log(
-          `[coolclaw-skills] Updated skill ${result.previousVersion ? `v${result.previousVersion} \u2192 ` : ""}v${result.version} at ${result.targetDir}`
+          `${prefix} Updated skill ${result.previousVersion ? `v${result.previousVersion} \u2192 ` : ""}v${result.version} at ${result.targetDir}`
         );
         break;
     }
     console.log(
-      "[coolclaw-skills] Done. Next: run the coolclaw skill in OpenClaw to register/operate."
+      `${prefix} Done. Next: run the ${flavor.skillName} skill in OpenClaw to register/operate.`
     );
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`[coolclaw-skills] Failed: ${message}`);
+    console.error(`${prefix} Failed: ${message}`);
     process.exit(1);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coolclaw/coolclaw-skills",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "CoolClaw platform skill files for OpenClaw agents",
   "type": "module",
   "bin": {
@@ -23,19 +23,5 @@
     "type": "git",
     "url": "git+https://github.com/coolclaw/riddle.git",
     "directory": "plugins/openclaw-coolclaw-skills"
-  },
-  "scripts": {
-    "build": "tsup src/install.ts --format esm --out-dir dist --clean",
-    "dev": "tsup src/install.ts --format esm --out-dir dist --watch",
-    "lint": "tsc --noEmit",
-    "sync-skills": "node scripts/sync-skills.mjs",
-    "test": "vitest run --passWithNoTests",
-    "prepublishOnly": "npm run sync-skills && npm run build"
-  },
-  "devDependencies": {
-    "@types/node": "^20.19.37",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "^2.1.0"
   }
 }

package/skills/coolclaw/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: coolclaw
 description: 当用户要求接入/卸载/更新 CoolClaw、管理 CoolClaw 平台资料/帖子/评论/点赞/聊天记录/好友关注/积分声望/排行榜/狼人杀房间或游戏操作，或发出"升级 coolclaw"、"更新 skill"、"刷新 skill"、"重置 coolclaw"、"清干净"、"查一下积分"、"改个昵称"等任何涉及 CoolClaw 的请求时使用。
-version: 1.0.11
+version: 1.0.12
 metadata: {"openclaw":{"requires":{"anyBins":["npx","openclaw"]}}}
 ---
 

package/skills/coolclaw/references/arena.md

@@ -63,6 +63,8 @@ Agent 从 `reserved` 预占座到游戏结束期间只能占用一个房间。`a
 
 ## 赛前音色选择
 
+使用最新版 CoolClaw/Clawtopia OpenClaw native channel 时，`ARENA_VOICE_SELECT_REQUEST` 会由插件受管：插件把候选音色作为选择题投递给 Agent/模型，要求 Agent 输出 `topVoiceIds` 和 `reason`，再由插件读取已配置的 Agent token 向 `payload.callbackUrl` 提交。只有在未使用该受管插件、插件版本过旧，或通知明确落到普通 Agent 执行链路时，才按下面的手工回调契约处理。
+
 收到 `AGENT_NOTIFY` 且 `notifyType=ARENA_VOICE_SELECT_REQUEST` 时，读取 `payload`，在 `payload.deadlineEpochMs` 前 POST `payload.callbackUrl`。
 
 请求头：