Skill: yakov0922/requirement-assessment (version 1.0.0)

--- name: requirement-assessment description: 需求细化与工时评估技能。接收用户需求（文本或截图），主动询问澄清问题，分析需求合理性，输出合并的需求清单 + 工时评估表，并创建飞书 Bitable 多维表。适用于项目立项、需求评审、工时估算场景。 --- # 需求评估技能 ## 核心目标 理解清晰、准确、细化完善、风险可控、评估合理 --- ## 工作流程 ### 第一步：接收需求 用户可能提供： - **文本需求**：直接描述功能或业务场景 - **截图/图片**：界面草图、流程图、参考图 ### 第二步：主动询问（必须） 收到需求后，**必须主动询问以下关键问题**（根据需求情况选择相关问题）： #### 客户背景 1. 这是老客户还是新客户？ 2. 客户所属行业？是否有特殊合规要求？ #### 系统现状 3. 这是全新开发，还是在已有系统上补充/改造？ 4. 如果是改造，原有系统技术栈是什么？是否有代码/文档可参考？ #### 需求边界 5. 需求的预期上线时间？是否有硬性 deadline？ 6. 目标用户群体是谁？预计用户规模？ 7. 是否需要多端支持（Web/iOS/Android/鸿蒙/小程序）？ #### 技术约束 8. 是否有指定的技术栈或平台要求？ 9. 是否需要与现有第三方系统集成？有哪些系统？ #### 其他 10. 是否有参考产品或竞品？ 11. 预算范围是否有预期？ ### 第三步：需求分析 #### 3.1 需求合理性评估 - **技术可行性**：是否有成熟方案？技术风险点？ - **业务合理性**：是否解决真实痛点？使用频率？ - **成本效益**：投入产出比如何？是否有更优方案？ #### 3.2 需求细化 基于用户回答，将需求拆解为： - 子系统/模块划分 - 功能点列表 - 各功能点详细描述 ### 第四步：创建飞书 Bitable 多维表（直接输出） **不再输出 markdown 表格，直接创建飞书多维表**。 **创建前询问用户**（如未提供）： - 在哪个飞书空间/文件夹创建？（或使用默认空间） - 表格名称（默认：`需求评估-YYYYMMDD-项目名称`） **创建步骤**： 1. 使用 `feishu_bitable_create_app` 创建新的 Bitable 应用 2. 使用 `feishu_bitable_create_field` 创建以下字段 3. 使用 `feishu_bitable_create_record` 逐行创建记录 4. 返回 Bitable 链接给用户 **字段设计**（17 个字段）： | 字段名 | 字段类型 | 说明 | |--------|----------|------| | 序号 | 自动编号 | 1001 类型 (AutoNumber) | | 需求目标/场景 | 文本 | 1 类型 (Text) | | 原始需求描述 | 文本 | 1 类型 (Text) | | 子模块/子系统 | 单选 | 3 类型 (SingleSelect)，预设常见模块选项 | | 功能点 | 文本 | 1 类型 (Text) | | 需求描述 | 多行文本 | 1 类型 (Text) | | 产品 | 数字 | 2 类型 (Number)，单位：人·天 | | UI | 数字 | 2 类型 (Number)，单位：人·天 | | 前端 | 数字 | 2 类型 (Number)，单位：人·天 | | 后端 | 数字 | 2 类型 (Number)，单位：人·天 | | 测试 | 数字 | 2 类型 (Number)，单位：人·天 | | 运维 | 数字 | 2 类型 (Number)，单位：人·天 | | iOS | 数字 | 2 类型 (Number)，单位：人·天 | | Android | 数字 | 2 类型 (Number)，单位：人·天 | | 鸿蒙 | 数字 | 2 类型 (Number)，单位：人·天 | | 小计 (标准) | 数字 | 2 类型 (Number)，公式或手动计算 | | 小计 (AI 辅助) | 数字 | 2 类型 (Number)，公式或手动计算 | **工时说明**： - **标准工时**：常规开发模式下的预估工时 - **AI 辅助工时**：在 AI 辅助（代码生成、文档生成等）情况下的预估工时 - 工时单位：人·天（允许小数） - 如果某岗位不涉及，填 `0` ### 第五步：风险提示 列出主要风险点： - 技术风险 - 需求变更风险 - 工期风险 - 其他风险 --- ## 输出示例 ### Bitable 记录示例 创建后的 Bitable 记录： ``` 记录 1: - 序号：1 - 需求目标/场景：用户登录 - 原始需求描述："用户可以登录系统" - 子模块/子系统：用户系统 - 功能点：手机号登录 - 需求描述：用户输入手机号和验证码，验证通过后登录系统，支持 60 秒重发 - 产品：0.5 | UI：0.5 | 前端：1 | 后端：1 | 测试：0.5 | 运维：0.2 - iOS：0 | Android：0 | 鸿蒙：0 - 小计 (标准)：3.7 | 小计 (AI 辅助)：2.5 记录 2: - 序号：2 - 需求目标/场景：用户登录 - 原始需求描述："用户可以登录系统" - 子模块/子系统：用户系统 - 功能点：微信登录 - 需求描述：用户点击微信登录，跳转微信授权，获取用户信息并绑定账号 - 产品：0.5 | UI：0.3 | 前端：1.5 | 后端：2 | 测试：0.8 | 运维：0.2 - iOS：0 | Android：0 | 鸿蒙：0 - 小计 (标准)：5.3 | 小计 (AI 辅助)：3.5 ``` --- ## 注意事项 1. **必须主动询问**：不要直接给出评估，先问清楚背景 2. **工时合理**：基于 `references/评估标准.md` 的基准，结合需求复杂度调整 3. **风险透明**：不确定的地方要明确标注，不要过度承诺 4. **AI 辅助说明**：AI 辅助工时可作为参考，实际需考虑审核修改时间 5. **平台差异**：如果用户未指定平台，按 Web 评估，移动端单独列出 6. **Bitable 输出**：不再输出 markdown 表格，直接创建飞书多维表 7. **工时汇总**：可在 Bitable 中添加视图或使用公式字段自动计算各岗位合计 --- ## 相关资源 - 评估标准和工时基准：`references/评估标准.md` - 常见功能模块参考：`references/常见功能模块.md`

