@chantezy/mcp-jingwei 1.0.0

package/skills/product-discussion/references/platform-spec.md

@@ -0,0 +1,489 @@
+# 精卫平台（4399云文档 & 4399项目管理）深度功能分析报告
+
+> 分析时间：2026-06-04  
+> 平台版本：v2.6.6  
+> 分析方式：通过Agent控制浏览器实际操作、DOM解析、页面截图
+
+---
+
+## 一、产品概述
+
+| 项目 | 内容 |
+| :--- | :--- |
+| **产品名称** | 精卫（Jingwei） |
+| **产品类型** | 企业级文档管理 + 项目协作一体化平台 |
+| **所属行业** | 互联网/游戏行业内部工具（4399集团） |
+| **核心用户** | 产品经理、交互设计师、开发团队、运营团队、客服团队 |
+| **核心价值主张** | 将文档管理与项目管理深度融合，提供统一的知识沉淀和任务协作工作空间 |
+| **解决的问题** | 团队信息分散、知识管理困难、项目进度不透明、跨团队协作效率低 |
+| **差异化优势** | 文档与项目数据互通；支持多种文档类型（富文本、Markdown、甘特图）；企微消息通知集成 |
+
+---
+
+## 二、产品功能架构拆解
+
+### 2.1 系统顶层架构
+
+```
+精卫平台 (https://note.4399doc.com/prd)
+├── 4399云文档（文档中心）
+│   ├── 文档仪表盘
+│   ├── 文档编辑器
+│   └── 文档库管理
+│
+├── 4399项目管理（项目中心）
+│   ├── 项目仪表盘
+│   ├── 我的任务
+│   ├── 项目详情（看板/表格/甘特图）
+│   └── 团队管理
+│
+└── 全局功能
+    ├── 帮助中心
+    ├── 消息通知
+    ├── 版本更新
+    └── 用户中心
+```
+
+---
+
+### 2.2 文档中心（4399云文档）功能树
+
+```
+4399云文档
+├── 顶部导航栏
+│   ├── Logo + 产品标题 "4399云文档"
+│   ├── 全局搜索入口 "搜索文档"
+│   ├── 版本更新提示（带"new"徽章）
+│   ├── 消息通知（铃铛图标，显示"99+"）
+│   ├── 帮助中心入口（问号图标）
+│   └── 用户信息（头像 + 昵称）
+│
+├── 左侧边栏 - 文档库面板
+│   ├── 文档库标题 + 数量
+│   ├── 新建文档库按钮（+）
+│   ├── 展开/收起按钮
+│   ├── 项目选择
+│   └── 文档库列表
+│
+├── 主内容区 - 文档仪表盘
+│   ├── 标签页切换
+│   │   ├── 最近查看（默认）
+│   │   └── 我的收藏
+│   │
+│   ├── 最近查看
+│   │   ├── 筛选区
+│   │   │   ├── 按标题搜索（输入框）
+│   │   │   ├── 按更新人搜索（输入框）
+│   │   │   ├── 重置按钮
+│   │   │   └── 搜索按钮
+│   │   ├── 操作区
+│   │   │   └── 移除查看记录（危险按钮，disabled状态）
+│   │   ├── 文档列表表格
+│   │   │   ├── 复选框列（批量选择）
+│   │   │   ├── 标题列（含文档图标 + 文档名称）
+│   │   │   ├── 更新人列
+│   │   │   ├── 查看时间列（支持排序）
+│   │   │   └── 收藏列（星标图标）
+│   │   └── 分页器
+│   │       ├── 总数显示
+│   │       ├── 每页条数选择（10条/页）
+│   │       ├── 页码导航
+│   │       └── 跳转至指定页
+│   │
+│   └── 我的收藏
+│       ├── 筛选区（标题 + 更新人）
+│       ├── 文档列表表格
+│       │   ├── 标题列
+│       │   ├── 更新人列
+│       │   ├── 收藏时间列（区别于查看时间）
+│       │   └── 取消收藏操作
+│       └── 分页器（共4条）
+│
+└── 全局搜索面板（点击"搜索文档"展开）
+    ├── 搜索关键词输入框
+    ├── 需求创建者筛选
+    ├── 项目选择器（下拉框）
+    ├── 版本选择器（下拉框）
+    ├── 创建年份选择器（下拉框）
+    ├── 排序方式选择（更新时间降序等）
+    ├── 重置按钮
+    ├── 搜索按钮
+    └── 搜索结果列表（20条/页）
+```
+
+---
+
+### 2.3 文档编辑器功能树
+
+```
+文档编辑器（基于 ProseMirror/TipTap）
+├── 左侧导航面板
+│   ├── 文件夹树形结构
+│   │   ├── 文件夹（可展开/收起）
+│   │   └── 文档项（noteItem）
+│   └── 导航列表（navigatorList）
+│
+├── 顶部工具栏
+│   ├── 返回按钮
+│   ├── 文档标题（可编辑）
+│   └── 文档状态指示
+│
+├── 编辑区域（ProseMirror编辑器）
+│   ├── 富文本编辑
+│   ├── 目录导航（自动生成）
+│   └── 内容渲染区
+│
+├── 浮动工具栏（选中文字时出现）
+│   └── 文字格式化操作
+│
+└── 文档功能
+    ├── 创建文档（富文本）
+    ├── 创建 Markdown
+    ├── 创建甘特图
+    ├── 创建/编辑/删除文件夹
+    ├── 文档中插入链接
+    ├── 文档中插入表格
+    ├── 文档中插入图片（支持拖拽调整大小）
+    ├── 文档中插入视频
+    ├── 上传文件转在线文档
+    ├── 导入文档
+    ├── 引用云文档内容
+    ├── 附件上传
+    ├── 文档批注
+    ├── 文档演示模式
+    ├── AI速览
+    ├── 文档收藏
+    ├── 最近查看记录
+    ├── 历史操作记录（版本管理）
+    ├── 自定义排序
+    ├── 文件夹分享
+    └── 同步知识库
+```
+
+---
+
+### 2.4 项目管理（4399项目管理）功能树
+
+```
+4399项目管理
+├── 顶部导航栏
+│   ├── Logo + 产品标题 "4399项目管理"
+│   ├── 版本更新提示（带"new"徽章）
+│   ├── 消息通知（铃铛图标）
+│   ├── 帮助中心入口
+│   └── 用户信息
+│
+├── 项目仪表盘（projectDashboard）
+│   ├── 我的任务区块
+│   │   ├── 任务总数（共79个任务）
+│   │   ├── 任务列表预览（前5条）
+│   │   │   ├── 任务名称
+│   │   │   ├── 所属项目名称（彩色标签）
+│   │   │   └── 优先级标识
+│   │   └── "查看更多"链接 → 跳转至任务列表页
+│   │
+│   ├── 团队区块
+│   │   ├── 团队名称
+│   │   ├── 团队人数
+│   │   ├── 任务统计面板
+│   │   │   ├── 进行中的任务（绿色）
+│   │   │   ├── 已逾期任务（红色）
+│   │   │   └── 总任务数量（蓝色）
+│   │   └── "创建团队"按钮
+│   │
+│   ├── 帮助中心区块
+│   │   ├── 帮助文档入口
+│   │   ├── 版本更新日志列表
+│   │   └── "查看更多"链接
+│   │
+│   └── 我的项目区块
+│       ├── 项目卡片网格
+│       └── 新建项目按钮
+│
+├── 我的任务页面（myTask）
+│   ├── 页面标题 "我的任务"
+│   ├── 筛选控制栏
+│   │   ├── 执行者筛选（"显示所有执行者"）
+│   │   ├── 自定义筛选
+│   │   └── 表头配置（支持自定义列）
+│   ├── 表头修改提示（"当前表头有修改未保存"）
+│   ├── 保存配置按钮
+│   ├── 任务列表表格
+│   │   ├── 任务名称列（含项目标签颜色标识）
+│   │   ├── 开始时间列
+│   │   ├── 截止时间列
+│   │   ├── 优先级列
+│   │   │   ├── 非常紧急（红色）
+│   │   │   ├── 紧急
+│   │   │   ├── 普通
+│   │   │   └── 待设置
+│   │   └── 所属项目列
+│   └── 空状态提示（"当前暂无任务"）
+│
+└── 项目详情页（project/:id）
+    ├── 项目名称 + 状态
+    ├── 工具栏
+    ├── 视图切换
+    │   ├── 看板视图（Kanban）
+    │   ├── 表格视图（Table）
+    │   └── 甘特图视图（Gantt）
+    ├── 任务分组
+    ├── 任务自定义字段
+    ├── 任务详情页
+    │   ├── 任务描述
+    │   ├── 附件上传（支持视频）
+    │   ├── 评论功能
+    │   └── 任务详情展示样式
+    ├── 自定义筛选
+    ├── 归档功能
+    ├── 回收站
+    └── 项目成员管理
+```
+
+---
+
+## 三、核心业务流程分析
+
+### 3.1 文档管理核心流程
+
+| 阶段       | 用户行为                  | 页面     | 系统动作                           |
+| :------- | :-------------------- | :----- | :----------------------------- |
+| **进入**   | 用户访问 `#/docDashboard` | 文档仪表盘  | 加载最近查看列表，显示文档库侧边栏              |
+| **浏览**   | 切换标签页"最近查看"/"我的收藏"    | 文档仪表盘  | 刷新列表数据，切换显示列（查看时间 ↔ 收藏时间）      |
+| **搜索**   | 点击"搜索文档"，输入关键词        | 全局搜索面板 | 展开高级搜索面板，支持按关键词/创建者/项目/版本/年份筛选 |
+| **定位文档** | 在左侧文档库点击某个库           | 文档仪表盘  | 切换到该文档库的文档列表                   |
+| **查看文档** | 点击文档标题                | 文档编辑器  | 打开文档详情页，加载ProseMirror编辑器       |
+| **编辑文档** | 在编辑器中修改内容             | 文档编辑器  | 实时保存，支持富文本/Markdown/甘特图编辑      |
+| **收藏**   | 点击星标图标                | 文档列表   | 将文档加入"我的收藏"，记录收藏时间             |
+| **分享**   | 使用分享功能                | 文档编辑器  | 生成分享链接，支持文档库项目分享               |
+| **协作**   | 邀请成员/成员管理             | 文档库设置  | 添加协作者，设置权限                     |
+
+### 3.2 项目管理核心流程
+
+| 阶段        | 用户行为                      | 页面     | 系统动作                 |
+| :-------- | :------------------------ | :----- | :------------------- |
+| **进入**    | 用户访问 `#/projectDashboard` | 项目仪表盘  | 加载我的任务、团队统计、项目列表     |
+| **查看任务**  | 点击"查看更多"                  | 我的任务页面 | 展示完整任务列表，支持按执行者筛选    |
+| **管理任务**  | 修改表头配置、筛选条件               | 我的任务页面 | 自定义列显示、保存配置          |
+| **进入项目**  | 点击项目卡片                    | 项目详情页  | 加载项目看板/表格/甘特图视图      |
+| **创建任务**  | 在项目中新建任务                  | 项目详情页  | 填写任务名称、优先级、截止时间、所属项目 |
+| **跟踪进度**  | 切换看板/表格/甘特图视图             | 项目详情页  | 多维度展示任务进度            |
+| **任务协作**  | 评论、上传附件                   | 任务详情页  | 支持文字评论、视频上传、文件附件     |
+| **归档/回收** | 归档已完成任务                   | 项目详情页  | 移入归档区或回收站            |
+
+---
+
+## 四、信息架构（IA）分析
+
+### 4.1 导航结构
+
+```
+精卫平台
+├── 一级导航（产品切换）
+│   ├── 4399云文档（文档中心）
+│   └── 4399项目管理（项目中心）
+│
+├── 文档中心内部导航
+│   ├── 顶部：全局搜索 | 版本更新 | 通知 | 帮助 | 用户
+│   ├── 左侧：文档库列表（固定项 + 可展开列表）
+│   └── 主区：标签页（最近查看 | 我的收藏）
+│
+└── 项目管理内部导航
+    ├── 顶部：版本更新 | 通知 | 帮助 | 用户
+    ├── 主区仪表盘：任务概览 | 团队 | 帮助 | 项目列表
+    └── 二级页面：我的任务 | 项目详情
+```
+
+### 4.2 页面层级
+
+```
+层级1：产品入口
+  ├── https://note.4399doc.com/prd#/docDashboard    （文档仪表盘）
+  └── https://note.4399doc.com/prd#/projectDashboard （项目仪表盘）
+
+层级2：功能页面
+  ├── https://note.4399doc.com/prd#/myTask           （我的任务）
+  └── https://note.4399doc.com/prd#/project/:id      （项目详情）
+
+层级3：内容页面
+  └── https://note.4399doc.com/prd?doc=:id#/doc/:id  （文档编辑器）
+```
+
+### 4.3 信息组织方式评价
+
+| 评价维度 | 评价 | 说明 |
+| :--- | :--- | :--- |
+| **符合用户认知** | ⭐⭐⭐⭐ | 文档与项目分开管理，符合主流协同工具分类方式 |
+| **易于发现功能** | ⭐⭐⭐⭐ | 左侧文档库一目了然，项目仪表盘分区清晰 |
+| **信息层级合理** | ⭐⭐⭐⭐ | 三层页面层级清晰，不嵌套过深 |
+| **搜索可达性** | ⭐⭐⭐⭐⭐ | 全局搜索支持多维度筛选（关键词/创建者/项目/版本/年份） |
+| **导航一致性** | ⭐⭐⭐⭐ | 两个产品共用顶部导航风格，操作习惯一致 |
+
+---
+
+## 五、用户角色分析
+
+| 角色 | 目标 | 核心操作 | 权限范围 |
+| :--- | :--- | :--- | :--- |
+| **普通成员** | 查看文档、了解项目进度 | 搜索/查看文档、查看任务列表 | 对文档库有只读权限，对所属项目有查看权限 |
+| **文档编辑者** | 创建和维护文档 | 创建/编辑/删除文档、管理文件夹 | 对指定文档库有读写权限 |
+| **项目成员** | 参与项目任务执行 | 查看/更新任务状态、评论、上传附件 | 对所属项目有任务操作权限 |
+| **项目管理员** | 管理项目和团队 | 创建项目、管理成员、配置字段、归档任务 | 对项目有完整管理权限 |
+| **文档库管理员** | 管理文档库 | 创建文档库、邀请成员、设置权限 | 对文档库有完整管理权限 |
+| **团队管理员** | 管理团队 | 创建团队、管理团队成员 | 团队级别的管理权限 |
+| **超级管理员** | 平台全局管理 | 用户管理、权限分配、系统配置 | 平台所有功能的最高权限 |
+
+---
+
+## 六、技术架构分析
+
+### 6.1 前端技术栈
+
+| 技术 | 用途 |
+| :--- | :--- |
+| **Vue.js 2.x** | 前端框架（通过 `__vue__` 实例确认） |
+| **Vue Router** | 路由管理（Hash模式：`#/docDashboard`） |
+| **Ant Design Vue** | UI组件库（`ant-table`、`ant-btn`、`ant-pagination`、`ant-select`等） |
+| **ProseMirror** | 富文本编辑器内核 |
+| **TipTap** | 基于ProseMirror的编辑器框架 |
+| **SVG图标系统** | 自定义JwIcon组件 |
+
+### 6.2 URL路由结构
+
+| 路由 | 页面 | 说明 |
+| :--- | :--- | :--- |
+| `#/docDashboard` | 文档仪表盘 | 文档中心首页 |
+| `#/projectDashboard` | 项目仪表盘 | 项目管理首页 |
+| `#/myTask` | 我的任务 | 个人任务列表 |
+| `#/project/:id` | 项目详情 | 具体项目看板/表格/甘特图 |
+| `#/doc/:id` | 文档详情 | 文档编辑器页面 |
+
+### 6.3 数据标识
+
+| 类型 | ID格式 | 示例 |
+| :--- | :--- | :--- |
+| 文档库 | MongoDB ObjectId | `e0cf0b1d47e98d6ef677c92c` |
+| 文档 | MongoDB ObjectId | `346e7ff94ff89012beb2ea3b` |
+| 项目 | 数字ID | `42`、`327`、`355` |
+
+---
+
+## 七、功能模块详细清单
+
+### 7.1 文档中心功能清单
+
+| 功能模块      | 功能点                       | 状态              |
+| :-------- | :------------------------ | :-------------- |
+| **文档管理**  | 创建文档（富文本）                 | ✅ 已实现           |
+|           | 创建 Markdown               | ✅ 已实现           |
+|           | 创建甘特图                     | ✅ 已实现           |
+|           | 导入文档                      | ✅ 已实现           |
+|           | 上传文件转在线文档                 | ✅ 已实现           |
+|           | 创建/编辑/删除文件夹               | ✅ 已实现           |
+| **编辑能力**  | 富文本编辑（ProseMirror/TipTap） | ✅ 已实现           |
+|           | 文档中插入链接                   | ✅ 已实现           |
+|           | 文档中插入表格                   | ✅ 已实现           |
+|           | 文档中插入图片（可拖拽调整）            | ✅ 已实现           |
+|           | 文档中插入视频                   | ✅ 已实现（v2.6.6新增） |
+|           | 引用云文档内容                   | ✅ 已实现           |
+|           | 附件上传                      | ✅ 已实现           |
+|           | 文档批注                      | ✅ 已实现           |
+|           | 文档演示模式                    | ✅ 已实现           |
+|           | AI速览                      | ✅ 已实现           |
+| **组织管理**  | 文档库管理                     | ✅ 已实现           |
+|           | 自定义排序                     | ✅ 已实现（v2.6.6新增） |
+|           | 文件夹下显示子文件夹                | ✅ 已实现（v2.6.6新增） |
+|           | 邀请成员/成员管理                 | ✅ 已实现           |
+| **查找与检索** | 全局搜索（关键词）                 | ✅ 已实现           |
+|           | 按创建者筛选                    | ✅ 已实现           |
+|           | 按项目筛选                     | ✅ 已实现           |
+|           | 按版本筛选                     | ✅ 已实现           |
+|           | 按创建年份筛选                   | ✅ 已实现           |
+|           | 排序方式选择                    | ✅ 已实现           |
+| **个人中心**  | 最近查看                      | ✅ 已实现           |
+|           | 我的收藏                      | ✅ 已实现           |
+|           | 移除查看记录                    | ✅ 已实现           |
+|           | 历史操作记录                    | ✅ 已实现           |
+| **分享协作**  | 分享文档库项目                   | ✅ 已实现           |
+|           | 文件夹分享                     | ✅ 已实现           |
+|           | 同步知识库                     | ✅ 已实现           |
+| **通知系统**  | 浏览器桌面推送                   | ✅ 已实现           |
+|           | 企微消息通知                    | ✅ 已实现           |
+|           | 消息通知设置                    | ✅ 已实现           |
+
+### 7.2 项目管理功能清单
+
+| 功能模块     | 功能点                   | 状态              |
+| :------- | :-------------------- | :-------------- |
+| **仪表盘**  | 我的任务概览                | ✅ 已实现           |
+|          | 团队统计（人数/进行中/逾期/总数）    | ✅ 已实现           |
+|          | 项目列表                  | ✅ 已实现           |
+|          | 版本更新日志                | ✅ 已实现           |
+|          | 帮助中心入口                | ✅ 已实现           |
+| **任务管理** | 我的任务列表                | ✅ 已实现           |
+|          | 任务筛选（执行者）             | ✅ 已实现           |
+|          | 自定义筛选                 | ✅ 已实现           |
+|          | 表头自定义配置               | ✅ 已实现           |
+|          | 任务优先级（非常紧急/紧急/普通/待设置） | ✅ 已实现           |
+|          | 任务时间管理（开始/截止时间）       | ✅ 已实现           |
+|          | 任务所属项目关联              | ✅ 已实现           |
+| **项目视图** | 看板视图（Kanban）          | ✅ 已实现           |
+|          | 表格视图（Table）           | ✅ 已实现           |
+|          | 甘特图视图（Gantt）          | ✅ 已实现           |
+|          | 看板任务分组                | ✅ 已实现           |
+| **项目功能** | 任务自定义字段               | ✅ 已实现           |
+|          | 任务详情页                 | ✅ 已实现           |
+|          | 任务详情视频上传              | ✅ 已实现（v2.6.6新增） |
+|          | 任务详情展示样式              | ✅ 已实现           |
+|          | 看板评论功能                | ✅ 已实现           |
+|          | 归档功能                  | ✅ 已实现           |
+|          | 回收站                   | ✅ 已实现           |
+|          | 项目成员管理                | ✅ 已实现           |
+| **团队管理** | 创建团队                  | ✅ 已实现           |
+|          | 团队成员管理                | ✅ 已实现           |
+|          | 我的团队                  | ✅ 已实现           |
+
+---
+
+## 八、版本迭代记录
+
+| 版本         | 发布时间       | 主要更新                                                                                                                         |
+| :--------- | :--------- | :--------------------------------------------------------------------------------------------------------------------------- |
+| **v2.6.6** | 2026年5月21日 | 文档自定义排序、文件夹子文件夹显示、文档视频上传、项目详情视频上传                                                                                            |
+
+
+---
+
+## 九、页面截图参考
+
+主要截图已保存至`references/img`：
+
+- `doc_dashboard_full.png` - 文档首页
+- `doc_list_page.png` - 文档列表
+- `doc_search.png` - 文档搜索
+- `doc_collect.png` - 文档收藏
+- `doc_Recently.png` - 文档最近查看
+- `doc_Information.png` - 文档消息中心
+- `project_dashboard.png` - 项目管理首页
+- `my_tasks.png` - 我的任务
+- `my_team.png` - 我的团队
+- `task_management_Kanban.png` - 任务管理-看板
+- `task_management_Form.png` - 任务管理-表格
+- `task_management_Gantt.png` - 任务管理-甘特图
+- `task_Details.png` - 任务详情
+
+---
+
+## 十、总结与评价
+
+### 优势
+1. **文档与项目深度融合**：文档库与项目管理共享同一平台，信息流转顺畅
+2. **多视图支持**：项目管理支持看板、表格、甘特图三种视图，满足不同场景需求
+3. **强大的搜索能力**：全局搜索支持5个维度的筛选条件
+4. **丰富的文档类型**：支持富文本、Markdown、甘特图等多种文档格式
+5. **企业级协作**：集成企微消息通知、浏览器推送等企业级功能
+
+### 待改进
+1. **项目详情页加载**：部分项目详情页存在加载缓慢或无法加载的问题
+2. **文档点击交互**：文档列表中的点击事件响应有待优化（需通过Vue Router而非直接URL跳转）
+3. **信息密度**：仪表盘信息密度较高，新用户可能需要一定的学习成本

