🤖 PRD 生成 Agent

🧠 基于 Prompt Engineering 的 AI 生成

系统内置10+ 精心设计的 Prompt 模板，覆盖 PRD 的各个章节：

• executive_summary - 执行摘要生成
• problem_statement - 问题陈述撰写
• functional_requirements - 功能需求细化
• non_functional_requirements - 非功能需求定义
• user_personas - 用户画像创建
• business_processes - 业务流程设计
• data_models - 数据模型构建
• api_contracts - API 协议制定
• risks_assessment - 风险评估识别
• release_plan - 发布计划规划
• success_metrics - 成功指标定义

⚙️ PRDGenerationConfig 配置类

@dataclass
class PRDGenerationConfig:
    """PRD 生成配置"""
    model: str = "claude-sonnet-4-20250514"  # AI 模型
    max_tokens: int = 4096                   # 最大生成长度
    temperature: float = 0.7                 # 创造性程度 (0-1)
    enable_ai_enhancement: bool = True       # 是否启用 AI 增强
    auto_fill_metadata: bool = True          # 自动填充元数据
    generate_examples: bool = True           # 生成示例数据
    output_formats: List[str] = None         # 输出格式 ["json", "markdown", "html"]

📝 功能需求生成 Prompt

你是一位技术产品经理，请将以下用户故事转换为详细的功能需求规格。

【输入信息】
用户故事：{user_story}
验收标准：{acceptance_criteria}
业务领域：{business_domain}

【输出要求】
请生成一个完整的功能需求对象，包含以下字段（JSON 格式）：
{{
    "title": "功能标题（10 字以内）",
    "description": "详细功能描述（200-500 字）",
    "type": "功能性需求",
    "priority": "P0/P1/P2/P3",
    "acceptance_criteria": ["验收标准 1", "验收标准 2"],
    "business_rules": ["业务规则 1", "业务规则 2"],
    "data_requirements": ["需要存储的数据字段"],
    "ui_requirements": ["界面元素和交互要求"],
    "api_requirements": ["需要的 API 接口"],
    "constraints": ["技术/业务/法律约束"],
    "assumptions": ["前提假设"]
}}

确保需求是可测试、可实现的，并且与验收标准一致。

📥 智能电商用户中心 - 输入数据

product_name = "智能电商用户中心"
product_vision = "成为中小企业首选的智能化用户管理平台"
target_users = [
    "中小电商企业主（25-45 岁，年销售额 100-1000 万）",
    "电商运营人员（负责客户服务和营销）",
    "客服人员（处理用户咨询和售后）"
]
user_pain_points = [
    "客户数据分散在多个系统，无法形成统一视图",
    "客服响应时间长，平均需要 24 小时",
    "缺乏个性化服务能力，客户体验差",
    "营销转化率低，复购率不足 20%"
]
confirmed_user_stories = [
    {
        "id": "US-001",
        "title": "手机号验证码登录",
        "story": "作为用户，我想要通过手机号验证码快速登录，以便无需记住密码即可访问账户",
        "priority": "must_have",
        "acceptance_criteria": [
            "Given 用户已注册，When 请求验证码，Then 5 分钟内收到短信",
            "Given 验证码正确，When 提交验证，Then 登录成功并跳转首页"
        ]
    },
    {
        "id": "US-002",
        "title": "个人资料管理",
        "story": "作为用户，我想要编辑个人资料和上传头像，以便展示个性化信息",
        "priority": "should_have",
        "acceptance_criteria": [
            "用户可以修改昵称（2-20 字符）",
            "用户可以上传头像（JPG/PNG，最大 5MB）"
        ]
    }
]

🚀 安装依赖

# 安装 Anthropic SDK（如需 AI 生成功能）
pip install anthropic

# 设置 API Key（可选，不提供则使用模板填充）
export ANTHROPIC_API_KEY="your-api-key-here"

📝 基本用法

from prd_generation_agent import (
    PRDGenerationAgent,
    PRDGenerationInput,
    PRDGenerationConfig
)

# 1. 准备输入数据
input_data = PRDGenerationInput(
    product_name="我的产品",
    product_vision="产品愿景描述",
    target_users=["目标用户 1", "目标用户 2"],
    user_pain_points=["痛点 1", "痛点 2"],
    confirmed_user_stories=[
        {
            "id": "US-001",
            "title": "用户故事标题",
            "story": "作为...我想要...以便...",
            "priority": "must_have",
            "acceptance_criteria": ["验收标准 1"]
        }
    ],
    business_domain="行业领域"
)

# 2. 创建 Agent
agent = PRDGenerationAgent(
    api_key="sk-...",  # 或从环境变量读取
    config=PRDGenerationConfig(
        enable_ai_enhancement=True,
        output_formats=["json", "markdown", "html"]
    )
)

# 3. 生成 PRD
prd = agent.generate_full_prd(input_data, output_dir="./output")

# 4. 查看结果
print(f"PRD ID: {prd.metadata.prd_id}")
print(f"功能需求数：{len(prd.functional_requirements)}")