@chantezy/mcp-product-design 0.1.12 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chantezy/mcp-product-design",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Product design skills MCP server - structured design workflow tools for AI agents",
   "type": "module",
   "main": "./dist/index.js",

package/skills/interaction-design-eval/README.md

@@ -4,10 +4,18 @@
 
 ## 适用场景
 
-- 上传设计方案文档、原型说明、PRD 交互部分，进行专业评审打分
+- 上传设计方案文档、交互方案说明、原型流程说明，进行专业评审打分
 - 设计师职级评估、成长值评估、能力匹配度盘点
 - 团队内设计方案横向对比
 
+## 不适用场景（改用 prd-lint）
+
+- 检查 PRD / 需求文档的逻辑是否自洽、流程是否有断点
+- 排查文档内的规则冲突，或与线上需求库的跨文档冲突
+- 只要「问题清单 + 严重度分级」、明确不要分数
+
+判别锚点是**输出形态**：要分数、评分表、成长值 → 本 skill；只要问题清单和严重度 → prd-lint。两个 skill 都会输出问题清单，这是最容易混淆的地方，靠「是否产出分数」区分。
+
 ## 评估体系
 
 ### 10 大评估维度

package/skills/interaction-design-eval/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: interaction-design-eval
-description: 对交互设计/产品方案文档进行专业、量化的评审打分,同时评估方案及设计师本人的职级岗位匹配度。当用户上传设计方案文档、原型说明、PRD交互部分,并要求"评估"、"打分"、"测评"、"评审"该方案时,必须使用本skill。即使用户只说"帮我看看这个方案怎么样"或"这个设计有没有问题",只要附带的是交互/产品设计类文档,也应触发本skill,而不是给出泛泛的主观评价。也适用于"职级评估""成长值评估""能力匹配度"相关的设计师能力盘点场景。输出固定为10维度评分表+职级评估分(成长值)+逐维度问题清单+原文引用+优化建议。
-trigger: 当用户需要评估/打分/评审交互设计方案、测评设计质量、或做设计师职级能力盘点时使用
+description: 对交互设计方案文档做量化的质量评分，并同步评估设计师本人的职级与成长值匹配度。当用户要求给设计方案打分、量化测评设计质量、问「这个方案能打几分」，或对某位设计师做职级评估、成长值评估、能力盘点时使用。典型输入是交互方案说明、设计稿标注、原型流程说明等交互/产品设计类文档；输出固定为 10 维度评分表（5 分制 × 权重）＋职级成长值比例＋逐维度问题清单＋原文引用＋优化建议。
+trigger: 当用户需要给交互设计方案打分、量化测评设计质量，或做设计师职级与成长值评估时使用
 ---
 
 # 交互设计方案专业评估
@@ -10,6 +10,8 @@ trigger: 当用户需要评估/打分/评审交互设计方案、测评设计质
 
 你是一位资深交互设计专家，需要对用户提供的设计方案文档进行专业评估。请从「上下文内容表达」出发进行打分，并给出具体、可执行的改进建议。评估须客观、精准、有依据，所有结论必须基于文档原文。
 
+> **边界**：本 skill 的产出是「分数」。若用户要的是 PRD 逻辑体检、规则冲突排查、跨文档比对，或只要问题清单不要分数，应改用 `prd-lint`——不要拿本 skill 的评分标准去评 PRD 的逻辑完备性。
+
 ## 二、输入素材
 
 用户提供的设计方案文档

package/skills/prd-generator/README.md

@@ -1,6 +1,6 @@
 # PRD 需求文档生成 Skill
 
-产品需求文档（PRD）生成技能。`
+产品需求文档（PRD）生成技能。
 
 ## 功能
 
@@ -39,16 +39,15 @@ Create a PRD for dark mode feature
 ## 目录结构
 
 ```
-skills-prd-generator/
+prd-generator/
 ├── SKILL.md                    # 技能主文件
 ├── references/