package/skills/version-update-description/README.md

@@ -0,0 +1,68 @@
+# jingwei-version-update-description
+
+> 精卫平台（4399 内部工具）版本更新描述生成 Skill
+> 通过功能名称快速生成飞书风格的功能价值描述文案。
+
+---
+
+## 这是什么
+
+一个部署在 Claude 上的 Skill，输入功能标题（如「文档：支持 XX」），自动输出标准化的版本更新介绍：
+
+```
+文档：支持给评论中的图片添加框选标记
+在文档评论中插入图片时，你可以在图片上添加框选标记。回复包含图片的评论时，也可在原评论中的图片上添加框选标记，针对图片特定区域进行讨论。
+```
+
+**输出特点**：
+- 固定结构：标题行 + 用途句 + 价值句（+ 可选「了解详情」行）
+- 两句成文，正文 40-70 字，不冗余
+- 用户视角（以"你"为主语），办公软件文案语气
+- 贴合精卫平台定位（文档系统 + 项目管理系统）
+
+---
+
+## 文件结构
+
+```
+version-update-description/
+├── README.md      # 本文件
+└── SKILL.md       # Skill 主文件（输出结构、风格规则、输入处理、示例、自检清单）
+```
+
+---
+
+## 快速开始
+
+直接在对话中给出功能标题即可，无需特殊指令：
+
+```
+幻灯片：移动端支持演示模式
+文档：支持给评论中的图片添加框选标记
+项目管理：看板卡片支持按负责人筛选
+```
+
+也支持：
+- 只给功能名（自动补全所属系统前缀）
+- 一句话描述（自动提炼为标准标题）
+- 一次给多条更新（逐条生成，空行分隔）
+
+---
+
+## 核心规则速览
+
+| 规则 | 说明 |
+|------|------|
+| 输出格式 | `功能名称：功能更新内容` + 两行正文 |
+| 用途句 | 首句说清用户能做什么操作，以"你可以……"开头 |
+| 价值句 | 第二句讲优势/场景/收益，不复述标题 |
+| 了解详情 | 仅有真实配套指引时添加，4-8 字动词短语，无则省略 |
+| 篇幅 | 正文 40-70 字，恰好两句 |
+| 禁忌 | 感叹号、营销词（重磅/全新/极致）、第三句 |
+
+---
+
+## 更新维护
+
+- 更新日志文案风格若有调整（如字数范围、句式变化），直接修改 `SKILL.md` 中对应章节
+- 新增示例时放入「输出示例」一节，保持与原有示例格式一致