path: references/常见功能模块.md
content: # 常见功能模块参考

## 一、通用子系统

### 1. 用户系统
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 注册登录 | 手机号/邮箱注册、密码登录、验证码 | 中 |
| 第三方登录 | 微信、支付宝、Google、Apple 登录 | 中 |
| 个人中心 | 基本信息、头像、密码修改 | 低 |
| 权限管理 | 角色、权限、菜单控制 | 高 |
| 登录日志 | 登录记录、设备管理 | 低 |

### 2. 内容管理 (CMS)
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 文章管理 | 发布、编辑、删除、分类、标签 | 中 |
| 富文本编辑 | 图文混排、格式调整 | 中 |
| 内容审核 | 敏感词、人工审核流程 | 中 |
| 版本管理 | 历史版本、回滚 | 中 |
| 定时发布 | 定时任务、发布队列 | 低 |

### 3. 搜索系统
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 基础搜索 | 关键词匹配、模糊查询 | 低 |
| 高级搜索 | 多条件筛选、排序 | 中 |
| 全文检索 | Elasticsearch 集成 | 高 |
| 搜索建议 | 自动补全、热门搜索 | 中 |
| 搜索结果优化 | 权重调整、个性化推荐 | 高 |

### 4. 消息通知
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 站内信 | 消息列表、已读未读 | 低 |
| 推送通知 | APP 推送、浏览器推送 | 中 |
| 短信通知 | 验证码、通知短信 | 低 |
| 邮件通知 | 模板邮件、批量发送 | 低 |
| 消息模板 | 可配置模板、变量替换 | 中 |

### 5. 文件管理
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 文件上传 | 单文件、多文件、拖拽上传 | 低 |
| 文件存储 | 本地存储、OSS、CDN | 中 |
| 文件预览 | 图片、PDF、Office | 中 |
| 文件分享 | 链接分享、权限控制 | 低 |
| 文件版本 | 历史版本、版本对比 | 中 |

### 6. 数据统计
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 数据看板 | 核心指标展示、图表 | 中 |
| 报表生成 | 自定义报表、导出 | 中 |
| 数据导出 | Excel、CSV、PDF | 低 |
| 数据可视化 | 大屏、动态图表 | 高 |
| 用户行为分析 | 埋点、漏斗、留存 | 高 |

---

## 二、电商相关

### 1. 商品管理
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 商品列表 | 展示、筛选、排序 | 低 |
| 商品详情 | 规格、图片、详情描述 | 中 |
| 商品上下架 | 状态管理、定时上下架 | 低 |
| 库存管理 | 库存扣减、预警 | 中 |
| 价格管理 | 原价、活动价、会员价 | 中 |