-│   └── prd-template.md       # PRD 模板
-└── README.md                  # 本文件
+│   └── prd-template.md         # PRD 模板
+└── README.md                   # 本文件
 ```
 
 ## 工作流程
 
 1. **收集背景信息** - 通过发现式对话获取需求
-2. **生成结构** - 按照标准PRD结构组织内容
-3. **输出文档** - 生成 Markdown 格式的完整 PRD
-
+2. **生成结构** - 按照标准 PRD 结构组织内容
+3. **输出文档** - 生成 HTML 格式的富文本 PRD

package/skills/prd-generator/SKILL.md

@@ -42,15 +42,16 @@ trigger: 当用户需要创建/编写产品需求文档（PRD）、或涉及产
 PRD 包括以下部分，如果不需要的内容可以省略，如果有好的表述方式也可以自己规划，但要注意不要重复内容进行描述，要尽量简洁通俗易懂：
 
 1. **一、需求背景** - 需要解决的问题及背景，问题的清晰表述，我们为谁处理，要做到什么程度
-2. **二、功能范围** - 功能影响范围及衍生情况的考虑，范围内和范围外的内容
-3. **三、业务流程** - 用户、功能流程简述
-4. **四、需求详情** - 详细的功能需求
-5. **五、操作流程** - 用户操作路径
-6. **六、相关需求链接** - （用户自己填写）
+2. **二、功能范围** - 功能支持点与涉及角色，以及衍生情况的考虑
+3. **三、业务流程** - 用户、功能流程简述（非必须，流程复杂时再补充）
+4. **四、需求详情** - 详细的功能需求：位置、权限、功能描述、异常处理、交互描述
+5. **五、操作流程** - 操作路径说明，或原型／流程图链接（由产品自行补充）
+6. **六、其他** - 其他需要说明的事项，如依赖、限制、上线注意事项
+7. **七、相关需求链接** - （用户自己填写）
 
 ### 步骤 3：输出 PRD
 
-将收集的信息按照结构模板生成 Markdown 格式的 PRD 文档。
+先按结构模板把内容组织成 Markdown，再按下方「输出格式」的要求交付 HTML 文档。
 
 ## PRD 模板
 
@@ -73,16 +74,9 @@ PRD 包括以下部分，如果不需要的内容可以省略，如果有好的
 - 未经验证的假设
 
 ### 范围管理
-
-**范围内部分：**
-- 列出包含的特定功能/能力
-- 明确且详细
-
-**范围外部分：**
-- 明确说明不包括什么
-- 防止范围蔓延
-- 管理利益相关者的期望
-- 可以包含"未来考虑"
+- 明确列出包含的功能点与涉及角色，不用"等等"这类模糊收尾
+- 描述要具体，但只写"做什么"，不写"怎么做"（实施方案留给开发）
+- 本期不做的内容用"未来考虑"标注，避免对方误判为已包含
 
 ## 使用模式
 
@@ -113,10 +107,10 @@ PRD 包括以下部分，如果不需要的内容可以省略，如果有好的
 - [ ] **问题清晰**：任何人都能理解我们要解决什么
 - [ ] **用户已确定**：我们知道这是给谁的
 - [ ] **成功可衡量**：我们能判断它是否有效
-- [ ] **范围有界限**：明确范围内外
+- [ ] **范围清晰**：功能支持点与涉及角色明确
 
 ## 输出格式
 
 将上面内容考虑清楚，最后要输出为 **html** 格式的富文本文档。
-富文本 HTML 做极简处理——只有正文、表格和三张流程图，不要花哨卡片。
+富文本 HTML 做极简处理——只保留正文、表格和必要的流程图，不要花哨卡片。
 

package/skills/prd-generator/references/prd-template.md

@@ -1,59 +1,50 @@
-# PRD 模板
+# [功能名称] PRD 需求文档
 
-## [功能名称]-PRD需求文档
-
-## **一、需求背景**
+## 一、需求背景
 
 **目标：** [我们要实现什么]
 
 **现状：** [当前存在的问题或不足]
 
 **痛点：**
+
 - [痛点1]
 - [痛点2]
-- [痛点3]
 
-## **二、功能范围**
+## 二、功能范围
 
 ### 2.1 功能支持
 
 1. **[功能点1]**：[描述]
 2. **[功能点2]**：[描述]
-3. **[功能点3]**：[描述]
 
 ### 2.2 涉及角色
 
-| 角色 | 权限1 | 权限2 | 权限3 |
-|---|---|---|---|
-| 管理员 | ✅ | ✅ | ✅ |
-| 成员 | - | ✅ | ✅ |
-
-### 2.3 范围内/外
-
-**范围内：**
-- [明确包含的功能]
+| 角色 | 权限1 | 权限2 |
+|---|---|---|
+| 管理员 | ✅ | ✅ |
+| 成员 | - | ✅ |
 
-**范围外：**
-- [明确不包含的功能]
-- [未来考虑的功能]
+## 三、业务流程
 
-## **三、业务流程**
+> 非必须。涉及多角色或跨系统流程时再补充说明。
 
 [用流程图或文字描述业务流程]
 
-### 关键业务流程：
 1. [步骤1]
 2. [步骤2]
-3. [步骤3]
 
-## **四、需求详情**
+## 四、需求详情
 
 ### 4.1 [功能模块1]
 
 **位置：** [界面位置]
 **权限：** [需要的权限]
+**功能描述：** [这个模块做什么]
+**异常处理：** [异常场景及处理方式]
 
 **交互描述：**
+
 - [交互细节1]
 - [交互细节2]
 
@@ -61,39 +52,24 @@
 
 **位置：** [界面位置]
 **权限：** [需要的权限]
+**功能描述：** [这个模块做什么]
+**异常处理：** [异常场景及处理方式]
 
 **交互描述：**
+
 - [交互细节1]
 - [交互细节2]
 
-### 4.3 状态定义
+## 五、操作流程
 
-| 状态 | 说明 | 可操作 |
-|---|---|---|
-| 状态1 | 描述 | 操作1 |
-| 状态2 | 描述 | 操作2 |
-
-## **五、操作流程**
-
-### 用户操作路径
+[操作路径说明，或对应的原型／流程图链接]
 
-```
-用户进入 → [操作1] → [操作2] → [操作3] → 完成
-```
+## 六、其他
 
-### 异常处理
+[其他需要说明的事项，如依赖、限制、上线注意事项]
 
-- **异常1：** [处理方式]
-- **异常2：** [处理方式]
-
-## **六、相关需求链接**
+## 七、相关需求链接
 
 - 相关需求：[链接]
 - 设计稿：[链接]
 - 接口文档：[链接]
-
----
-
-**文档版本：** v1.0
-**创建日期：** [日期]
-**产品负责人：** [姓名]

package/skills/prd-lint/README.md

@@ -22,6 +22,13 @@
 - "开发评审前帮我自查一下"
 - 任何 PRD 合理性校验、一致性核对的请求
 
+## 不适用场景（改用 interaction-design-eval）
+
+- 给交互设计方案打分、量化测评方案质量
+- 设计师职级评估、成长值评估、能力匹配度盘点
+
+本 skill 的输出里不会出现任何分数或评分表。如果用户要的是「这个方案能打几分」「评级多少」，请改用 interaction-design-eval。
+
 ## 使用方法
 
 给出 PRD 的 4399doc 链接，或直接粘贴正文：

package/skills/prd-lint/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prd-lint
-description: 评审 PRD / 需求文档的逻辑合理性与内部一致性，并对比线上已有需求库检测跨文档规则冲突。当用户要求检查 PRD 是否合理、验证逻辑是否完整、找出需求或规则冲突、核对功能方案与需求背景是否对应、核对新需求与线上功能是否冲突、或做开发评审前的自查时使用。支持通过 4399doc 链接（note MCP）获取文档并检索需求库，输出分维度问题清单与严重度分级。
+description: 评审 PRD / 需求文档的逻辑合理性与内部一致性，并对比线上已有需求库检测跨文档规则冲突。当用户要求检查 PRD 是否合理、验证逻辑是否完整、找出需求或规则冲突、核对功能方案与需求背景是否对应、核对新需求与线上功能是否冲突，或做开发评审前的自查时使用。支持通过 4399doc 链接（note MCP）获取文档并检索需求库。输出为分维度问题清单与严重度分级（阻塞/高风险/建议），只定位问题，不打分、不评级。本 skill 只产出「问题＋严重度」，不产出任何分数。
 trigger: 当用户需要检查 PRD 逻辑是否合理、验证逻辑是否完整、排查需求或规则冲突、核对功能方案与需求背景是否对应、对比线上需求库检测跨文档冲突，或做开发评审前的自查时使用
 agent_created: true
 ---
@@ -25,7 +25,7 @@ agent_created: true
 - 用户要求核对新需求与线上已有功能规则是否冲突
 - 开发评审、产品内部 review 前的预检自查
 
-不适用：撰写 PRD、改写 PRD、纯格式或错别字校对。
+不适用：撰写 PRD、改写 PRD、纯格式或错别字校对；给交互设计方案打分、量化测评方案质量、设计师职级或成长值评估也不适用，应改用 `interaction-design-eval`。本 skill 不产出任何分数。
 
 ## 工作流