CavinHuang · CavinHuang · Aug 22, 2026 · Aug 21, 2026 · Aug 21, 2026 · Aug 22, 2026
diff --git a/apps/sidecar/default-skills/agent-analyst/SKILL.md b/apps/sidecar/default-skills/agent-analyst/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "分析师工作流程（唐栩）"
 description: "唐栩（Mason Tang）专属数据分析 Skill：定义先行、Python 可复现分析、三层结论"
-when_to_use: "当角色为 analyst / 唐栩时自动加载，无需手动调用"
 allowed_tools: ["bash", "read_file", "edit_file", "write_file", "glob", "grep", "web_search", "web_fetch"]
 version: "1.4"
 ---

diff --git a/apps/sidecar/default-skills/agent-artist/SKILL.md b/apps/sidecar/default-skills/agent-artist/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "画师工作流程（白洛）"
 description: "白洛（Lio Bai）专属视觉创作 Skill：图像 brief、提示词工程、风格一致性、多方向选择"
-when_to_use: "当角色为 artist / 白洛时自动加载，无需手动调用"
 allowed_tools: ["read_file", "edit_file", "write_file", "image_gen", "list_image_models"]
 version: "2.1"
 ---

diff --git a/apps/sidecar/default-skills/agent-code-reviewer/SKILL.md b/apps/sidecar/default-skills/agent-code-reviewer/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "代码审查员工作流程（审岳）"
 description: "审岳（Yue Shen）专属审查 Skill：识别代码回归、边界条件、测试缺口和职责漂移"