### 2. 订单系统
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 下单流程 | 购物车、结算、提交 | 高 |
| 订单列表 | 多状态筛选、搜索 | 中 |
| 订单详情 | 商品、物流、支付信息 | 中 |
| 订单状态 | 待支付、待发货、已完成等 | 中 |
| 售后流程 | 退款、退货、换货 | 高 |

### 3. 支付系统
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 支付接入 | 微信、支付宝、银联 | 高 |
| 支付回调 | 异步通知、对账 | 高 |
| 退款处理 | 原路退回、部分退款 | 高 |
| 优惠券 | 发放、使用、核销 | 中 |
| 积分系统 | 获取、消费、兑换 | 中 |

### 4. 物流系统
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 运费模板 | 区域、重量、体积计费 | 中 |
| 物流跟踪 | 物流状态查询、展示 | 中 |
| 电子面单 | 打印、发货 | 中 |
| 多仓库 | 库存分配、就近发货 | 高 |

---

## 三、企业管理

### 1. OA 办公
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 考勤管理 | 打卡、请假、加班 | 中 |
| 审批流程 | 自定义流程、多级审批 | 高 |
| 公告通知 | 发布、已读未读 | 低 |
| 日程管理 | 日历、提醒、共享 | 中 |
| 会议管理 | 预定、通知、纪要 | 中 |

### 2. CRM 客户管理
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 客户档案 | 基本信息、联系人 | 低 |
| 跟进记录 | 沟通记录、下次跟进 | 中 |
| 销售漏斗 | 线索、商机、成交 | 中 |
| 客户分配 | 公海池、分配规则 | 中 |
| 业绩统计 | 销售报表、排行 | 中 |

### 3. 项目管理
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 项目列表 | 状态、进度、成员 | 中 |
| 任务管理 | 创建、分配、完成 | 中 |
| 甘特图 | 时间轴、依赖关系 | 高 |
| 工时统计 | 工时填报、汇总 | 中 |
| 文档协作 | 项目文档、版本 | 中 |

---

## 四、社交相关

### 1. 社交互动
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 关注系统 | 关注、粉丝、互相关注 | 低 |
| 点赞收藏 | 点赞、收藏、取消 | 低 |
| 评论系统 | 评论、回复、楼中楼 | 中 |
| 分享功能 | 生成海报、链接分享 | 中 |
| 消息聊天 | 单聊、群聊、已读 | 高 |

### 2. 内容社区
| 功能点 | 需求描述 | 复杂度 |
|--------|----------|--------|
| 内容发布 | 图文、视频、话题 | 中 |
| 内容推荐 | 推荐算法、信息流 | 高 |
| 用户主页 | 动态、作品、资料 | 中 |
| 话题/圈子 | 创建、加入、管理 | 中 |
| 内容举报 | 举报、处理、反馈 | 低 |

---

## 五、工时评估参考公式

### 基础公式
```
总工时 = ∑(各功能点工时 × 复杂度系数) + 集成工时 + 测试工时 + 缓冲工时
```

### 复杂度系数
- 简单：1.0
- 中等：1.5
- 复杂：2.0

### 集成工时
- 内部模块集成：总开发工时的 10%
- 第三方系统对接：每个接口 0.5-2 人天

### 缓冲工时
- 需求明确：总工时的 10%
- 需求模糊：总工时的 20-30%


path: references/评估标准.md
content: # 需求评估标准

## 一、需求澄清维度

### 1. 客户背景
- **新客户 vs 老客户**：老客户需确认是否有历史系统、技术栈、业务约束
- **行业属性**：ToB/ToC、行业规范、合规要求
- **项目规模**：小型 (<1 人月)、中型 (1-3 人月)、大型 (>3 人月)

### 2. 系统现状
- **全新开发**：从零开始，无历史包袱
- **部分实现**：需确认已有功能模块、技术栈、代码质量
- **改造升级**：需评估兼容性、迁移成本、风险评估

### 3. 需求类型
- **功能需求**：具体业务功能
- **非功能需求**：性能、安全、可用性、可扩展性
- **集成需求**：第三方系统对接、API 调用

---

## 二、需求合理性评估维度

### 1. 技术可行性
| 评估项 | 说明 |
|--------|------|
| 技术成熟度 | 是否有成熟方案/开源库 |
| 技术栈匹配 | 与现有技术栈是否一致 |
| 第三方依赖 | 是否有不可控的外部依赖 |

