mcp-feature-doc-generator 1.0.4 → 1.0.6

package/dist/index.js

@@ -5,7 +5,7 @@ import { z } from "zod";
 import { collectFeatureDocContext } from "./analysis/feature-context.js";
 import { PROMPT_DESCRIPTION, PROMPT_NAME, buildPromptMessages, } from "./prompts/generate-feature-doc.js";
 import { getTemplateContent } from "./resources/template.js";
-const SERVER_VERSION = "1.0.4";
+const SERVER_VERSION = "1.0.6";
 const FEATURE_PATH_DESCRIPTION = "功能路径，如 project/pmbasupplierevaluation 或 pm/ba/PmBaRentcontractSettle";
 const server = new McpServer({
     name: "feature-doc-generator",

package/dist/prompts/generate-feature-doc.js

@@ -238,6 +238,92 @@ export function buildPromptMessages(featurePath) {
 
 ---
 
+## 流程节点字段控制输出规则
+若功能中存在**体现当前业务语义的特殊流程节点字段控制**，可在“核心业务逻辑”章节中增加相关小节进行说明。
+
+### 输出形式
+统一使用以下格式：
+
+### 4.x 流程节点字段控制
+
+先用一段简要文字说明：根据功能类型、流程状态、节点标识或页面模式，对不同业务区域、字段分组或操作区域的显示、禁用、可编辑性进行动态控制。
+
+随后使用条件对照表展示，优先体现：
+
+- 不同流程节点下各业务区域的可编辑性
+- 不同状态下字段区域的显示 / 隐藏
+- 不同功能模式下的禁用控制
+- 查看态、编辑态、审批态之间的差异
+
+### 示例
+
+### 4.6 流程节点字段控制
+
+根据功能类型和工作流状态动态控制各区域的显示与禁用：
+
+| 条件 | 员工信息区域可编辑 | 合同信息区域可编辑 |
+| ---- | ------------------ | ------------------ |
+| 提交类功能 | ✓ | ✓ |
+| 流程类功能 + 编辑中状态 | ✓ | ✗ |
+| 流程类功能 + userTask2 节点 | ✗ | ✓ |
+| 流程类功能 + 非 userTask2 节点 | ✗ | ✗ |
+| 查看模式 | ✗ | ✗ |
+
+### 适用条件
+仅当代码中存在**当前功能特有的流程节点字段控制逻辑**时，才允许输出该小节，例如：
+
+- 不同节点控制不同业务区域的可编辑性
+- 某些字段或区域仅在指定流程节点开放
+- 不同审批阶段对应不同字段处理权限
+- 节点变化会直接影响当前功能的数据录入范围或业务处理方式
+
+### 过滤要求
+以下情况不单独输出“流程节点字段控制”小节：
+
+- 仅存在项目通用流程组件控制
+- 仅存在通用查看态 / 编辑态切换
+- 仅存在统一的整页禁用控制，而无当前功能特有业务语义
+- 仅体现项目公共工作流机制，未体现当前功能独有节点规则
+
+---
+
+## 引用组件说明输出模板
+“引用组件说明”章节中的组件介绍，统一使用以下格式：
+
+### 6.x 组件名 — 中文功能名
+
+组件简要说明，说明其在当前功能中的用途。关键配置：
+
+- **筛选条件**：说明组件的关键过滤条件、限制条件或数据范围
+- **回调处理**：说明选择、确认、变更后触发的回填、联动、刷新、计算等处理逻辑
+- **触发方式**：说明组件在页面中的触发入口，如搜索按钮、选择按钮、弹窗入口、字段点击等
+
+### 输出要求
+- 组件标题格式固定为：${bt}### 6.x 组件名 — 中文功能名${bt}
+- 先写一句组件用途说明，再写“关键配置”要点列表
+- 优先说明与当前业务直接相关的内容，如：
+  - 筛选条件
+  - 默认参数
+  - 回调处理
+  - 数据回填
+  - 联动逻辑
+  - 触发方式
+- 若某项不存在，不强行补齐
+- 不罗列纯 UI 属性、样式属性、通用框架属性
+- 不说明无业务语义的基础组件
+
+### 示例
+
+### 6.1 select-project — 项目选择器
+
+项目选择器组件，用于在表单中选择项目。关键配置：
+
+- **筛选条件**：${bt}state: '2'${bt}（仅显示在建项目）
+- **回调处理**：选择项目后通过 ${bt}projectMasterSelectProjectOkHandle${bt} 方法自动回填项目相关信息
+- **触发方式**：点击项目名称输入框右侧的搜索按钮
+
+---
+
 ## 输出规则
 - 输出到 ${bt}开发规范/views/${bt} 目录下
 - 保持与源码相同的模块子目录结构

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-feature-doc-generator",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "MCP server for generating Vue 3 feature documentation via prompt template",
   "type": "module",
   "main": "dist/index.js",