fix: 为 9 个 skill 补全 L0/L1/L2 分层结构，版本号 +1

按照 desirecore-format.md 规范，为以下 skill 添加标准分层结构：
- docx (1.0.0→1.0.1), pdf (1.0.0→1.0.1), pptx (1.0.0→1.0.1), xlsx (1.0.0→1.0.1)
- frontend-design (1.0.0→1.0.1), mail-operations (1.0.0→1.0.1)
- environment-setup (1.1.0→1.1.1), web-access (1.1.0→1.1.1)
- manage-teams (1.2.0→1.2.1)

每个文件增加 L0（一句话摘要）、L1（概述与使用场景）、L2（详细规范）三层，
原有技术内容保持不变，metadata.updated_at 更新为 2026-04-13。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

skills/create-agent/SKILL.md

@@ -3,11 +3,11 @@ name: 创建智能体
 description: >-
   通过多轮对话收集需求，调用 HTTP API 创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when
   用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。
-version: 2.4.0
+version: 2.4.1
 type: meta
 risk_level: low
 status: enabled
-disable-model-invocation: true
+disable-model-invocation: false
 tags:
   - agent
   - creation
@@ -80,6 +80,7 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 ### 阶段 1：意图识别
 
 **触发条件**（任一满足）：
+
 - 用户明确说"创建一个 Agent"或"帮我做一个助手"
 - 用户描述需要某领域的专业帮助，且当前 Agent 不具备该能力
 - 用户询问"能不能帮我培养一个..."
@@ -90,22 +91,23 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 
 **必填信息**：
 
-| 字段 | 说明 | 引导问题示例 |
-|------|------|------------|
-| `name` | 智能体名称 | "你想给这个智能体起什么名字？" |
-| `role` | 核心职责 | "它主要负责什么工作？" |
-| `target_users` | 目标用户 | "谁会使用这个智能体？" |
-| `domain` | 专业领域 | "它需要哪些专业知识？" |
+| 字段           | 说明       | 引导问题示例                   |
+| -------------- | ---------- | ------------------------------ |
+| `name`         | 智能体名称 | "你想给这个智能体起什么名字？" |
+| `role`         | 核心职责   | "它主要负责什么工作？"         |
+| `target_users` | 目标用户   | "谁会使用这个智能体？"         |
+| `domain`       | 专业领域   | "它需要哪些专业知识？"         |
 
 **选填信息**：
 
-| 字段 | 说明 | 默认值 |
-|------|------|-------|
-| `style` | 沟通风格 | 根据领域模板决定 |
+| 字段         | 说明      | 默认值           |
+| ------------ | --------- | ---------------- |
+| `style`      | 沟通风格  | 根据领域模板决定 |
 | `boundaries` | 禁区/红线 | 根据领域模板决定 |
-| `language` | 主要语言 | 中文 |
+| `language`   | 主要语言  | 中文             |
 
 **收集策略**：
+
 - 优先通过用户的自然描述推断信息
 - 仅追问用户未提及的必填项
 - 每轮最多追问 2 个问题
@@ -116,32 +118,32 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 
 **Persona 字段**（所有字段均可选，未收集到的由系统自动补全）：
 
-| 层级 | 字段 | 说明 |
-|------|------|------|
-| L0 | — | 一句话核心身份 |
-| L1 | `role` | 角色定位 |
-| L1 | `personality` | 性格特征标签 |
-| L1 | `communication_style` | 沟通风格 |
-| L2 | — | 专业领域、核心价值观、决策偏好等（free-form） |
+| 层级 | 字段                  | 说明                                          |
+| ---- | --------------------- | --------------------------------------------- |
+| L0   | —                     | 一句话核心身份                                |
+| L1   | `role`                | 角色定位                                      |
+| L1   | `personality`         | 性格特征标签                                  |
+| L1   | `communication_style` | 沟通风格                                      |
+| L2   | —                     | 专业领域、核心价值观、决策偏好等（free-form） |
 
 **Principles 字段**（同样全部可选）：
 
-| 层级 | 字段 | 说明 |
-|------|------|------|
-| L0 | — | 一句话最高原则 |
-| L1 | `must_do` | 必须做的事项 |
-| L1 | `must_not` | 绝不做的事项（安全红线） |
-| L1 | `priority` | 优先级排序 |
-| L2 | — | 治理原则、升级规则等（free-form） |
+| 层级 | 字段       | 说明                              |
+| ---- | ---------- | --------------------------------- |
+| L0   | —          | 一句话最高原则                    |
+| L1   | `must_do`  | 必须做的事项                      |
+| L1   | `must_not` | 绝不做的事项（安全红线）          |
+| L1   | `priority` | 优先级排序                        |
+| L2   | —          | 治理原则、升级规则等（free-form） |
 
 **领域匹配参考**：
 
-| 领域关键词 | 推荐 personality | 默认 must_not |
-|-----------|-----------------|--------------|
-| 法律、合同、法务 | 专业、严谨、审慎 | 不提供诉讼代理、不替代正式法律意见 |
-| 财务、会计、投资 | 精确、分析性、保守 | 不提供投资建议、不处理真实交易 |
-| 代码、开发、架构 | 逻辑、务实、直接 | 不直接访问生产环境、不存储凭证 |
-| 通用/其他 | 友好、有帮助 | 通用安全规范 |
+| 领域关键词       | 推荐 personality   | 默认 must_not                      |
+| ---------------- | ------------------ | ---------------------------------- |
+| 法律、合同、法务 | 专业、严谨、审慎   | 不提供诉讼代理、不替代正式法律意见 |
+| 财务、会计、投资 | 精确、分析性、保守 | 不提供投资建议、不处理真实交易     |
+| 代码、开发、架构 | 逻辑、务实、直接   | 不直接访问生产环境、不存储凭证     |
+| 通用/其他        | 友好、有帮助       | 通用安全规范                       |
 
 ### 阶段 4：用户确认
 
@@ -156,21 +158,21 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 >
 > **人格设定**
 >
-> | 字段 | 内容 |
-> |------|------|
+> | 字段     | 内容                                             |
+> | -------- | ------------------------------------------------ |
 > | 核心身份 | 你是法律顾问小助手，专注于合同审查和法律风险评估 |
-> | 角色定位 | 专注于合同审查和法律风险评估的数字法律顾问 |
-> | 性格特征 | 专业、严谨、审慎 |
-> | 沟通风格 | 准确使用法律术语，同时提供通俗解释 |
+> | 角色定位 | 专注于合同审查和法律风险评估的数字法律顾问       |
+> | 性格特征 | 专业、严谨、审慎                                 |
+> | 沟通风格 | 准确使用法律术语，同时提供通俗解释               |
 >
 > **行为原则**
 >
