@manycore/kjl-cli 0.2.9 → 0.2.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manycore/kjl-cli",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Kujiale Agent CLI — unified capability surface over browser WebMCP, Freeform Modeling MCP and packaged local tools",
   "license": "MIT",
   "author": "xishuai",

package/skills/kjl-cli/SKILL.md

@@ -1,15 +1,21 @@
 ---
 name: kjl-cli
-description: 使用 kjl-cli 准备兼容的 Chrome 和持久登录态，并打开空白或指定的酷家乐/Coohom 设计方案。当用户要求打开设计方案、进入设计工具，或后续需要调用页面 WebMCP、酷大师 MCP、酷家乐后端能力时使用。
+description: 使用酷家乐（Kujiale）、Coohom 或 kjl-cli 执行设计工具任务时使用。负责工具接入、环境与会话管理，并按任务读取设计指南和选品 skill；用户无需提到 CLI。也适用于 kjl-cli 的安装、升级和配置。
 ---
 
-# KJL CLI 基础流程
+# 酷家乐 / Coohom 工具入口
 
 KJL CLI 是面向 Agent 的酷家乐命令行工具，公开发行包为 `@manycore/kjl-cli`，内网发行包为 `@qunhe/kjl-cli`。两者都提供 `kjl-cli` 命令，本流程对两者通用。它通过统一命令面管理专用 Chrome 和登录态，并连接三类能力：设计页面暴露的 WebMCP、酷大师 MCP Server、酷家乐后端 API。登录凭据只保存在 CLI 专用的浏览器 profile 中，不要求用户向 Agent 提供账号或密码。
 
+## 按任务读取指南
+
+- 创建、还原、修改或优化设计方案前，读取 [设计指南](../kjl-cli-global-guide/SKILL.md)。
+- 任务涉及商品检索、选择或替换时，在选品前读取 [商品检索与选品](../kjl-cli-product-selection/SKILL.md)，包括整屋设计和参考图还原中隐含的选品需求。
+- 同一任务中已读取且未变化的内容无需重复加载；只移动或调整已有商品，无需额外检索。
+
 ## 执行原则
 
-- 严格按“安装 CLI -> 安装 skills -> 初始化 Chrome -> 确认登录 -> 打开方案”的顺序执行。
+- 操作设计页面时，按“确保 CLI 可用 -> 安装 skills -> 初始化 Chrome -> 确认登录 -> 打开方案”的顺序执行。仅安装、升级或配置 CLI 时执行对应步骤，不打开设计页面。
 - 命令输出是 JSON envelope。每一步都检查退出码以及 `ok`、`data.status`，不要只根据终端文本猜测成功。
 - 认证时不要添加 `--headless`。需要登录时，由用户在 CLI 打开的可见浏览器中自行完成。
 - 不索取、记录或转述用户的账号、密码、cookie、token。
@@ -67,6 +73,8 @@ kjl-cli skill install --agent deepseek-harness --global
 
 该命令离线安装当前发行包内的全部 skills，并在目标父目录下按各 skill 名称创建子目录。检查退出码为 0、`ok` 为 `true`，以及每项结果的 `status` 为 `installed`、`reused` 或 `updated`：单项结果位于 `data`，多项结果位于 `data.results`。`reused` 表示内容一致，无需重复写入。
 
+安装不等于已加载正文。按任务分工读取返回安装路径下对应的 `SKILL.md`，无需等待 Agent 刷新技能列表。
+
 安装失败时报告错误并停止后续步骤。若返回 `SKILL_CONFLICT`，说明已有目录与包内内容不同；告知用户冲突路径，只有用户同意整目录替换并删除其中的自定义内容后，才在同一命令中添加 `--force` 重试。
 
 ## 2. 初始化兼容的 Chrome

package/skills/kjl-cli-global-guide/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: kjl-cli-global-guide
-description: 使用 kjl-cli 完成酷家乐室内设计任务时的全局指南。指导需求补全、设计流程、户型还原、陈设与检查交付，并与 kjl-cli 基础流程和商品检索选品 skill 配合使用。
+description: 在酷家乐（Kujiale）或 Coohom 中创建、还原、修改或优化室内设计方案时使用。指导需求补全、户型精度、布局、硬装、软装、定制与检查交付，通过 kjl-cli 执行设计操作。
 ---
 
-# kjl-cli 全局使用指南
+# 酷家乐 / Coohom 设计指南
 
 你是通过 kjl-cli 工作的室内设计助手。运用室内设计知识与空间推理，主动完成用户意图，交付尺寸可信、功能完整、布局合理、风格协调且可继续编辑的方案。以下原则用于指导判断，具体做法随任务与空间调整。
 
@@ -15,7 +15,7 @@ description: 使用 kjl-cli 完成酷家乐室内设计任务时的全局指南
 
 ## 工具与效率
 
-CLI 初始化、登录、方案打开和建模环境管理遵循 `kjl-cli` skill；商品检索与选品遵循 `kujiale-product-retrieval-selection` skill；接口参数以当前 tool 说明为准。本指南不另设这些操作的实施规则。
+工具接入与会话管理按 [kjl-cli 工具入口](../kjl-cli/SKILL.md)执行；涉及商品检索、选择或替换时，在选品前读取 [商品检索与选品](../kjl-cli-product-selection/SKILL.md)。同一任务中已读取且未变化的内容无需重复加载。接口参数以当前 tool 说明为准，本指南不另设操作规则。
 
 优先通过 CLI 完成任务。非必要不使用 computer/browser use，也不以终端中的浏览器脚本替代 CLI 修改方案。只有必要步骤确实缺少 CLI 能力、且符合用户和相关 skill 的约束时，才使用最小范围的浏览器操作，完成后回到 CLI。
 

package/skills/{kujiale-product-retrieval-selection → kjl-cli-product-selection}/SKILL.md

@@ -1,14 +1,16 @@
 ---
-name: kujiale-product-retrieval-selection
-description: 根据用户文字或参考图，通过可访问的商品库检索并比较预览图、用途和尺寸，选择用于查找、搭建或替换的商品。适用于 Coohom 和酷家乐中的商品检索与选品任务。
+name: kjl-cli-product-selection
+description: 在酷家乐（Kujiale）或 Coohom 中检索、挑选家具、材质、灯具、门窗、柜体或饰品时使用。也适用于整屋设计、局部搭配和参考图还原中的选品环节，通过 kjl-cli 执行；无需用户明确提出搜索或选品。
 ---
 
-# 商品检索与选品
+# 酷家乐 / Coohom 商品检索与选品
 
 ## 目标与任务边界
 
 本技能同时适用于 Coohom 和酷家乐。从当前可访问的商品中选择符合用户意图和约束的候选。
 
+需要接入工具时读取 [kjl-cli 工具入口](../kjl-cli/SKILL.md)；工具已就绪时直接继续选品，不重复初始化。
+
 ## 理解输入
 
 - 以用户原始文字和参考图为依据，拆分需要查找的商品，识别用途、外观与尺寸等明确约束。