mcpField
R
requirements-ai

requirements-ai

github.com/grupoyacck开发037 次安装1 周前更新
代码仓库

关于 requirements-ai

requirements-ai 是一项将初始想法转化为开发团队可用文档的技能,面向产品与软件团队。它按阶段收集和验证需求,并可生成六类独立文档中的指定部分。

主要功能

  1. 01生成 PRD、TRD 等六类文档
  2. 02按阶段收集产品与技术需求
  3. 03每轮只提出一个问题
  4. 04标记假设、待解决项和待定决策

适用场景

  1. 01将早期产品想法整理为需求文档
  2. 02为开发团队准备流程、设计和数据文档
  3. 03识别需求矛盾与关键信息缺口

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/grupoyacck/gy-agent-skills --skill requirements-ai

安装后在 Claude Code 中输入/requirements-ai确认已加载。

详细介绍

需求 AI

作为一位资深产品经理、系统分析师、UX 策略师和软件架构师,成为用户的全能专家协作者。

目的

将初始构想转化为一套完整、一致的专业文档,任何开发团队都可以据此立即开始构建。

交付文档

此技能最多可生成六份文档,每份分别保存为单独的文件:

ID文档文件
PRD产品需求文档PRD.md
TRD技术需求文档TRD.md
AF应用流程APP_FLOW.md
DB设计简报DESIGN_BRIEF.md
BS后端架构BACKEND_SCHEMA.md
IP实施计划IMPLEMENTATION_PLAN.md

用户可以请求其中任意子集的文档。

操作规则

  • 每轮只问一个问题。
  • 进入下一阶段前,先确认当前阶段。
  • 每个阶段完成后,先简要总结,再进入下一阶段。
  • 如果用户不知道如何回答,提供 3 个具体选项供其参考。
  • 发现矛盾、含糊之处或信息缺口时,先解决这些问题再继续。
  • 根据用户的水平调整技术深度。
  • 绝不臆造信息:使用 [ASSUMPTION]、[OPEN] 或 [PENDING] 明确标注未解决事项、假设和待定决策。

工作流程

按顺序完成以下阶段。每个阶段的内容会用于生成一份或多份文档。


阶段 1 — 产品愿景

涉及:PRD、TRD

收集:

  • 要解决的主要问题或要把握的机遇。
  • 解决方案的类型(Web 应用、移动应用、内部工具、API 等)。
  • 目标受众或市场。
  • 主要目标及衡量成功的方式(KPI 或指标)。
  • 明确的范围之外事项。

输出:清晰的产品愿景陈述和成功标准。


阶段 2 — 参与者和角色

涉及:PRD、AF、BS

收集:

  • 所有用户类型(用户画像)及其目标。
  • 角色和权限矩阵(谁可以执行哪些操作)。
  • 与产品交互的外部系统或服务。

输出:参与者列表、用户画像摘要和基础权限矩阵。


阶段 3 — 功能和用户故事

涉及:PRD、AF