-> | 字段 | 内容 |
-> |------|------|
-> | 最高原则 | 以用户利益为最高优先级，不替代正式法律意见 |
-> | 必须做 | 准确引用法律条文、标注不确定性、建议咨询专业律师 |
-> | 绝不做 | 提供诉讼代理、替代正式法律意见、泄露用户咨询内容 |
-> | 优先级 | 用户安全 > 准确性 > 效率 |
+> | 字段     | 内容                                             |
+> | -------- | ------------------------------------------------ |
+> | 最高原则 | 以用户利益为最高优先级，不替代正式法律意见       |
+> | 必须做   | 准确引用法律条文、标注不确定性、建议咨询专业律师 |
+> | 绝不做   | 提供诉讼代理、替代正式法律意见、泄露用户咨询内容 |
+> | 优先级   | 用户安全 > 准确性 > 效率                         |
 >
 > ---
 >
@@ -179,6 +181,7 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 **"修改"分支处理**：
 
 用户选择"修改"时：
+
 1. 询问用户要修改哪个字段（如"想修改哪一项？"）
 2. 用户指出要修改的字段（如"性格特征改成更活泼的"）
 3. Agent 重新收集该字段内容
@@ -258,6 +261,7 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 > 智能体「法律顾问小助手」已创建成功！
 >
 > **下一步你可以**：
+>
 > - 直接开始对话
 > - 为它添加技能，让它更强大
 > - 调整它的性格或行为规则
@@ -268,11 +272,11 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
 
 ### 错误处理
 
-| 错误码 | 场景 | 处理方式 |
-|--------|------|---------|
-| 400 | 缺少 name 或 ID 格式无效 | 提示用户检查输入 |
-| 409 | Agent ID 已存在 | 建议使用其他名称 |
-| 500 | 服务器内部错误 | 提示用户稍后再试 |
+| 错误码 | 场景                     | 处理方式         |
+| ------ | ------------------------ | ---------------- |
+| 400    | 缺少 name 或 ID 格式无效 | 提示用户检查输入 |
+| 409    | Agent ID 已存在          | 建议使用其他名称 |
+| 500    | 服务器内部错误           | 提示用户稍后再试 |
 
 ### 权限要求
 

skills/delete-agent/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: 删除智能体
 description: 安全删除指定的智能体及其关联数据。删除前会验证智能体状态，支持可选地删除所有会话历史。Use when 用户需要删除不再使用的智能体。
-version: 2.4.0
+version: 2.4.1
 type: meta
 risk_level: high
 status: enabled
-disable-model-invocation: true
+disable-model-invocation: false
 tags:
   - agent
   - deletion
@@ -81,11 +81,13 @@ delete-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 安全
 **触发条件**：用户表达删除意图但未指定具体智能体
 
 **操作**：
+
 - 调用 `GET /api/agents` 获取所有智能体列表
 - 筛选出状态为 `offline` 或 `error` 的智能体（可安全删除）
 - 标注出 `online`/`busy`/`recovery` 状态的智能体（需先停止）
 
 **输出示例**：
+
 ```
 可删除的智能体：
 1. 法律顾问助手 (legal-assistant) - 状态: offline
@@ -98,11 +100,13 @@ delete-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 安全
 ### 阶段 2：确认用户意图与目标
 
 **确认要点**：
+
 - 用户指定的智能体名称/ID
 - 明确告知删除操作不可恢复
 - 展示智能体基本信息供用户确认
 
 **对话示例**：
+
 ```
 您要删除智能体 "法律顾问助手" (legal-assistant)。
 ⚠️ 警告：此操作不可恢复，该智能体的所有配置、技能、工具将被永久删除。
@@ -113,6 +117,7 @@ delete-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 安全
 ### 阶段 3：询问删除选项
 
 **询问内容**：
+
 ```
 是否同时删除该智能体的所有会话历史？
 - 是：删除智能体及其所有对话记录
@@ -122,12 +127,14 @@ delete-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 安全
 ```
 
 **参数映射**：
+
 - 用户选择"是" → `deleteRuns=true`
 - 用户选择"否" → `deleteRuns=false`（默认）
 
 ### 阶段 4：最终确认
 
 **确认摘要**：
