generate-prd

生成 PRD 技能

使用 Port 的服务目录数据，创建可直接用于工程实施的产品需求文档。

适用场景

• 为新功能创建 PRD
• 为 Jira/Linear 工单补充需求
• 为开发冲刺准备工作项

PRD 生成流程

步骤 1：从 Port 收集上下文

查询目标服务：

get_entity(blueprint="service", identifier="target-service", include=[
  "tier", "team", "depends_on", "readme_url", "codeowners"
])

获取近期事件（用于风险分析）：

list_entities(blueprint="incident", query={
  primary_service: "target-service",
  created_at: "<90d"
})

步骤 2：构建 PRD 结构

# PRD: [Feature Name]

## Overview
**Service**: [service-name]
**Team**: [team from Port]
**Tier**: [service tier]
**Target Release**: [date]

## Problem Statement
[What problem does this solve?]

## User Stories
As a [user type], I want to [action] so that [benefit].

## Requirements

### Functional Requirements
1. [Requirement with acceptance criteria]
2. [Requirement with acceptance criteria]

### Non-Functional Requirements
- **Performance**: [metrics]
- **Availability**: [SLA based on tier]
- **Security**: [requirements]

## Technical Considerations

### Dependencies
[List from Port's depends_on relation]

### Risk Assessment
Based on incident history:
- [Risk 1 from past incidents]
- [Risk 2]

### CODEOWNERS
[From Port data - who needs to review]

## Success Metrics
- [Metric 1]
- [Metric 2]

## Out of Scope
- [What we're NOT building]

步骤 3：按层级制定需求

根据服务层级调整需求：

层级	可用性 SLA	性能	测试
Tier1-Critical	99.99%	<100ms p99	完整 E2E、负载测试
Tier2-Core	99.9%	<500ms p99	集成测试
Tier3-Supporting	99%	<1s p99	单元测试

步骤 4：风险分析

根据以下因素标记风险：

1. 服务近期发生的事件
2. 依赖项数量
3. 服务层级（层级越高，风险越大）
4. 变更复杂度

步骤 5：更新工作项

如果已集成 Jira/Linear，请调用相应操作：

run_action("enrich_work_item", {
  work_item_id: "PROJ-123",
  prd_content: "[generated PRD]",
  risk_level: "medium"
})

质量检查清单

• 使用了 Port 中的实际服务数据
• 需求符合服务层级
• 列出了真实依赖项
• 分析了事件历史以评估风险
• 确认了正确的 CODEOWNERS
• 验收标准明确