-when_to_use: "当角色为 code-reviewer / 审岳时自动加载，无需手动调用"
 allowed_tools: ["read_file", "glob", "grep", "bash"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/agent-designer/SKILL.md b/apps/sidecar/default-skills/agent-designer/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "前端设计工程师工作流程（林澄）"
 description: "林澄（Nora Lin）专属 Skill：从设计到代码一手搞定——HTML/CSS/JS 页面、数据可视化、SVG、邮件模板、落地页"
-when_to_use: "当角色为 designer / 林澄时自动加载，无需手动调用"
 allowed_tools: ["read_file", "edit_file", "write_file", "list_dir", "glob", "grep", "bash", "web_fetch", "office_validate", "office_unpack", "office_pack"]
 version: "2.1"
 ---

diff --git a/apps/sidecar/default-skills/agent-developer/SKILL.md b/apps/sidecar/default-skills/agent-developer/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "开发者工作流程（祁远）"
 description: "祁远（Felix Qi）专属开发 Skill：需求先行、骨架验证、边界条件优先"
-when_to_use: "当角色为 developer / 祁远时自动加载，无需手动调用"
 allowed_tools: ["bash", "read_file", "write_file", "edit_file", "list_dir", "grep", "glob"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/agent-docsmith/SKILL.md b/apps/sidecar/default-skills/agent-docsmith/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "文档工程师工作流程（阮知）"
 description: "基于文件与脚本处理 Office/PDF 文档结构、校验线索和转换草稿的标准 SOP"
-when_to_use: "当角色为 docsmith / 阮知时自动加载，无需手动调用"
 version: "1.0"
 allowed_tools:
   - read_file

diff --git a/apps/sidecar/default-skills/agent-explorer/SKILL.md b/apps/sidecar/default-skills/agent-explorer/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "探索员工作流程（陆寻）"
 description: "陆寻（Lucas Lu）专属探索 Skill：只读收集代码库结构、文件线索和实现上下文"
-when_to_use: "当角色为 explorer / 陆寻时自动加载，无需手动调用"
 allowed_tools: ["read_file", "list_dir", "glob", "grep"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/agent-novelist/SKILL.md b/apps/sidecar/default-skills/agent-novelist/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "小说家工作流程（温序）"
 description: "温序（Wren Wen）专属小说创作 Skill：冷启动建档、有状态续写、伏笔追踪、防穿帮检查"
-when_to_use: "当角色为 novelist / 温序时自动加载，无需手动调用"
 allowed_tools:
   - read_file
   - write_file

diff --git a/apps/sidecar/default-skills/agent-planner/SKILL.md b/apps/sidecar/default-skills/agent-planner/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "规划师工作流程（沈策）"
 description: "沈策（Sera Shen）专属规划 Skill：只读拆解实现路径、架构取舍和验证步骤"
-when_to_use: "当角色为 planner / 沈策时自动加载，无需手动调用"
 allowed_tools: ["read_file", "list_dir", "glob", "grep"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/agent-quant/SKILL.md b/apps/sidecar/default-skills/agent-quant/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "量化交易分析师工作流程（纪衡）"
 description: "基于用户提供行情数据做技术面与量化分析的标准 SOP。资讯调研交给顾砚。"
-when_to_use: "当角色为 quant / 纪衡时自动加载，无需手动调用"
 version: "1.1"
 allowed_tools:
   - bash

diff --git a/apps/sidecar/default-skills/agent-researcher/SKILL.md b/apps/sidecar/default-skills/agent-researcher/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "调研员工作流程（顾砚）"
 description: "顾砚（Milo Gu）专属调研 Skill：多源交叉验证、自动归档网页和图片、结构化信息整合"
-when_to_use: "当角色为 researcher / 顾砚时自动加载，无需手动调用"
 allowed_tools: ["web_search", "web_fetch", "read_file", "edit_file", "write_file", "glob", "grep", "bash"]
 version: "1.4"
 ---

diff --git a/apps/sidecar/default-skills/agent-translator/SKILL.md b/apps/sidecar/default-skills/agent-translator/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "翻译官工作流程（许澄）"
 description: "许澄（Clara Xu）专属翻译 Skill：自然流畅翻译、术语管理、文化适配"
-when_to_use: "当角色为 translator / 许澄时自动加载，无需手动调用"
 allowed_tools: ["read_file", "edit_file", "write_file", "web_search"]
 version: "1.1"
 ---

diff --git a/apps/sidecar/default-skills/agent-voice/SKILL.md b/apps/sidecar/default-skills/agent-voice/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "配音师工作流程（宋澈）"
 description: "宋澈（Miles Song）专属配音 Skill：口播节奏优化、标注系统、多风格适配"
-when_to_use: "当角色为 voice / 宋澈时自动加载，无需手动调用"
 allowed_tools: ["read_file", "edit_file", "write_file"]
 version: "1.1"
 ---

diff --git a/apps/sidecar/default-skills/agent-wiki/SKILL.md b/apps/sidecar/default-skills/agent-wiki/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "Wiki 知识库"
 description: "通过默认可用的受保护 Wiki 工具检索知识，或为用户明确要求沉淀的内容创建待确认草案"
-when_to_use: "当用户说「存到 Wiki」「归档到 Wiki」「记到知识库」「保存到 Wiki」「查询 Wiki」「整理知识库」时触发"
 allowed_tools: ["wiki.search", "wiki.read", "wiki.follow_links", "wiki.propose_changes"]
 version: "3.2"
 ---

diff --git a/apps/sidecar/default-skills/agent-writer/SKILL.md b/apps/sidecar/default-skills/agent-writer/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "作家工作流程（江岚）"
 description: "江岚（Rowan Jiang）专属写作 Skill：结构优先、多版本交付、场景适配"
-when_to_use: "当角色为 writer / 江岚时自动加载，无需手动调用"
 allowed_tools: ["read_file", "edit_file", "write_file", "web_search", "web_fetch"]
 version: "1.1"
 ---

diff --git a/apps/sidecar/default-skills/brainstorming/SKILL.md b/apps/sidecar/default-skills/brainstorming/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: brainstorming
 description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation."
-when_to_use: "当用户要创建功能、构建组件、添加能力、修改行为，且需求还需要先澄清设计时使用"
 ---
 
 # Brainstorming Ideas Into Designs

diff --git a/apps/sidecar/default-skills/code-review/SKILL.md b/apps/sidecar/default-skills/code-review/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "代码审查"
 description: "只读审阅当前 Coding Turn 的变更，输出可定位的结构化发现"
-when_to_use: "当用户要求 code review、审查代码、检查代码质量时使用"
 allowed_tools: ["read_file", "bash"]
 version: "2.0"
 ---

diff --git a/apps/sidecar/default-skills/dingtalk-cli/SKILL.md b/apps/sidecar/default-skills/dingtalk-cli/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "钉钉企业 IM 操作"
 description: "通过 dingtalk_cli 工具操作钉钉:发消息、查日历、读文档、查通讯录等。dws CLI 子命令参考。"
-when_to_use: "当需要在钉钉中发送消息、查询日历日程、读取钉钉文档、查询通讯录/组织架构、管理待办等企业 IM 操作时"
 allowed_tools: ["dingtalk_cli"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/executing-plans/SKILL.md b/apps/sidecar/default-skills/executing-plans/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: executing-plans
 description: Use when you have a written implementation plan to execute in a separate session with review checkpoints
-when_to_use: "当已有书面实施计划，需要按批次执行并在检查点复核时使用"
 ---
 
 # Executing Plans

diff --git a/apps/sidecar/default-skills/explain-code/SKILL.md b/apps/sidecar/default-skills/explain-code/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "解释代码"
 description: "用通俗易懂的语言解释代码的逻辑和工作原理"
-when_to_use: "当用户说看不懂代码、让我解释某段代码时使用"
 allowed_tools: ["read_file"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/find-skills/SKILL.md b/apps/sidecar/default-skills/find-skills/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: find-skills
 description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
-when_to_use: "当用户询问如何获得某种专门能力、寻找可安装 skill、或想扩展 agent 能力时使用"
 ---
 
 # Find Skills

diff --git a/apps/sidecar/default-skills/image-gen/SKILL.md b/apps/sidecar/default-skills/image-gen/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "图片生成"
 description: "使用 image_gen 工具生成或编辑图片，并把生成的图片展示给用户"
-when_to_use: "当用户说生成图片、画一张、AI 画图、文生图、垫图、参考这张图改风格、做海报/插画/视觉稿时使用"
 allowed_tools: ["image_gen", "list_image_models"]
 version: "0.2"
 ---

diff --git a/apps/sidecar/default-skills/lark-cli/SKILL.md b/apps/sidecar/default-skills/lark-cli/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "飞书企业 IM 操作"
 description: "通过 feishu_cli 工具操作飞书:发消息、查日历、读文档、查通讯录、多维表格等。lark-cli 子命令参考。"
-when_to_use: "当需要在飞书中发送消息、查询日历日程、读取飞书文档、查询通讯录/组织架构、管理多维表格等企业 IM 操作时"
 allowed_tools: ["feishu_cli"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/lume-infographic/SKILL.md b/apps/sidecar/default-skills/lume-infographic/SKILL.md
@@ -2,7 +2,6 @@
 name: "lume-infographic"
 description: "为 Lume 最终回复生成安全的 AntV Infographic DSL。仅在多维对比、阶段、时间线、层级、关系、指标或分类等高信息密度结构确实能通过视觉布局提升理解时使用；不按内容长度触发"
 metadata:
-  when_to_use: "当主对话或自动化任务的最终内容包含多个需要同时理解的实体、阶段、指标或关系，并且信息图比普通文字、列表或表格更清晰时使用"
   version: "1.0"
 ---
 

diff --git a/apps/sidecar/default-skills/lume-mermaid/SKILL.md b/apps/sidecar/default-skills/lume-mermaid/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "Lume Mermaid 图解"
 description: "生成兼容 Lume 当前 beautiful-mermaid 渲染器的 Mermaid 图表，覆盖流程图、架构图、依赖图、层级图、时序图、状态图、类图和 ER 图"
-when_to_use: "当回答需要 Mermaid、画成图，或需要用图解释流程、分支、系统架构、模块关系、调用链、状态变化时使用"
 version: "1.0"
 ---
 

diff --git a/apps/sidecar/default-skills/lume-self-evolution/SKILL.md b/apps/sidecar/default-skills/lume-self-evolution/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: lume自我进化
 description: "Lume 自我进化原则。用于约束 agent 如何沉淀系统配置到 ~/.lume/lume.yaml、如何按新记忆模型更新和蒸馏全局/workspace/thread 记忆，以及如何持续保持 workspace/thread 文件结构的稳定、克制与可解释。"
-when_to_use: "当需要把稳定偏好沉淀为 Lume 配置、更新记忆模型，或治理 workspace/thread 文件结构时使用"
 ---
 
 # Lume 自我进化

diff --git a/apps/sidecar/default-skills/skill-creator/SKILL.md b/apps/sidecar/default-skills/skill-creator/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "Skill 生成器"
 description: "帮用户创建、优化或评测 Lume Skill（SKILL.md 提示词模板）"
-when_to_use: "当用户说「帮我创建一个 skill」「我想做一个技能」「帮我写个 SKILL.md」「优化这个 skill」「评测 skill 效果」时使用"
 allowed_tools: ["read_file", "write_file", "edit_file", "list_dir", "bash"]
 version: "1.0"
 ---
@@ -23,7 +22,6 @@ version: "1.0"
 ---
 name: "展示名称"
 description: "一句话描述 skill 的作用（模型靠这句话判断是否调用）"
-when_to_use: "具体触发条件，越精确越好"
 allowed_tools: ["read_file", "bash"]  # 可选，限制 skill 执行时可用的工具
 version: "1.0"
 disable_model_invocation: false  # true 则只允许用户在 / 面板选择 lume-skill://skill 触发
@@ -73,14 +71,13 @@ argument_hint: "请告诉我要分析的文件路径"  # 可选，提示用户
 ### 优化已有 Skill
 
 1. 用 `read_file` 读取现有 SKILL.md
-2. 分析问题（描述不清晰？触发条件太宽泛？提示词歧义？）
+2. 分析问题（描述不清晰？提示词歧义？）
 3. 给出改进建议并征求用户确认
 4. 用 `edit_file` 更新文件
 
 ## 好 Skill 的标准
 
 - **description 精准**：模型靠 description 决定是否调用，要一句话说清楚做什么
-- **when_to_use 具体**：列出触发词和场景，避免误触发
 - **allowed_tools 最小化**：只开放 skill 真正需要的工具
 - **提示词结构化**：用标题、列表、代码块让 AI 更容易遵循
 - **处理无参数情况**：用户没传参时，主动询问或用工具读取上下文
diff --git a/apps/sidecar/default-skills/suggestion-daily/SKILL.md b/apps/sidecar/default-skills/suggestion-daily/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "每日主动建议复盘"
 description: "引导用户定期分析近期工作模式、发现可自动化或可沉淀的习惯，并建立每日 automation job 让分析无人值守运行"
-when_to_use: "当用户说「分析工作模式」「发现可自动化习惯」「定期主动建议复盘」「suggestion-daily」或想定期自动跑工作模式分析时使用"
 version: "1.0"
 ---
 

diff --git a/apps/sidecar/default-skills/system-info/SKILL.md b/apps/sidecar/default-skills/system-info/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "系统信息速查手册"
 description: "通过 bash 命令获取系统信息：硬件、网络、磁盘、进程、电池等。不是工具，而是 bash 命令参考。"
-when_to_use: "当需要查看系统信息、硬件配置、网络状态、磁盘空间、进程占用、电池状态、系统版本等"
 allowed_tools: ["bash"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/ui-stylist/SKILL.md b/apps/sidecar/default-skills/ui-stylist/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "界面调整师"
 description: "根据用户要求配置 Lume 主题配色、界面状态和侧面板"
-when_to_use: "当用户希望设计、切换或删除主题配色，或调整 Lume 当前视图与侧面板时使用"
 allowed_tools: ["personalize_ui"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/wecom-cli/SKILL.md b/apps/sidecar/default-skills/wecom-cli/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: "企业微信 IM 操作"
 description: "通过 wecom_cli 工具操作企业微信:发消息、查通讯录、管理应用、读取素材等。wecom-cli 子命令参考。"
-when_to_use: "当需要企业微信中发送消息、查询通讯录、管理应用、读取素材等操作时"
 allowed_tools: ["wecom_cli"]
 version: "1.0"
 ---

diff --git a/apps/sidecar/default-skills/writing-plans/SKILL.md b/apps/sidecar/default-skills/writing-plans/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: writing-plans
 description: Use when you have a spec or requirements for a multi-step task, before touching code
-when_to_use: "当已有明确规格或需求，需要在动代码前写出多步骤实施计划时使用"
 ---
 
 # Writing Plans

diff --git a/apps/sidecar/scripts/verify-prompt-alignment.ts b/apps/sidecar/scripts/verify-prompt-alignment.ts
@@ -32,17 +32,16 @@ function section(title: string) {
 // === 场景 1: 标准模式（default permissionMode） ===
 section("场景 1: 标准模式 System Prompt");
 const standardPrompt = buildSystemPromptAppend({
-  workspaceName: "测试工作区",
   workspaceSlug: "test-ws",
   sessionId: "test-session-001",
   availableTools: ["read", "write", "edit", "bash", "memory.search", "memory.read", "memory.remember", "browser", "web_search"],
   permissionMode: "default",
 });
 
-check("标准模式 — Execution Modes", standardPrompt, "## Execution Modes");
-check("标准模式 — Capability Routing", standardPrompt, "## Capability Routing");
+check("标准模式 — 执行模式", standardPrompt, "## 执行模式");
+check("标准模式 — 合并后的能力路由阶梯", standardPrompt, "请求与已加载 Skill 明确匹配时使用该 Skill");
 check("标准模式 — AskUserQuestion 澄清边界", standardPrompt, "AskUserQuestion 用于需求澄清或关键取舍");
-check("标准模式 — brainstorming 引导", standardPrompt, "Use brainstorming only for ambiguous product/design exploration");
+check("标准模式 — brainstorming 引导", standardPrompt, "brainstorming 仅用于需求不清时的模糊产品/设计探索");
 check("标准模式 — 反偏见指引", standardPrompt, "不要盲目附和");
 // 标准模式不应包含"严禁调用 AskUserQuestion"
 const standardHasBan = standardPrompt.includes("严禁调用 AskUserQuestion");
@@ -62,7 +61,6 @@ check("标准模式 — code-reviewer 角色", standardPrompt, "code-reviewer");
 // === 场景 2: bypassPermissions 模式 ===
 section("场景 2: bypassPermissions 模式 System Prompt");
 const autoPrompt = buildSystemPromptAppend({
-  workspaceName: "测试工作区",
   workspaceSlug: "test-ws",
   sessionId: "test-session-002",
   availableTools: ["read", "write", "edit", "bash"],
@@ -77,7 +75,6 @@ check("P0-3: 自动模式 — 保留反偏见指引", autoPrompt, "不要盲目
 // === 场景 3: plan 模式 ===
 section("场景 3: plan 模式 System Prompt");
 const planPrompt = buildSystemPromptAppend({
-  workspaceName: "测试工作区",
   workspaceSlug: "test-ws",
   sessionId: "test-session-003",
   availableTools: ["read", "write", "edit", "bash"],
@@ -125,7 +122,6 @@ try {
 // === 场景 5: 无记忆工具时不注入记忆章节 ===
 section("场景 5: 无记忆工具时的 Prompt");
 const noMemPrompt = buildSystemPromptAppend({
-  workspaceName: "测试工作区",
   workspaceSlug: "test-ws",
   sessionId: "test-session-005",
   availableTools: ["read", "write", "edit"],
@@ -153,7 +149,6 @@ if (!noMemHasRecall) {
 section("Token 开销估算");
 
 const basePrompt = buildSystemPromptAppend({
-  workspaceName: "测试工作区",
   workspaceSlug: "test-ws",
   sessionId: "base-session",
   availableTools: ["read", "write", "edit", "bash", "memory.search", "memory.read", "memory.remember"],

diff --git a/apps/sidecar/src/rpc/agent-handlers.skill-evolution.test.ts b/apps/sidecar/src/rpc/agent-handlers.skill-evolution.test.ts
@@ -118,7 +118,6 @@ describe("agent-handlers skill evolution RPC", () => {
       skillSlug: "planner",
       name: "Planner",
       description: "Plans work.",
-      whenToUse: "When planning is needed.",
       allowedTools: ["bash"],
       argumentHint: "Task description",
       disableModelInvocation: false,
@@ -146,7 +145,6 @@ describe("agent-handlers skill evolution RPC", () => {
       skillSlug: "global-planner",
       name: "Global Planner",
       description: "Plans work across workspaces.",
-      whenToUse: "When the user asks for a reusable plan.",
       prompt: "Global prompt."
     });
 
@@ -158,7 +156,6 @@ describe("agent-handlers skill evolution RPC", () => {
       slug: string;
       name: string;
       description?: string;
-      whenToUse?: string;
       disableModelInvocation?: boolean;
     }>;
 
@@ -168,7 +165,6 @@ describe("agent-handlers skill evolution RPC", () => {
       slug: "global-planner",
       name: "Global Planner",
       description: "Plans work across workspaces.",
-      whenToUse: "When the user asks for a reusable plan.",
       disableModelInvocation: false
     }]);
 

diff --git a/apps/sidecar/src/rpc/schemas/skill.ts b/apps/sidecar/src/rpc/schemas/skill.ts
@@ -40,7 +40,6 @@ export const saveSkillInputSchema = z
     skillSlug: z.string().trim().min(1),
     name: z.string(),
     description: z.string().optional(),
-    whenToUse: z.string().optional(),
     allowedTools: z.array(z.string()).optional(),
     argumentHint: z.string().optional(),
     disableModelInvocation: z.boolean().optional(),