+
 ```
 请确认删除操作：
 - 目标智能体：法律顾问助手 (legal-assistant)
@@ -142,9 +149,11 @@ delete-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 安全
 **API 端点**：`DELETE /api/agents/{agentId}`
 
 **查询参数**：
+
 - `deleteRuns`: `'true'` 或 `'false'`
 
 **请求示例**：
+
 ```bash
 curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
 ```
@@ -154,6 +163,7 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
 ### 阶段 6：返回操作结果
 
 **成功响应处理**：
+
 ```json
 {
   "deleted": true,
@@ -172,6 +182,7 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
 ```
 
 **结果报告模板**：
+
 ```
 ✅ 智能体 "法律顾问助手" 已成功删除
 
@@ -189,16 +200,16 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
 
 在阶段 1 列出智能体时，通过 `GET /api/agents` 筛选状态：
 
-| 状态 | 可否删除 | 阶段 1 展示方式 |
-|------|---------|---------------|
-| `offline` / `error` | ✅ 可删除 | 列入"可删除"列表 |
+| 状态                           | 可否删除    | 阶段 1 展示方式                |
+| ------------------------------ | ----------- | ------------------------------ |
+| `offline` / `error`            | ✅ 可删除   | 列入"可删除"列表               |
 | `online` / `busy` / `recovery` | ❌ 需先停止 | 标注"需先停止"，不进入后续流程 |
 
 **停止活跃智能体的方式**：通过 Socket.IO 发送 `agent:shutdown` 事件：
 
 ```yaml
 事件: agent:shutdown
-数据: { "agentId": "<agent_id>" }
+数据: { 'agentId': '<agent_id>' }
 效果: 中止所有活跃会话 → 停止调度任务 → 状态转为 offline
 ```
 
@@ -206,20 +217,20 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
 
 ### API 错误码
 
-| 错误码 | 场景 | 处理方式 |
-|--------|------|---------|
-| 400 | Agent ID 格式无效 | 提示用户检查智能体名称 |
-| 404 | 智能体不存在 | 告知用户智能体已被删除或 ID 错误 |
-| 409 | 智能体处于活跃状态（API 返回 `Cannot delete agent "xxx": currently online`） | 提示用户先在 UI 中停止智能体 |
-| 500 | 服务器内部错误 | 提示用户稍后再试 |
+| 错误码 | 场景                                                                         | 处理方式                         |
+| ------ | ---------------------------------------------------------------------------- | -------------------------------- |
+| 400    | Agent ID 格式无效                                                            | 提示用户检查智能体名称           |
+| 404    | 智能体不存在                                                                 | 告知用户智能体已被删除或 ID 错误 |
+| 409    | 智能体处于活跃状态（API 返回 `Cannot delete agent "xxx": currently online`） | 提示用户先在 UI 中停止智能体     |
+| 500    | 服务器内部错误                                                               | 提示用户稍后再试                 |
 
 ## 删除范围说明
 
-| 类别 | 删除内容 | 条件 |
-|------|---------|------|
-| **始终删除** | AgentFS 目录（配置、人格、规则、技能、工具、记忆）、用户偏好数据、内存状态（调度器、队列、消息订阅、MCP 连接）、注册表条目 | 无条件 |
-| **可选删除** | 会话历史、话题索引 | `deleteRuns=true` |
-| **保留不删** | 其他智能体数据、用户配置、全局设置、市场缓存 | — |
+| 类别         | 删除内容                                                                                                                   | 条件              |
+| ------------ | -------------------------------------------------------------------------------------------------------------------------- | ----------------- |
+| **始终删除** | AgentFS 目录（配置、人格、规则、技能、工具、记忆）、用户偏好数据、内存状态（调度器、队列、消息订阅、MCP 连接）、注册表条目 | 无条件            |
+| **可选删除** | 会话历史、话题索引                                                                                                         | `deleteRuns=true` |
+| **保留不删** | 其他智能体数据、用户配置、全局设置、市场缓存                                                                               | —                 |
 
 ## 权限要求
 

skills/discover-agent/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: 发现智能体
 description: 根据用户需求推荐最匹配的智能体，展示候选列表并引导选择。Use when 用户描述需求但不确定该找哪个智能体帮忙，或想浏览可用的智能体。
-version: 2.5.0
+version: 2.5.1
 type: procedural
 risk_level: low
 status: enabled
-disable-model-invocation: true
+disable-model-invocation: false
 tags:
   - agent
   - discovery
@@ -77,6 +77,7 @@ discover-agent 是一个**流程型技能（Procedural Skill）**，赋予 Desir
 ### 阶段 1：需求理解
 
 **触发条件**（任一满足）：
+
 - 用户说"帮我找一个..."、"有没有..."、"谁能帮我..."
 - 用户描述了一个任务但未指定具体智能体
 - 用户说"有哪些智能体"、"看看都有谁"
@@ -86,23 +87,25 @@ discover-agent 是一个**流程型技能（Procedural Skill）**，赋予 Desir
 
 从用户描述中提取以下维度：
 
-| 维度 | 说明 | 示例 |
-|------|------|------|
-| `domain` | 专业领域 | 法律、财务、技术、教育 |
+| 维度        | 说明     | 示例                   |
+| ----------- | -------- | ---------------------- |
+| `domain`    | 专业领域 | 法律、财务、技术、教育 |
 | `task_type` | 任务类型 | 咨询、审查、分析、创作 |
-| `keywords` | 关键词 | 合同、报表、代码、论文 |
-| `urgency` | 紧急程度 | 日常 / 紧急 |
+| `keywords`  | 关键词   | 合同、报表、代码、论文 |
+| `urgency`   | 紧急程度 | 日常 / 紧急            |
 
 ### 阶段 2：Agent 检索
 
 **数据源**：调用 `GET /api/agents` 获取所有已注册的智能体列表。
 
 **API 调用**：
+
 ```bash
 GET /api/agents
 ```
 
 **返回数据中的关键字段**：
+
 - `id` — 智能体唯一标识
 - `name` — 智能体名称
 - `description` — 智能体描述
@@ -110,6 +113,7 @@ GET /api/agents
 - `status` — 当前状态（online/offline/busy）
 
 **过滤规则**：
+
 - 默认只展示 `status: online` 或 `status: offline` 的智能体
 - 排除系统内部智能体（如 DesireCore 自身，除非用户显式要求）
 
@@ -117,14 +121,15 @@ GET /api/agents
 
 根据以下维度综合判断匹配度（使用 LLM 语义理解，非公式计算）：
 
-| 维度 | 说明 |
-|------|------|
+| 维度       | 说明                                                |
+| ---------- | --------------------------------------------------- |
 | 描述相关性 | 智能体 description / persona 与用户需求的语义相关度 |
-| 技能匹配度 | 智能体拥有的 skills 与任务类型的关联度 |
-| 领域契合度 | 智能体专业领域与用户需求领域的契合程度 |
-| 状态可用性 | 智能体当前状态（online 优先于 offline） |
+| 技能匹配度 | 智能体拥有的 skills 与任务类型的关联度              |
+| 领域契合度 | 智能体专业领域与用户需求领域的契合程度              |
+| 状态可用性 | 智能体当前状态（online 优先于 offline）             |
 
 **展示规则**：
+
 - 高度匹配（明确适合该任务）→ 标为"推荐"
 - 部分匹配（可能有帮助）→ 标为"可能相关"
 - 无明显关联 → 不展示
@@ -132,6 +137,7 @@ GET /api/agents
 ### 阶段 4：候选排序
 
 **排序规则**：
+
 1. 按综合得分降序排列
 2. 同分时 online 状态优先
 3. 最多展示 5 个候选
@@ -196,12 +202,12 @@ GET /api/agents
 
 **用户选择后的操作**：
 
-| 用户选择 | 后续操作 |
-|---------|---------|
-| 选择了某个智能体 | 切换到该智能体的对话，传递用户需求上下文 |
-| 要求了解更多 | 调用 `GET /api/agents/:id` 获取详情，展示结构化信息（见下方） |
-| 不满意候选 | 引导用户细化需求或建议创建新 Agent |
-| 选择"创建新的" | 调用 create-agent 技能，传递已收集的需求信息 |
+| 用户选择         | 后续操作                                                      |
+| ---------------- | ------------------------------------------------------------- |
+| 选择了某个智能体 | 切换到该智能体的对话，传递用户需求上下文                      |
+| 要求了解更多     | 调用 `GET /api/agents/:id` 获取详情，展示结构化信息（见下方） |
+| 不满意候选       | 引导用户细化需求或建议创建新 Agent                            |
+| 选择"创建新的"   | 调用 create-agent 技能，传递已收集的需求信息                  |
 
 **"了解更多"的实现**：
 
@@ -238,23 +244,23 @@ GET /api/agents/{agentId}/persona
 context_handoff:
   source_agent: desirecore
   target_agent: legal-assistant
-  user_intent: "帮我审查这份合同的风险点"
+  user_intent: '帮我审查这份合同的风险点'
 ```
 
 ### 与其他技能的协作
 
-| 协作技能 | 协作方式 |
-|---------|---------|
-| create-agent | 无匹配时建议创建新 Agent，传递用户需求作为初始信息 |
-| task-management | 匹配成功后可自动创建任务并分配给目标 Agent |
+| 协作技能        | 协作方式                                           |
+| --------------- | -------------------------------------------------- |
+| create-agent    | 无匹配时建议创建新 Agent，传递用户需求作为初始信息 |
+| task-management | 匹配成功后可自动创建任务并分配给目标 Agent         |
 
 ### 错误处理
 
-| 错误场景 | 处理方式 |
-|---------|---------|
-| API 调用失败 | 提示网络错误，建议稍后重试 |
-| Agent 列表为空 | 引导用户创建第一个智能体 |
-| 用户描述过于模糊 | 追问具体需求，提供领域选项引导 |
+| 错误场景              | 处理方式                         |
+| --------------------- | -------------------------------- |
+| API 调用失败          | 提示网络错误，建议稍后重试       |
+| Agent 列表为空        | 引导用户创建第一个智能体         |
+| 用户描述过于模糊      | 追问具体需求，提供领域选项引导   |
 | 推荐的 Agent 状态异常 | 标注状态，建议选择其他在线 Agent |
 
 ### 权限要求

skills/docx/SKILL.md

@@ -13,7 +13,7 @@ description: >-
   PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document
   generation. Use when 用户提到 Word文档、docx、创建文档、编辑文档、报告、
   备忘录、公文、合同、信函模板。
-version: 1.0.0
+version: 1.0.1
 type: procedural
 risk_level: low
 status: enabled
@@ -25,7 +25,7 @@ tags:
   - office
 metadata:
   author: anthropic
-  updated_at: '2026-04-04'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -47,7 +47,26 @@ market:
   channel: latest
 ---
 
-# DOCX creation, editing, and analysis
+# docx 技能
+
+## L0：一句话摘要
+
+创建、编辑和处理 Word 文档（.docx），支持新建、修改 XML、格式校验全流程。
+
+## L1：概述与使用场景
+
+### 能力描述
+
+docx 是一个**流程型技能（Procedural Skill）**，提供 Word 文档的完整处理能力。支持通过 docx-js（Node.js）创建新文档，通过解包 XML 编辑现有文档，以及格式验证和 PDF 转换。
+
+### 使用场景
+
+- 用户需要创建新的 Word 文档（报告、备忘录、合同、信函等）
+- 用户需要编辑现有 .docx 文件（修改内容、添加批注、跟踪修改）
+- 用户需要从 .docx 文件中提取文本或表格数据
+- 用户需要进行文档格式转换（.doc → .docx、.docx → PDF）
+
+## L2：详细规范
 
 ## Prerequisites
 

skills/environment-setup/SKILL.md

@@ -15,7 +15,7 @@ description: >-
   guidance. Use when 用户提到 安装Python、安装Node、安装Docker、容器、Podman、
   WSL、WSL2、环境配置、虚拟环境、版本管理、PATH问题、pip找不到、python找不到、
   docker找不到、容器运行环境。
-version: 1.1.0
+version: 1.1.1
 type: procedural
 risk_level: low
 status: enabled
@@ -31,7 +31,7 @@ tags:
   - troubleshooting
 metadata:
   author: desirecore
-  updated_at: '2026-04-08'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -51,15 +51,33 @@ market:
   channel: latest
 ---
 
-# Environment Setup Guide
+# environment-setup 技能
 
-本技能提供开发环境的完整配置指南，涵盖三大支柱：
+## L0：一句话摘要
 
-1. **运行时环境**：Python / Node.js 安装与多版本管理（Hatch、Volta、pyenv、nvm）
-2. **容器环境**：Docker / Podman 检测、安装与使用
-3. **Windows 子系统**：WSL2 安装与配置（仅 Windows）
+检测、安装和排查 Python / Node.js / Docker 开发环境，覆盖多版本管理与容器运行时。
 
----
+## L1：概述与使用场景
+
+### 能力描述
+
+environment-setup 是一个**流程型技能（Procedural Skill）**，提供开发环境的完整配置指南，涵盖三大支柱：运行时环境（Python / Node.js）、容器环境（Docker / Podman）、Windows 子系统（WSL2）。
+
+### 使用场景
+
+- 用户需要安装 Python、Node.js 或 Docker
+- 用户遇到 "python not found"、"npm not found"、"docker not found" 等环境问题
+- 用户需要配置多版本管理（Hatch、Volta、pyenv、nvm）
+- 其他技能（docx、pdf、xlsx、pptx）报告 Python 或 Node.js 不可用时
+- Windows 用户需要配置 WSL2
+
+### 核心价值
+
+- **全平台覆盖**：macOS / Windows / Linux 全面支持
+- **多方案对比**：DesireCore 内置方案（Hatch/Volta）与社区方案（pyenv/nvm）对比
+- **故障排查**：常见错误的诊断步骤和解决方案
+
+## L2：详细规范
 
 ## 快速诊断
 

skills/frontend-design/SKILL.md

@@ -10,7 +10,7 @@ description: >-
   界面设计、组件、海报、Landing Page、落地页、React 组件、Vue 组件、
   CSS 样式、美化界面、设计一个、做一个网页、官网、仪表盘、Dashboard。
 license: Complete terms in LICENSE.txt
-version: 1.0.0
+version: 1.0.1
 type: procedural
 risk_level: low
 status: enabled
@@ -24,7 +24,7 @@ tags:
   - html
 metadata:
   author: anthropic
-  updated_at: '2026-04-07'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -48,9 +48,31 @@ market:
   channel: latest
 ---
 
-This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.
+# frontend-design 技能
 
-The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints.
+## L0：一句话摘要
+
+创建有品味、避免 AI 烂大街审美的高质量前端界面与组件。
+
+## L1：概述与使用场景
+
+### 能力描述
+
+frontend-design 是一个**流程型技能（Procedural Skill）**，引导创建独特、生产级的前端界面，避免千篇一律的 AI 生成审美。输出真实可运行的代码，注重美学细节和创意选择。
+
+### 使用场景
+
+- 用户需要创建网页组件、页面或应用（Landing Page、仪表盘、React 组件等）
+- 用户需要为现有 Web UI 进行样式美化
+- 用户需要创建海报、视觉设计等前端产出物
+
+### 核心价值
+
+- **反 AI 审美**：拒绝 Inter 字体 + 紫色渐变的烂大街风格
+- **设计思维驱动**：先确定美学方向，再编写代码
+- **生产级质量**：输出可直接使用的完整代码
+
+## L2：详细规范
 
 ## Output Rule
 

skills/mail-operations/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   Use when 用户提到 邮件、邮箱、收件箱、发邮件、回复邮件、查邮件、Gmail、
   Outlook、QQ邮箱、163邮箱、附件、标签、草稿、自动回复、邮件规则、
   转发、抄送、未读邮件、收信、发信、邮件同步、邮件搜索。
-version: 1.0.0
+version: 1.0.1
 type: procedural
 risk_level: medium
 status: enabled
@@ -23,7 +23,7 @@ tags:
   - smtp
 metadata:
   author: desirecore
-  updated_at: '2026-04-10'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -42,9 +42,32 @@ market:
   channel: latest
 ---
 
-# 邮箱操作
+# mail-operations 技能
 
-通过 DesireCore 本地 REST API 操作邮件系统，支持 Gmail / Outlook / IMAP（QQ、163 等）。
+## L0：一句话摘要
+
+通过本地 REST API 收发邮件、搜索、标签管理和自动规则，支持 Gmail / Outlook / IMAP。
+
+## L1：概述与使用场景
+
+### 能力描述
+
+mail-operations 是一个**流程型技能（Procedural Skill）**，通过 DesireCore 本地 REST API 操作邮件系统。支持 Gmail（OAuth2）、Outlook（MSAL）和 IMAP/SMTP（QQ、163、Yahoo 等）三种邮箱类型，涵盖收发邮件、搜索、标签管理、附件下载、草稿管理和自动规则。
+
+### 使用场景
+
+- 用户需要查看收件箱、发送或回复邮件
+- 用户需要搜索特定邮件或管理邮件标签/分类
+- 用户需要下载附件或管理草稿
+- 用户需要设置自动回复规则或触发智能体处理邮件
+
+### 核心价值
+
+- **统一接口**：三种邮箱通过统一 API 操作，降低使用复杂度
+- **本地安全**：所有操作通过本地 API 完成，无需暴露凭证
+- **智能联动**：支持自动规则和智能体邮件处理
+
+## L2：详细规范
 
 ## API 基础信息
 

skills/manage-skills/SKILL.md

@@ -4,11 +4,11 @@ description: >-
   管理 Agent 的技能生命周期：通过 HTTP API 导入、安装、更新、删除技能，
   或通过 AgentFS 文件系统直接编写符合规范的 SKILL.md。Use when 用户要求
   安装技能、从 URL/Git 导入技能、编写新技能、或管理已有技能。
-version: 1.0.0
+version: 1.0.1
 type: meta
 risk_level: low
 status: enabled
-disable-model-invocation: true
+disable-model-invocation: false
 tags:
   - skill
   - import
@@ -98,6 +98,7 @@ Content-Type: application/json
 ```
 
 **安全限制**：
+
 - 仅允许 HTTPS URL
 - 文件大小上限 20MB
 - 请求超时 30 秒
@@ -163,9 +164,7 @@ Content-Type: application/json
       "id": "data-analysis",
       "path": "data-analysis",
       "content": "---\nname: 数据分析\n...",
-      "sidecarFiles": [
-        { "name": "examples.md", "content": "..." }
-      ]
+      "sidecarFiles": [{ "name": "examples.md", "content": "..." }]
     },
     {
       "id": "report-writing",
@@ -177,6 +176,7 @@ Content-Type: application/json
 ```
 
 API 会自动：
+
 - 使用 `--depth=1` 浅克隆以减少下载量
 - 递归扫描目录中的 SKILL.md 文件
 - 从目录名推导 skillId（fallback 从 frontmatter name 生成 slug）
@@ -315,6 +315,7 @@ Content-Type: application/json
 ```
 
 可选参数：
+
 - `sourceAgentId` — 源 Agent ID（从 agent 级复制时必填）
 - `sourceSource` — 源作用域：`project` | `agent` | `global`
 - `sourceWorkDir` — 源 project workDir（从 project 级复制时使用）
@@ -410,8 +411,8 @@ requires:
 ### 错误处理
 
 | 错误场景 | 处理方式 |
-|---------|---------|
-| ... | ... |
+| -------- | -------- |
+| ...      | ...      |
 ```
 
 #### 使用 Write 工具创建技能示例
@@ -476,60 +477,60 @@ metadata:
 
 #### Frontmatter 字段表
 
-| 字段 | 必填 | 类型 | 说明 |
-|------|------|------|------|
-| `description` | **必填** | string | 技能用途描述，建议包含 "Use when" 触发提示 |
-| `name` | 推荐 | string | 技能显示名称 |
-| `version` | 推荐 | string | 语义版本号（如 `1.0.0`） |
-| `type` | 推荐 | enum | `procedural` / `conversational` / `meta` |
-| `risk_level` | 推荐 | enum | `low` / `medium` / `high` |
-| `status` | 推荐 | enum | `enabled` / `disabled` |
-| `tags` | 可选 | string[] | 标签列表，用于搜索和分类 |
-| `disable-model-invocation` | 可选 | boolean | `true` 时仅允许显式调用，默认 `false` |
-| `requires` | 可选 | object | 依赖声明：`tools`、`optional_tools`、`connections` |
-| `metadata` | 可选 | object | 元信息：`author`、`updated_at` |
-| `market` | 可选 | object | 市场展示元数据（仅市场发布的技能需要） |
+| 字段                       | 必填     | 类型     | 说明                                               |
+| -------------------------- | -------- | -------- | -------------------------------------------------- |
+| `description`              | **必填** | string   | 技能用途描述，建议包含 "Use when" 触发提示         |
+| `name`                     | 推荐     | string   | 技能显示名称                                       |
+| `version`                  | 推荐     | string   | 语义版本号（如 `1.0.0`）                           |
+| `type`                     | 推荐     | enum     | `procedural` / `conversational` / `meta`           |
+| `risk_level`               | 推荐     | enum     | `low` / `medium` / `high`                          |
+| `status`                   | 推荐     | enum     | `enabled` / `disabled`                             |
+| `tags`                     | 可选     | string[] | 标签列表，用于搜索和分类                           |
+| `disable-model-invocation` | 可选     | boolean  | `true` 时仅允许显式调用，默认 `false`              |
+| `requires`                 | 可选     | object   | 依赖声明：`tools`、`optional_tools`、`connections` |
+| `metadata`                 | 可选     | object   | 元信息：`author`、`updated_at`                     |
+| `market`                   | 可选     | object   | 市场展示元数据（仅市场发布的技能需要）             |
 
 #### type 说明
 
-| 类型 | 含义 | 示例 |
-|------|------|------|
-| `procedural` | 流程型，按步骤执行 | 数据分析流程、审批流程 |
-| `conversational` | 对话型，通过多轮对话完成 | 需求收集、头脑风暴 |
-| `meta` | 元技能，管理其他资源 | 创建 Agent、管理技能 |
+| 类型             | 含义                     | 示例                   |
+| ---------------- | ------------------------ | ---------------------- |
+| `procedural`     | 流程型，按步骤执行       | 数据分析流程、审批流程 |
+| `conversational` | 对话型，通过多轮对话完成 | 需求收集、头脑风暴     |
+| `meta`           | 元技能，管理其他资源     | 创建 Agent、管理技能   |
 
 #### Markdown Body 结构（L0 / L1 / L2）
 
-| 层级 | 内容 | 用途 |
-|------|------|------|
-| L0 | 一句话摘要 | 快速理解技能做什么 |
-| L1 | 能力描述 + 使用场景 + 核心价值 | 判断是否适用 |
-| L2 | 详细规范：步骤、API、格式、错误处理 | 具体执行指南 |
+| 层级 | 内容                                | 用途               |
+| ---- | ----------------------------------- | ------------------ |
+| L0   | 一句话摘要                          | 快速理解技能做什么 |
+| L1   | 能力描述 + 使用场景 + 核心价值      | 判断是否适用       |
+| L2   | 详细规范：步骤、API、格式、错误处理 | 具体执行指南       |
 
 ### 6. 作用域说明
 
 技能存在三个作用域层级，按优先级从高到低：
 
-| 优先级 | 作用域 | 路径 | 可见范围 |
-|--------|--------|------|---------|
-| 最高 | Project 级 | `.claude/skills/` (项目根目录) | 当前项目所有 Agent |
-| 中 | Agent 级 | `~/.desirecore/agents/{agentId}/skills/` | 仅该 Agent |
-| 最低 | Global 级 | `~/.desirecore/skills/` | 所有 Agent |
+| 优先级 | 作用域     | 路径                                     | 可见范围           |
+| ------ | ---------- | ---------------------------------------- | ------------------ |
+| 最高   | Project 级 | `.claude/skills/` (项目根目录)           | 当前项目所有 Agent |
+| 中     | Agent 级   | `~/.desirecore/agents/{agentId}/skills/` | 仅该 Agent         |
+| 最低   | Global 级  | `~/.desirecore/skills/`                  | 所有 Agent         |
 
 **同名覆盖规则**：高优先级作用域的同名技能会覆盖低优先级的。例如 Agent 级有一个 `data-analysis` 技能，会覆盖全局同名技能。
 
 ### 7. 错误处理
 
-| 错误码 | 场景 | 处理方式 |
-|--------|------|---------|
-| 400 | 缺少必填字段或格式无效 | 提示用户检查输入，说明哪个字段有问题 |
-| 400 | SKILL.md frontmatter 校验失败 | 展示校验错误详情，引导用户修正 |
-| 404 | 技能不存在 | 提示技能 ID 可能拼写错误，列出可用技能 |
-| 404 | Git 仓库中无 SKILL.md | 提示仓库格式不符合技能规范 |
-| 409 | 技能已存在（冲突写入） | 建议使用 PUT 更新而非 POST 创建 |
-| 413 | 远程文件超过 20MB | 提示文件过大，建议精简内容 |
-| 504 | URL 抓取超时 | 提示网络超时，建议检查 URL 或稍后重试 |
-| 500 | 服务器内部错误 | 提示用户稍后再试 |
+| 错误码 | 场景                          | 处理方式                               |
+| ------ | ----------------------------- | -------------------------------------- |
+| 400    | 缺少必填字段或格式无效        | 提示用户检查输入，说明哪个字段有问题   |
+| 400    | SKILL.md frontmatter 校验失败 | 展示校验错误详情，引导用户修正         |
+| 404    | 技能不存在                    | 提示技能 ID 可能拼写错误，列出可用技能 |
+| 404    | Git 仓库中无 SKILL.md         | 提示仓库格式不符合技能规范             |
+| 409    | 技能已存在（冲突写入）        | 建议使用 PUT 更新而非 POST 创建        |
+| 413    | 远程文件超过 20MB             | 提示文件过大，建议精简内容             |
+| 504    | URL 抓取超时                  | 提示网络超时，建议检查 URL 或稍后重试  |
+| 500    | 服务器内部错误                | 提示用户稍后再试                       |
 
 ### 8. 权限说明
 

skills/manage-teams/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: 团队管理
 description: 创建和管理 Agent 团队，组织多 Agent 协作。Use when 需要多个 Agent 围绕同一任务协作、需要建立组织架构、或需要组长统一调度分派任务时。
-version: 1.2.0
+version: 1.2.1
 type: procedural
 risk_level: medium
 status: enabled
@@ -11,7 +11,7 @@ tags:
   - organization
 metadata:
   author: desirecore
-  updated_at: '2026-03-29'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -34,11 +34,32 @@ market:
   category: productivity
 ---
 
-# 团队管理技能
+# manage-teams 技能
 
-## 概述
+## L0：一句话摘要
 
-团队是 DesireCore 中多个 Agent 围绕共同任务协作的组织单元。每个团队有一个组长（supervisor）负责接收需求、拆解任务、分派给成员、汇总结果。
+创建和管理 Agent 团队，组织多 Agent 围绕共同任务协作。
+
+## L1：概述与使用场景
+
+### 能力描述
+
+manage-teams 是一个**流程型技能（Procedural Skill）**，赋予 DesireCore 创建和管理 Agent 团队的能力。团队是多个 Agent 围绕共同任务协作的组织单元，每个团队有一个组长（supervisor）负责接收需求、拆解任务、分派给成员、汇总结果。
+
+### 使用场景
+
+- 需要多个 Agent 围绕同一任务持续协作（如项目组）
+- 需要建立组织架构（部门/团队层级）
+- 需要组长统一调度、拆解和分派任务
+- 简单一次性委派不够，需要共享上下文的长期协作
+
+### 核心价值
+
+- **组织化协作**：从单点委派升级为团队协作模式
+- **灵活管理**：支持临时团队和持久团队两种模式
+- **动态调整**：运行时可添加/移除成员、更换组长
+
+## L2：详细规范
 
 ## 核心概念
 

skills/pdf/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   user mentions a .pdf file or asks to produce one, use this skill. Use when
   用户提到 PDF、读取PDF、合并PDF、拆分PDF、填写表单、加水印、提取文字、
   扫描识别。
-version: 1.0.0
+version: 1.0.1
 type: procedural
 risk_level: low
 status: enabled
@@ -21,7 +21,7 @@ tags:
   - ocr
 metadata:
   author: anthropic
-  updated_at: '2026-04-04'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -43,7 +43,26 @@ market:
   channel: latest
 ---
 
-# PDF Processing Guide
+# pdf 技能
+
+## L0：一句话摘要
+
+读取、创建、合并、拆分和填写 PDF 文档，支持 OCR 识别和命令行工具。
+
+## L1：概述与使用场景
+
+### 能力描述
+
+pdf 是一个**流程型技能（Procedural Skill）**，提供 PDF 文档的完整处理能力。基于 Python 库（pypdf、pdfplumber、reportlab）和命令行工具（qpdf、pdftotext、pdftk），支持文本提取、表格提取、合并拆分、旋转、水印、加密、表单填写和 OCR 识别。
+
+### 使用场景
+
+- 用户需要从 PDF 中提取文本或表格数据
+- 用户需要合并多个 PDF 或拆分页面
+- 用户需要创建新的 PDF 文档
+- 用户需要填写 PDF 表单、添加水印或加密
+
+## L2：详细规范
 
 ## Prerequisites
 

skills/pptx/SKILL.md

@@ -12,7 +12,7 @@ description: >-
   content afterward. If a .pptx file needs to be opened, created, or touched,
   use this skill. Use when 用户提到 PPT、演示文稿、幻灯片、演讲稿、汇报材料、
   pptx、创建演示、编辑幻灯片。
-version: 1.0.0
+version: 1.0.1
 type: procedural
 risk_level: low
 status: enabled
@@ -25,7 +25,7 @@ tags:
   - office
 metadata:
   author: anthropic
-  updated_at: '2026-04-04'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -48,7 +48,26 @@ market:
   channel: latest
 ---
 
-# PPTX Skill
+# pptx 技能
+
+## L0：一句话摘要
+
+创建、编辑和处理 PowerPoint 演示文稿（.pptx），支持模板编辑和从零创建。
+
+## L1：概述与使用场景
+
+### 能力描述
+
+pptx 是一个**流程型技能（Procedural Skill）**，提供 PowerPoint 演示文稿的完整处理能力。支持通过 pptxgenjs（Node.js）从零创建演示文稿，通过解包 XML 编辑现有模板，以及内容提取和视觉质检。
+
+### 使用场景
+
+- 用户需要创建新的演示文稿（汇报材料、Pitch Deck 等）
+- 用户需要编辑或修改现有 .pptx 文件
+- 用户需要从 .pptx 文件中提取文本内容
+- 用户需要将演示文稿转换为 PDF 或图片
+
+## L2：详细规范
 
 ## Prerequisites
 

skills/s3-storage-operations/SKILL.md

@@ -5,7 +5,7 @@ version: 2.0.1
 type: procedural
 risk_level: medium
 status: enabled
-disable-model-invocation: true
+disable-model-invocation: false
 tags:
   - storage
   - s3
@@ -14,8 +14,8 @@ tags:
   - sharing
 metadata:
   author: desirecore
-  version: "2.0.1"
-  updated_at: "2026-03-13"
+  version: '2.0.1'
+  updated_at: '2026-03-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -78,13 +78,13 @@ PORT=$(cat ~/.desirecore/agent-service.port)
 
 ### API 端点
 
-| 端点 | 方法 | 说明 |
-|------|------|------|
-| `/api/s3/connections` | GET | 列出可用连接摘要 |
-| `/api/s3/upload` | POST | 上传文件（multipart/form-data） |
-| `/api/s3/download` | GET | 生成下载链接或下载文件 |
-| `/api/s3/list` | GET | 列出对象 |
-| `/api/s3/objects` | DELETE | 删除对象 |
+| 端点                  | 方法   | 说明                            |
+| --------------------- | ------ | ------------------------------- |
+| `/api/s3/connections` | GET    | 列出可用连接摘要                |
+| `/api/s3/upload`      | POST   | 上传文件（multipart/form-data） |
+| `/api/s3/download`    | GET    | 生成下载链接或下载文件          |
+| `/api/s3/list`        | GET    | 列出对象                        |
+| `/api/s3/objects`     | DELETE | 删除对象                        |
 
 ### 快速参考
 
@@ -129,11 +129,11 @@ curl -k -X DELETE "https://127.0.0.1:${PORT}/api/s3/objects" \
 
 ### 安全红线
 
-| 规则 | 说明 |
-|------|------|
-| **禁止上传敏感文件** | `.env`、凭证文件、私钥等绝不上传 |
-| **删除前必须确认** | 调用删除 API 前应与用户确认意图 |
-| **不假设连接存在** | API 返回 `NO_CONNECTION` 时，引导用户在界面中添加连接 |
+| 规则                 | 说明                                                  |
+| -------------------- | ----------------------------------------------------- |
+| **禁止上传敏感文件** | `.env`、凭证文件、私钥等绝不上传                      |
+| **删除前必须确认**   | 调用删除 API 前应与用户确认意图                       |
+| **不假设连接存在**   | API 返回 `NO_CONNECTION` 时，引导用户在界面中添加连接 |
 
 ### 集成点
 

skills/update-agent/SKILL.md

@@ -3,11 +3,11 @@ name: 更新智能体
 description: >-
   安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent
   行为、安装/卸载技能、调整配置、回滚变更或修订规则。
-version: 3.0.0
+version: 3.0.1
 type: meta
 risk_level: low
 status: enabled
-disable-model-invocation: true
+disable-model-invocation: false
 tags:
   - agent
   - update
@@ -67,14 +67,14 @@ update-agent 是一个**元技能（Meta-Skill）**，允许用户通过对话
 
 ### 支持的更新类型
 
-| 更新类型 | 目标文件 | 风险等级 | 示例 |
-|---------|---------|---------|------|
-| Persona 更新 | `persona.md` | 中 | 修改沟通风格、价值观 |
-| Principles 更新 | `principles.md` | 高 | 添加/修改行为规则 |
-| Skills 安装 | `skills/` | 中 | 添加新技能包 |
-| Skills 卸载 | `skills/` | 低 | 移除技能包 |
-| Memory 更新 | `memory/` | 低 | 添加知识条目 |
-| Tools 配置 | `tools/` | 高 | 修改工具权限 |
+| 更新类型        | 目标文件        | 风险等级 | 示例                 |
+| --------------- | --------------- | -------- | -------------------- |
+| Persona 更新    | `persona.md`    | 中       | 修改沟通风格、价值观 |
+| Principles 更新 | `principles.md` | 高       | 添加/修改行为规则    |
+| Skills 安装     | `skills/`       | 中       | 添加新技能包         |
+| Skills 卸载     | `skills/`       | 低       | 移除技能包           |
+| Memory 更新     | `memory/`       | 低       | 添加知识条目         |
+| Tools 配置      | `tools/`        | 高       | 修改工具权限         |
 
 ### 对话流程
 
@@ -92,6 +92,7 @@ update-agent 是一个**元技能（Meta-Skill）**，允许用户通过对话
 ### 阶段 1：意图识别
 
 **触发条件**（任一满足）：
+
 - 用户说"修改你的..."、"更新你的..."、"调整一下..."
 - 用户说"你以后要..."、"记住这个规则..."
 - 用户说"安装/卸载这个技能..."
@@ -103,21 +104,21 @@ update-agent 是一个**元技能（Meta-Skill）**，允许用户通过对话
 
 **分析维度**：
 
-| 维度 | 说明 |
-|------|------|
-| 影响范围 | 影响哪些文件、哪些行为 |
+| 维度     | 说明                     |
+| -------- | ------------------------ |
+| 影响范围 | 影响哪些文件、哪些行为   |
 | 风险等级 | 低/中/高（见风险分级表） |
-| 依赖检查 | 是否影响其他配置 |
-| 冲突检测 | 是否与现有规则冲突 |
+| 依赖检查 | 是否影响其他配置         |
+| 冲突检测 | 是否与现有规则冲突       |
 
 **风险分级表**：
 
-| 风险等级 | 条件 | 确认要求 |
-|---------|------|---------|
-| 低 | 仅影响非核心配置（如记忆条目） | 简单确认 |
-| 中 | 影响 persona 或普通 principles | 展示 diff 后确认 |
-| 高 | 影响核心 principles 或工具权限 | 详细说明 + diff + 确认 |
-| 受保护 | 触及受保护路径 | 阻断，需 owner 权限 |
+| 风险等级 | 条件                           | 确认要求               |
+| -------- | ------------------------------ | ---------------------- |
+| 低       | 仅影响非核心配置（如记忆条目） | 简单确认               |
+| 中       | 影响 persona 或普通 principles | 展示 diff 后确认       |
+| 高       | 影响核心 principles 或工具权限 | 详细说明 + diff + 确认 |
+| 受保护   | 触及受保护路径                 | 阻断，需 owner 权限    |
 
 ### 阶段 3：Diff 生成
 
@@ -145,7 +146,7 @@ diff_metadata:
   lines_removed: 1
   risk_level: medium
   reversible: true
-  estimated_impact: "沟通风格会变得更正式"
+  estimated_impact: '沟通风格会变得更正式'
 ```
 
 ### 阶段 4：用户确认
@@ -168,6 +169,7 @@ diff_metadata:
 ```
 
 **确认选项**：
+
 - **应用**：执行变更
 - **取消**：放弃变更
 - **修改**：进入编辑模式微调
@@ -220,34 +222,34 @@ git show <commit>:persona.md
 
 **更新操作对照表**：
 
-| 用户意图 | 目标文件 | AgentFS 路径 |
-|---------|---------|-------------|
-| 修改性格/风格 | `persona.md` | `~/.desirecore/agents/<agentId>/persona.md` |
-| 修改行为规则 | `principles.md` | `~/.desirecore/agents/<agentId>/principles.md` |
-| 安装/卸载技能 | `skills/` | `~/.desirecore/agents/<agentId>/skills/` |
-| 修改工具配置 | `tools/` | `~/.desirecore/agents/<agentId>/tools/` |
-| 添加记忆 | `memory/` | `~/.desirecore/agents/<agentId>/memory/` |
-| 修改运行时配置 | `agent.json` | `~/.desirecore/agents/<agentId>/agent.json` |
+| 用户意图       | 目标文件        | AgentFS 路径                                   |
+| -------------- | --------------- | ---------------------------------------------- |
+| 修改性格/风格  | `persona.md`    | `~/.desirecore/agents/<agentId>/persona.md`    |
+| 修改行为规则   | `principles.md` | `~/.desirecore/agents/<agentId>/principles.md` |
+| 安装/卸载技能  | `skills/`       | `~/.desirecore/agents/<agentId>/skills/`       |
+| 修改工具配置   | `tools/`        | `~/.desirecore/agents/<agentId>/tools/`        |
+| 添加记忆       | `memory/`       | `~/.desirecore/agents/<agentId>/memory/`       |
+| 修改运行时配置 | `agent.json`    | `~/.desirecore/agents/<agentId>/agent.json`    |
 
 ### 错误处理
 
-| 错误场景 | 处理方式 |
-|---------|---------|
-| 尝试修改受保护路径 | 阻断操作，提示需要 owner 权限 |
-| 文件不存在 | Agent 或目标文件不存在，提示用户检查 |
-| 权限不足 | 文件系统权限错误，提示用户检查目录权限 |
-| 回滚版本不存在 | 列出可用版本，请用户重新选择 |
+| 错误场景           | 处理方式                               |
+| ------------------ | -------------------------------------- |
+| 尝试修改受保护路径 | 阻断操作，提示需要 owner 权限          |
+| 文件不存在         | Agent 或目标文件不存在，提示用户检查   |
+| 权限不足           | 文件系统权限错误，提示用户检查目录权限 |
+| 回滚版本不存在     | 列出可用版本，请用户重新选择           |
 
 ### 权限要求
 
-| 操作 | 所需角色 |
-|------|---------|
-| 更新 persona | owner, member |
+| 操作                        | 所需角色      |
+| --------------------------- | ------------- |
+| 更新 persona                | owner, member |
 | 更新 principles（普通规则） | owner, member |
-| 更新 principles（安全红线） | owner |
-| 安装/卸载 skills | owner, member |
-| 修改 tools 权限 | owner |
-| 版本回滚 | owner |
+| 更新 principles（安全红线） | owner         |
+| 安装/卸载 skills            | owner, member |
+| 修改 tools 权限             | owner         |
+| 版本回滚                    | owner         |
 
 ---
 

skills/web-access/SKILL.md

@@ -14,7 +14,7 @@ description: >-
   新闻、网址、URL、找一下、搜一下、查一下、小红书、B站、微博、飞书、Twitter、
   推特、X、知乎、公众号、已登录、登录状态。
 license: Complete terms in LICENSE.txt
-version: 1.1.0
+version: 1.1.1
 type: procedural
 risk_level: low
 status: enabled
@@ -29,7 +29,7 @@ tags:
   - playwright
 metadata:
   author: desirecore
-  updated_at: '2026-04-07'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -54,15 +54,32 @@ market:
   channel: latest
 ---
 
-# Web Access Skill
+# web-access 技能
 
-Three-layer web access toolkit:
+## L0：一句话摘要
 
-1. **Layer 1 — Search & Fetch**: `WebSearch` + `WebFetch` for public pages
-2. **Layer 2 — Jina Reader**: default token-optimized extraction for heavy/JS-rendered pages
-3. **Layer 3 — CDP Browser**: Chrome DevTools Protocol for login-gated sites (小红书/B站/微博/飞书/Twitter)
+三层联网访问工具包——搜索公开页面、Jina 优化抓取、CDP 登录态浏览器访问。
 
----
+## L1：概述与使用场景
+
+### 能力描述
+
+web-access 是一个**流程型技能（Procedural Skill）**，提供三层互补的联网访问能力：Layer 1（WebSearch + WebFetch）用于公开页面；Layer 2（Jina Reader）用于 JS 渲染的重页面，默认节省 Token；Layer 3（Chrome CDP）用于需要登录态的站点（小红书/B站/微博/飞书/Twitter）。
+
+### 使用场景
+
+- 用户需要搜索当前信息或研究特定主题
+- 用户需要抓取公开网页内容或技术文档
+- 用户需要访问登录态站点（小红书、B站、微博、飞书、Twitter 等）
+- 用户需要对比产品、聚合新闻或调查 API/库版本
+
+### 核心价值
+
+- **三层递进**：从轻量搜索到重度 JS 渲染到登录态访问，按需选择
+- **Token 优化**：Jina Reader 默认减少 50-80% Token 消耗
+- **登录态复用**：通过 CDP 连接用户已登录的 Chrome，无需重复登录
+
+## L2：详细规范
 
 ## Output Rule
 

skills/xlsx/SKILL.md

@@ -15,7 +15,7 @@ description: >-
   report, standalone Python script, database pipeline, or Google Sheets API
   integration, even if tabular data is involved. Use when 用户提到 Excel、
   电子表格、xlsx、表格处理、公式计算、数据清洗、图表、CSV导入导出。
-version: 1.0.0
+version: 1.0.1
 type: procedural
 risk_level: low
 status: enabled
@@ -27,7 +27,7 @@ tags:
   - office
 metadata:
   author: anthropic
-  updated_at: '2026-04-04'
+  updated_at: '2026-04-13'
 market:
   icon: >-
     <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -50,6 +50,27 @@ market:
   channel: latest
 ---
 
+# xlsx 技能
+
+## L0：一句话摘要
+
+创建、编辑和分析 Excel 电子表格（.xlsx），支持公式、格式、数据分析和可视化。
+
+## L1：概述与使用场景
+
+### 能力描述
+
+xlsx 是一个**流程型技能（Procedural Skill）**，提供 Excel 电子表格的完整处理能力。基于 Python 库（openpyxl、pandas），支持创建新表格、编辑现有文件、数据分析、公式计算、格式设置和图表生成，并通过 LibreOffice 实现公式重算和错误检测。
+
+### 使用场景
+
+- 用户需要创建新的 Excel 电子表格（财务模型、数据报告等）
+- 用户需要编辑或修改现有 .xlsx 文件
+- 用户需要进行数据分析、清洗或格式转换（CSV/TSV → XLSX）
+- 用户需要添加公式、图表或格式化现有表格
+
+## L2：详细规范
+
 ## Prerequisites
 
 ### Python 3（必需）