### 2. 业务合理性
| 评估项 | 说明 |
|--------|------|
| 用户价值 | 是否解决真实痛点 |
| 使用频率 | 高频/低频功能 |
| 业务闭环 | 是否形成完整业务流程 |

### 3. 成本效益
| 评估项 | 说明 |
|--------|------|
| 投入产出比 | 开发成本 vs 预期收益 |
| 替代方案 | 是否有更低成本的实现方式 |
| 优先级 | 核心功能 vs 锦上添花 |

---

## 三、工时评估基准（人·天）

### 产品岗位
| 功能复杂度 | 工时范围 | 说明 |
|------------|----------|------|
| 简单需求 | 0.5-1 | 单页面、逻辑简单 |
| 中等需求 | 1-3 | 多页面、有一定业务逻辑 |
| 复杂需求 | 3-5 | 跨模块、复杂业务流程 |

### UI 设计
| 设计类型 | 工时范围 | 说明 |
|----------|----------|------|
| 简单页面 | 0.5-1 | 标准组件、无特殊设计 |
| 中等页面 | 1-2 | 定制组件、有一定设计感 |
| 复杂页面 | 2-4 | 动效、特殊交互、多状态 |
| 设计规范 | 2-5 | 完整设计系统/组件库 |

### 前端开发
| 功能类型 | 工时范围 | 说明 |
|----------|----------|------|
| 静态页面 | 0.5-1 | 纯展示、无交互 |
| 表单交互 | 1-2 | 表单、验证、提交 |
| 数据展示 | 1-3 | 列表、表格、图表 |
| 复杂交互 | 3-5 | 拖拽、动画、实时通信 |
| 页面集成 | 0.5-1 | 路由、状态管理 |

### 后端开发
| 功能类型 | 工时范围 | 说明 |
|----------|----------|------|
| 简单 API | 0.5-1 | CRUD、单表操作 |
| 中等 API | 1-2 | 多表关联、业务逻辑 |
| 复杂 API | 2-4 | 事务、并发、复杂计算 |
| 第三方集成 | 1-3 | 对接外部 API/服务 |
| 数据处理 | 1-3 | 批量处理、数据迁移 |

### 测试
| 测试类型 | 工时比例 | 说明 |
|----------|----------|------|
| 功能测试 | 开发工时的 20-30% | 用例编写 + 执行 |
| 回归测试 | 开发工时的 10-15% | 已有功能验证 |
| 性能测试 | 1-3 人天 | 压测、优化建议 |
| 安全测试 | 1-2 人天 | 漏洞扫描、渗透测试 |

### 运维
| 工作类型 | 工时范围 | 说明 |
|----------|----------|------|
| 环境搭建 | 0.5-2 | 开发/测试/生产环境 |
| 部署配置 | 0.5-1 | CI/CD、发布流程 |
| 监控配置 | 0.5-1 | 日志、告警、监控面板 |

### 移动端（iOS/Android/鸿蒙）
| 功能类型 | 工时范围 | 说明 |
|----------|----------|------|
| 简单页面 | 1-2 | 展示、基础交互 |
| 中等功能 | 2-4 | API 调用、本地存储 |
| 复杂功能 | 4-8 | 原生能力、性能优化 |
| 多端适配 | +30% | 不同屏幕、系统版本 |

---

## 四、AI 辅助工时折算

在 AI 辅助下，以下岗位工时可进行折算：

| 岗位 | AI 辅助场景 | 折算系数 |
|------|------------|----------|
| 产品 | 文档生成、竞品分析 | 0.6-0.7 |
| UI | 初稿生成、素材处理 | 0.7-0.8 |
| 前端 | 代码生成、组件搭建 | 0.5-0.7 |
| 后端 | 代码生成、API  scaffold | 0.5-0.7 |
| 测试 | 用例生成、自动化脚本 | 0.6-0.8 |
| 运维 | 脚本生成、配置模板 | 0.7-0.8 |
| 移动端 | 代码生成、UI 搭建 | 0.6-0.8 |

**注意**：折算后的工时需考虑 AI 输出审核、修改、调试的时间。

---

## 五、风险评估清单

- [ ] 需求是否清晰、无歧义
- [ ] 技术可行性是否已验证
- [ ] 是否有第三方依赖风险
- [ ] 是否有性能瓶颈风险
- [ ] 是否有安全合规风险
- [ ] 是否有人员技能匹配风险
- [ ] 是否有工期紧张风险
- [ ] 是否有需求变更风险


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)