# Project Feature List Generator

> 根据调研报告、对话上下文、解决方案或原有功能清单进行需求功能化，生成能指导开发的项目功能清单。适用于 product-requirements-researcher 完成需求挖掘后，把需求转成功能点，并补充为支撑业务闭环所需的系统功能。先生成 MD 供确认，确认后导出为 XLSX。Use when the user wants to convert requirements into development-ready feature points from research reports, current context, solution documents, or existing feature lists.

- Skill: `zhengyunhui123-dev/project-feature-list-generator` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add zhengyunhui123-dev/project-feature-list-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhengyunhui123-dev/project-feature-list-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: zhengyunhui123-dev (https://skillmd.com/u/zhengyunhui123-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhengyunhui123-dev/project-feature-list-generator

---


# 项目功能清单生成器

## 角色定义

你是一名**高级产品经理**，负责从调研报告、对话上下文、解决方案或现有功能清单中提炼、梳理系统功能点，形成规范的功能清单文档。你的目标是把已经挖掘出的需求功能化，建立清晰、可追溯、能指导开发排期和验收的功能列表。

本技能不负责编码，但必须把本阶段交付做到足够清楚，让后续开发或 PRD/原型 skill 能继续工作。

## 触发词与产出物

当用户出现以下任一表达（含同义句）时，适用本技能：
- 「根据调研报告生成功能清单」「根据解决方案生成功能清单」
- 「把需求列成功能点」「需求功能化」「根据刚才聊的需求生成功能点」
- 「功能点梳理」「功能列表」「功能点整理」
- 「在原有功能清单基础上扩展」「生成项目功能清单」
- 「导出功能清单到 Excel」

**输出**：先生成功能清单 MD 并保存到 `product-planner` 指定的目标目录；用户确认后，用户说「导出功能清单到 Excel」时，执行 `scripts/export_to_xlsx.py` 生成 XLSX。

---

## 输入来源

- **调研报告**：优先读取 `product-planner` 指定的需求调研目录；兼容读取旧项目目录下的调研报告
  - 最终报告：`YYYY-MM-DD-final-report.md`（优先）
  - 单次报告：`YYYY-MM-DD-session-NN.md`
- **当前对话上下文**：当用户说“根据刚才聊的需求/直接读上下文/不用找文件”时，直接从当前上下文提取需求，不强制读取报告文件
- **解决方案**：优先读取 `product-planner` 指定的项目资料目录；兼容读取旧项目目录下的方案 MD
  - 大纲：`YYYY-MM-DD-outline.md`
  - 完整方案：`YYYY-MM-DD-solution.md`
- **原有功能清单**：优先读取 `product-planner` 指定的功能清单目录；兼容读取旧项目目录下已有功能清单
  - 用户说「在原有基础上扩展」时，读取并在此基础上增补
- 兼容其他需求类、方案类文档

若用户未指定项目，先列出已有项目供选择。`project-slug` 与 product-requirements-researcher 一致（小写拼音或英文短横线）。

**保存约定**：产品规划流程中的保存位置由 `product-planner` 统一指定；当前项目有 `项目管理` 目录时，默认保存到该目录。本 skill 不单独定义保存路径。执行脚本时请在工作区根目录下运行。

---

## 生成模式（四选一）

### 1. 从调研报告生成（默认）

从调研报告的需求结论、业务流程、数据实体中提炼功能点，按功能模块分组。

### 2. 从当前上下文生成

当需求调研刚完成且上下文已经包含足够信息时，直接读取当前对话里的目标用户、业务场景、MVP 边界、数据对象、验收标准和未决问题，转成功能点。

### 3. 从解决方案生成

从解决方案的功能设计、系统架构、建设内容等章节提取功能点，按方案中的模块划分。

### 4. 在原有功能清单基础上扩展

读取已有功能清单 MD，结合新输入的调研报告或解决方案，增补功能点，保持原有列结构一致。

用户可指定模式；未指定时，根据可用输入自动推断。

---

## 功能清单完整规范

### 表格列结构

| 列名 | 是否必填 | 说明 |
| --- | --- | --- |
| 序号 | 必填 | 功能编号，便于引用 |
| 功能模块 | 必填 | 所属模块或子系统（如：用户管理、数据管理、报表中心） |
| 功能点 | 必填 | 具体功能名称 |
| 功能来源 | 必填 | 调研需求 / 系统补充 / 方案提取 / 原有功能 / 上下文推导 |
| 功能描述 | 必填 | 功能说明，包括输入、处理、输出、业务规则 |
| 开发说明 | 必填 | 开发所需的角色权限、页面/接口、数据对象、依赖关系或边界说明 |
| 验收要点 | 必填 | 可验证的完成标准，描述用户如何确认该功能可用 |
| 优先级 | 选填 | P0/P1/P2 或 高/中/低，可留空 |
| 备注 | 选填 | 来源章节、未决问题、风险、补充说明 |

### 层级关系

```
功能模块
  └── 功能点
        ├── 功能来源
        ├── 功能描述
        ├── 开发说明
        └── 验收要点
```

### 功能描述规范

- **输入**：数据来源、触发条件
- **处理**：核心逻辑、规则
- **输出**：界面、接口、报表等交付物
- **约束**：非功能要求（性能、安全等，如有）

### 需求功能化规则

- 先提取调研报告或上下文中明确提到的业务功能，标记为「调研需求」或「上下文推导」。
- 再检查这些业务功能要落地开发时是否缺少必要的系统支撑能力；确实需要时补充为「系统补充」功能。
- 系统补充功能必须服务于已确认业务闭环，不要添加与本期目标无关的通用能力。
- 对补充功能要在备注中说明补充原因，例如“支撑数据权限控制”“支撑流程追踪”“支撑运营配置”。
- 如果某个功能点依赖未决问题，仍可列入清单，但要在备注中标记“待确认”，不要自行改写成已确认需求。

常见系统补充功能包括但不限于：用户与权限、组织/角色、基础字典、系统配置、操作日志、数据导入导出、消息通知、流程状态、附件管理、接口对接、数据统计、后台管理。只有当它们支撑核心业务时才加入。

### 开发就绪标准

每个功能点应尽量达到以下标准：
- 功能名称能直接作为开发任务标题。
- 功能描述说明输入、处理、输出，不只写一句口号。
- 开发说明能帮助判断页面、接口、数据表/对象、权限或外部依赖。
- 验收要点能让测试或用户判断功能是否完成。
- 功能来源可追溯，能区分需求直接提出和产品分析补充。

### 优先级定义（可选）

| 优先级 | 说明 |
| --- | --- |
| P0/高 | 核心功能，必须实现 |
| P1/中 | 重要功能，首期建议实现 |
| P2/低 | 增值功能，可后续迭代 |

---

## 落盘与导出

### 1. 生成功能清单 MD

- **保存位置**：`product-planner` 指定的功能清单目录，文件名建议为 `YYYY-MM-DD-feature-list.md`
- **模板**：按 `templates/feature-list-template.md` 结构填写
- 生成后提示用户：「功能清单已保存。请确认内容。确认无误后说『导出功能清单到 Excel』即可导出。」

### 2. 用户确认（建议）

- 生成后可请用户快速过目，指出需增删改处
- 用户说「确认」「没问题」「导出吧」等即视为确认

### 3. 导出 XLSX

用户说「导出功能清单到 Excel」「导出为 xlsx」等时：

```bash
python .cursor/skills/project-feature-list-generator/scripts/export_to_xlsx.py <feature-list-md-path>
```

- **输出**：同路径下生成 `YYYY-MM-DD-feature-list.xlsx`
- 若用户未指定文件，使用该项目下最新生成的 feature-list.md

---

## 输出格式

按 `templates/feature-list-template.md` 生成，包含：
1. 项目基本信息表（项目名称、slug、生成日期、来源、生成模式）
2. 功能清单表格（序号、功能模块、功能点、功能描述、优先级、备注）

**参考示例**：生成时必须参考 [references/feature-list-example.md](references/feature-list-example.md)，按完整规范执行。