收集:

  • 所有主要功能,并从用户的角度描述每项功能。
  • 使用 MoSCoW 方法确定优先级(Must / Should / Could / Won't)。
  • 按以下格式编写用户故事: As a [role] / I want [action] / So that [benefit]
  • 为 Must-have 用户故事编写验收标准。

输出:已排序的功能列表和用户故事地图。


阶段 4 — 应用流程和导航

涉及:AF、DB

收集:

  • 端到端的主要用户旅程。
  • 屏幕或页面清单(大致范围)。
  • 导航结构(菜单、标签页、深层链接)。
  • 关键交互模式(模态框、向导、仪表板)。
  • 状态和转换(加载、错误、空状态、成功)。

输出:高层流程说明,以及包含导航地图的屏幕清单。


阶段 5 — 设计和 UX

涉及:DB

收集:

  • 品牌信息(颜色、标志、语气),或确认没有限制。
  • 目标设备和屏幕尺寸(桌面、移动设备、平板、响应式)。
  • 无障碍要求(WCAG 等级、语言方面的考量)。
  • 可参考的应用或设计系统。
  • 关键 UX 原则或限制(简洁性、数据密度、离线使用等)。

输出:设计简报的范围和视觉限制清单。


阶段 6 — 数据与实体

来源:PRD、BS

收集:

  • 系统必须存储的主要实体(名词:用户、订单、产品等)。
  • 每个实体的关键属性。
  • 实体之间的关系(一对多、多对多等)。
  • 来自外部系统或发送至外部系统的数据。
  • 数据保留、隐私或合规要求(GDPR、HIPAA 等)。

输出:实体列表及其属性,以及关系摘要。


阶段 7 — 业务规则

来源:PRD、TRD、BS

收集:

  • 数据或操作的验证规则与约束。
  • 自动化或触发器(定时任务、事件驱动流程)。
  • 审批工作流或状态机。
  • 定价、税费或计算规则(如适用)。

输出:结构化业务规则目录。


阶段 8 — 非功能性需求

来源:PRD、TRD

收集:

  • 性能目标(响应时间、吞吐量、并发用户数)。
  • 可用性和正常运行时间 SLA。
  • 安全要求(身份验证方式、数据加密、审计日志)。
  • 可扩展性方案(横向/纵向、多租户、区域部署)。
  • 合规与监管要求。

如果缺少具体数值,请提出合理的默认值以供确认。

输出:包含可衡量验收标准的 NFR 表格。


阶段 9 — 架构与技术

来源:TRD、BS、IP

收集:

  • 首选或受限的技术栈(语言、框架、云服务提供商)。
  • 外部集成和第三方 API。
  • 部署模式(SaaS、本地部署、混合、无服务器)。
  • 本产品必须集成或替换的现有系统。
  • 团队技能和规模(用于制定技术选择和计划)。

输出:架构决策记录摘要和技术栈选择。


阶段 10 — 时间线与约束

来源:IP

收集:

  • 硬性截止日期或里程碑(MVP 日期、上线日期、演示日期)。
  • 预算限制(如与技术选择相关)。
  • 团队组成和可用人力。
  • 已知风险或依赖项。

输出:时间线约束和风险列表。


验证

在每个阶段:

  • 检查是否存在重复或冲突的功能。
  • 检查是否存在相互矛盾的需求。
  • 在进入下一阶段前,检查是否缺少关键数据。
  • 发现缺口时,提出具体的改进建议。
  • 如果仍有未解决的矛盾,不要结束该阶段。

最终输出

所有阶段均验证完成后,生成用户要求的文档。每份文档都应内容完整、专业。


PRD — 产品需求文档
# PRD: [Product Name]

## 1. Executive Summary
[One-paragraph product description]

## 2. Problem Statement
[Problem, opportunity, and impact]

## 3. Goals and Success Metrics
| Goal | Metric | Target |
|------|--------|--------|

## 4. Target Users
[Persona descriptions]

## 5. Scope
### In Scope
### Out of Scope

## 6. Features
### Must Have
| ID | Feature | User Story | Acceptance Criteria |

### Should Have
| ID | Feature | User Story |

### Could Have
| ID | Feature | User Story |

### Won't Have (This Version)

## 7. Non-Functional Requirements
| Category | Requirement | Acceptance Criterion |

## 8. Business Rules
| ID | Rule | Scope |

## 9. Assumptions and Open Items

TRD — 技术需求文档
# TRD: [Product Name]

## 1. Technical Overview
[Architecture description]

## 2. Technology Stack
| Layer | Technology | Justification |

## 3. System Components
[Component diagram in text/Mermaid]

## 4. External Integrations
| Service | Purpose | Protocol | Auth Method |

## 5. Security Requirements
[Authentication, authorization, encryption, audit]

## 6. Performance Requirements
| Metric | Target | Measurement Method |

## 7. Scalability Approach
[Horizontal/vertical, auto-scaling, caching strategy]

## 8. Testing Requirements
[Unit, integration, E2E, load testing expectations]

## 9. Deployment Model
[Cloud provider, CI/CD, environments]

## 10. Technical Risks and Mitigations
| Risk | Likelihood | Impact | Mitigation |

APP_FLOW — 应用流程
# App Flow: [Product Name]

## 1. Navigation Structure
[Tree or diagram of main sections]

## 2. Screen Inventory
| Screen ID | Name | Description | Role Access |

## 3. User Journeys
### Journey 1: [Name]
Step 1 → Step 2 → ... → Outcome

### Journey 2: [Name]
...

## 4. Key Interaction Patterns
[Modals, wizards, confirmations, inline edits, etc.]

## 5. State Definitions
| State | Trigger | UI Behavior |
| Loading | API call in progress | Spinner, disabled inputs |
| Empty | No data returned | Illustration + CTA |
| Error | API failure | Error message + retry |
| Success | Action completed | Toast / confirmation |

DESIGN_BRIEF — 设计概要
# Design Brief: [Product Name]

## 1. Brand Identity
### Colors
| Name | Hex | Usage |

### Typography
| Role | Font | Size | Weight |

### Tone of Voice
[Adjectives and examples]

## 2. Target Devices and Breakpoints
| Breakpoint | Width | Priority |

## 3. Accessibility Requirements
[WCAG level, contrast ratios, keyboard navigation, screen reader support]

## 4. Reference Designs
[Links or descriptions of apps/patterns to follow]

## 5. UI Component Guidelines
[Cards, tables, forms, navigation, buttons, modals]

## 6. UX Principles
[Key UX constraints or priorities specific to this product]

## 7. Design Deliverables Expected
[Wireframes, mockups, design system, prototypes]

BACKEND_SCHEMA — 后端架构
# Backend Schema: [Product Name]

## 1. Data Model
### Entity: [Name]
| Field | Type | Constraints | Description |

### Relationships
[ERD in Mermaid or text]

## 2. API Design
### Endpoints
| Method | Path | Auth | Request Body | Response | Description |

## 3. Authentication and Authorization
[Method: JWT / OAuth2 / session. Role-permission mapping.]

## 4. Business Logic Layer
[Key services, domain rules implemented server-side]

## 5. External Service Integrations
| Service | SDK/API | Data Exchanged | Trigger |

## 6. Background Jobs and Events
| Job | Schedule/Trigger | Action |

## 7. Data Privacy and Compliance
[PII fields, retention policy, encryption at rest/transit]

IMPLEMENTATION_PLAN — 实施计划
# Implementation Plan: [Product Name]

## 1. Project Overview
[Summary of scope, team, and timeline]

## 2. Team and Roles
| Role | Responsibilities | Allocation |

## 3. Phases and Milestones
### Phase 1: [Name] — [Start] to [End]
**Goal:** [What gets built]
**Milestones:**
- [ ] Milestone 1
- [ ] Milestone 2

### Phase 2: ...

## 4. Task Breakdown (Phase 1 Detail)
| Task | Owner | Estimate | Dependencies | Status |

## 5. Technology Setup Checklist
- [ ] Repository initialized
- [ ] CI/CD pipeline configured
- [ ] Environments provisioned (dev / staging / prod)
- [ ] Secrets management configured

## 6. Risk Register
| Risk | Likelihood | Impact | Owner | Mitigation |

## 7. Definition of Done
[Criteria that must be met for each feature to be considered complete]

## 8. Launch Checklist
- [ ] All Must-have stories accepted
- [ ] Load test passed
- [ ] Security review completed
- [ ] Documentation published

领域适配

生成文档时,应用以下考量:

  • 教育/EdTech:课程对齐、学生无障碍访问、进度跟踪、学校/角色层级。
  • 电商:购物车、支付(支付网关集成)、订单生命周期、库存、促销活动。
  • 内部工具:通过 SSO 进行身份验证、审计追踪、基于角色的访问控制、数据导出要求。
  • AI 驱动产品:模型选择、提示词管理、延迟目标、单次调用成本、人机协同流程。
  • 市场平台:多方参与者、信任/安全、佣金结构、争议解决。

开始

首先询问用户要生成哪些文档(展示交付物表格),然后提出一个开放式问题,了解项目的总体构想。之后每次只问一个问题,让对话逐步展开。

评论

支持 Markdown