agentleFS
wonderslifewonderslife/pdd-skills-v3/skills/core/pdd-ba/SKILL.md

pdd-ba

Skill15 starsChanged 28 days agoMITView on GitHub

PDD框架下的业务分析Skill,用5W1H、MECE、CRUD等方法论进行需求分析和业务建模。触发:业务分析、需求分析、需求建模、5W1H分析、MECE、流程分析、/analyze、/audit、/doc。

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

PDD-Business Analysis / 业务分析技能

运用专业方法论进行需求分析和业务建模,输出结构化业务分析结果,为后续功能点提取和开发规格生成提供基础。

输入: PRD文档/业务需求描述/流程说明 | 输出: 业务分析报告/用例图/流程图/状态图/CRUD矩阵 | 不负责: 代码实现/测试编写/架构设计

方法论工具箱

  • 5W1H:Why(为什么/背景目标价值)、What(做什么/范围)、Who(谁/角色职责)、When(何时/时间里程碑)、Where(在哪/场景环境)、How(怎么做/实现方式流程)
  • MECE:相互独立、完全穷尽。检验:子类别是否独立、是否覆盖完整、有无遗漏场景、有无重叠功能
  • CRUD矩阵:实体 × Create/Read/Update/Delete + 列表/导出

分析流程

  1. 需求收集:PRD原文/业务流程/业务规则/现有系统截图/竞品资料 → 原始需求清单
  2. 5W1H 分析:对每个需求六维分析(背景值/范围/角色/时间周期/场景/实现约束)
  3. 业务建模:
    • a. 用例图:参与者+用例+关系(模板:UC-编号/参与者/前置条件/基本流程/扩展流程/异常流程)
    • b. 流程图:开始→判断→分支→循环→结束
    • c. 状态图:实体状态机(状态/代码/含义/可转入)
  4. CRUD 矩阵生成:实体×C/R/U/D/列表/导出
  5. 业务规则提取:规则ID/描述/约束类型(硬/软)/优先级(P0/P1/P2)

输出规范

报告结构:概述(模块信息/背景/目标) | 5W1H分析 | 用例分析 | 流程分析 | 状态分析 | CRUD矩阵 | 业务规则 | 枚举编码约定(显示名中文+编码值snake_case小写) | 权限矩阵(角色×状态×操作) | 风险与假设 | 附录(术语表/参考)

Guardrails

  • 必须:每个需求有完整5W1H | 每个实体有状态定义 | CRUD覆盖所有操作 | 规则标注优先级
  • 避免:❌遗漏关键流程 ❌状态不完整不互斥 ❌规则与实际不符 ❌用例与流程不一致

与其他技能协作

pdd-main(流程调度→分析报告) | pdd-extract-features(顺序→功能点矩阵) | pdd-generate-spec(顺序→开发规格)

Iron Law 铁律

  1. 方法论驱动:必须用5W1H、MECE、CRUD,不得凭直觉输出。
  2. 不越界做技术决策:只产出业务层描述,不涉及技术实现/数据库/接口。
  3. 完整性优先:每需求完成全部六维5W1H,不得因"简单"跳过。
  4. 可追溯性:每个结论须追溯到PRD原文或用户资料,不得编造规则。
  5. 模型一致性:用例图/流程图/状态图对同一实体行为不得矛盾。
  • 违规:❌在业务分析中直接设计库表 ❌跳过"登录简单"的5W1H ❌编造PRD未提规则 ❌用例操作在流程图中无对应 ❌非标准术语不定义
  • 合规:✅逐需求完整5W1H并记录 ✅输出图保持一致 ✅规则标注来源"源自PRD第3章第2节" ✅术语表定义专业词 ✅用MECE校验分类完整互斥

Rationalization 陷阱

  • "表面分析":只写做什么不写为什么→强制完成5W1H全部分析
  • "技术前置":过早引入技术细节→保持业务视角
  • "模型脱节":各图独立未交叉验证→输出前执行模型一致性检查
  • "术语泛滥":大量术语不定义→维护术语表,首次出现必定义

Red Flags 红旗

  • L1 输入:INPUT-BA-001 PRD空或<100字→🔴;002 格式无法解析→🔴;003 仅标题无描述→🟡
  • L2 执行:EXEC-BA-001 跳过5W1H任一维→🔴;002 规则未标优先级→🟡;003 CRUD未覆盖实体→🔴;004 状态转换缺触发条件→🟡
  • L3 输出:OUTPUT-BA-001 缺风险与假设→🔴;002 结论不可追溯→🟡;003 术语未定义→🟡
  • 处理:🔴立即停止上报 | 🟡记录警告尝试修复 | 🔵记录正常继续

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.