package/skills/version-update-description/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: jingwei-version-update-description
+description: 精卫平台版本更新描述撰写 Skill，通过功能名称快速生成飞书风格的功能价值描述文案。当用户提供功能标题（如"文档：支持 XX"、"项目管理：XX 功能"）、发布说明条目、或要求"写版本更新介绍/更新公告/新功能说明"时，必须触发本 Skill。即使用户只给了一个功能名或一句话描述，只要意图是生成产品功能更新文案，都应立即按本 Skill 的句式与格式输出，而不是自由发挥。
+---
+
+# 精卫平台 · 版本更新描述生成
+
+将用户提供的功能标题/更新条目，转换为**两句话**的产品功能更新介绍，输出格式固定为：
+
+```
+【功能名称：功能更新内容】
+```
+
+（输出时去掉方括号，即第一行重复标题，随后紧跟描述正文。）
+
+> 平台背景：精卫平台是 4399 企业内部的文档与项目管理工具，含**文档系统**（文字文档、电子表格、幻灯片、评论协作、权限管理）与**项目管理系统**（看板/列表/甘特视图、需求池、迭代管理）。文案需贴合这一平台定位，语气对标飞书更新日志风格。
+
+---
+
+## 输出结构（严格执行）
+
+每条更新描述由 2-3 行组成：
+
+**第 1 行 · 标题**：原样重复用户给出的功能标题（`系统：更新内容` 格式），不改变量词和措辞。
+
+**第 2 行 · 用途句**：首句直白说明功能核心用途，讲清**用户能做什么操作**。以"你可以……"或"……时，你可以……"开头，用"你"称呼用户。
+
+**第 3 行 · 价值句**：第二句阐述核心优势与使用场景，说明**解决什么问题、带来什么体验**。可从以下角度择一展开：
+- 体验提升（"提供更舒适的阅读和展示体验"）
+- 场景覆盖（"针对图片特定区域进行讨论"）
+- 效率收益（"无需逐页翻找，快速定位内容"）
+
+**可选第 4 行 · 详情指引**：仅当功能有配套使用指引时添加，格式为：
+```
+了解详情：对应功能简短指引名称
+```
+指引名称用动词短语（如"演示幻灯片"），4-8 字为宜；无配套指引则整行省略，不要编造。
+
+---
+
+## 文案风格规则
+
+1. **句式固定**：用途句 + 价值句两句成文，正文总字数控制在 40-70 字，不写第三句
+2. **用户视角**：以"你"为主语，站在使用者立场描述操作，不用"系统""平台"做主语
+3. **语言风格**：简洁通俗、正式得体，贴合办公软件文案；不用感叹号、不用营销词汇（如"重磅""全新""极致"）
+4. **不说废话**：不复述标题内容当作正文，每句话提供标题之外的新信息
+5. **标点规范**：句内用逗号/顿号，句末用句号；标题行不加句号
+
+---
+
+## 输入处理规则
+
+| 用户输入形态 | 处理方式 |
+|------------|---------|
+| 完整标题（如"文档：支持 XX"） | 直接按标题生成描述 |
+| 只有功能名（如"演示模式"） | 补全所属系统前缀后生成，输出前无需向用户确认 |
+| 一句话描述（无标准标题） | 先提炼为 `系统：更新内容` 的标准标题，再生成描述 |
+| 一次给多条更新 | 逐条生成，条目之间用空行分隔 |
+| 信息不足以判断功能用途 | 先按最合理的理解生成一版，并附一句说明假设了什么，供用户修正 |
+
+---
+
+## 输出示例（严格对标）
+
+**输入**：幻灯片：移动端支持演示模式
+
+**输出**：
+```
+幻灯片：移动端支持演示模式
+你可以在移动端使用演示模式演示幻灯片。演示时，页面会自动切换为横屏，提供更舒适的阅读和展示体验。
+了解详情：演示幻灯片
+```
+
+**输入**：文档：支持给评论中的图片添加框选标记
+
+**输出**：
+```
+文档：支持给评论中的图片添加框选标记
+在文档评论中插入图片时，你可以在图片上添加框选标记。回复包含图片的评论时，也可在原评论中的图片上添加框选标记，针对图片特定区域进行讨论。
+```
+
+**输入**：项目管理：看板卡片支持按负责人筛选
+
+**输出**：
+```
+项目管理：看板卡片支持按负责人筛选
+你可以在看板中按负责人筛选卡片，快速查看每位成员名下的任务。无需逐张浏览卡片，任务分工一目了然，方便跟进成员工作进展。
+了解详情：筛选看板卡片
+```
+
+---
+
+## 输出前自检清单
+
+- [ ] 第一行是否原样重复了标题？
+- [ ] 正文是否恰好两句（用途句 + 价值句）？
+- [ ] 首句是否说清了用户的具体操作？
+- [ ] 价值句是否提供了标题之外的信息（场景/收益），而非同义复述？
+- [ ] 正文是否在 40-70 字之间？
+- [ ] 「了解详情」是否有真实依据？无则已省略？
+- [ ] 是否无感叹号、无营销词、无第三句？