How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

prd_template - Prompt - OpenSmartRoute

Name: prd_template
Author: laozhong86

Prompt file imported from laozhong86/AI-tasks (.windsurf/workflows/prd_template.md). Copyright stays with the author.

模板结构

# {功能/产品名称} PRD

## 1. 概述 (Overview)
### 1.1 目标
[简明扼要地描述这个功能/产品的目标]

### 1.2 背景
[描述为什么需要此功能/产品，以及当前面临的问题或机会]

### 1.3 用户价值
[描述此功能/产品为目标用户带来的价值]

## 2. 目标用户 (Target Users)
[描述主要用户群体及其特点]
- 主要用户角色: [角色1, 角色2, ...]
- 用户特征: [技术水平, 使用场景, 特殊需求, ...]

## 3. 核心功能 (Core Features)
[列出并详细描述主要功能点]

### 3.1 [功能点1]
- 描述: [详细描述]
- 优先级: [高/中/低]
- 限制条件: [如有]

### 3.2 [功能点2]
- 描述: [详细描述]
- 优先级: [高/中/低]
- 限制条件: [如有]

[...]

## 4. 用户体验 (User Experience)
[描述用户如何与功能交互]

### 4.1 用户流程
[描述主要用户流程，可使用步骤列表]
1. [步骤1]
2. [步骤2]
[...]

### 4.2 UI/UX设计考虑
- 界面元素: [描述]
- 交互模式: [描述]
- 可访问性考虑: [描述]

## 5. 技术架构 (Technical Architecture)
[概述技术实现细节]

### 5.1 系统组件
[描述主要系统组件及其关系]

### 5.2 数据模型
[描述核心数据结构，可使用伪代码或图表]

### 5.3 API和集成
[描述必要的API和外部集成]
- API 1: [描述]
- API 2: [描述]
[...]

### 5.4 技术约束
[描述技术实现的限制或约束条件]
- 必须使用的技术/框架: [描述]
- 性能要求: [描述]
- 安全要求: [描述]

## 6. 开发路线图 (Development Roadmap)
[将开发过程分解为阶段]

### 6.1 MVP阶段 (最小可行产品)
- 必须实现的功能: [列表]
- 验收标准: [描述]

### 6.2 未来迭代
- 迭代1: [描述]
- 迭代2: [描述]
[...]

## 7. 逻辑依赖链 (Logical Dependency Chain)
[定义开发的逻辑顺序]
1. [第一步]: [描述]
2. [第二步]: [描述]
[...]

## 8. 风险与缓解策略 (Risks and Mitigations)
[识别潜在风险并说明应对方法]

### 8.1 [风险1]
- 描述: [详细描述]
- 影响: [高/中/低]
- 缓解策略: [描述]

### 8.2 [风险2]
- 描述: [详细描述]
- 影响: [高/中/低]
- 缓解策略: [描述]

## 9. 验收标准 (Acceptance Criteria)
[列出明确的验收标准]
- 标准1: [描述]
- 标准2: [描述]
[...]

## 10. 附录 (Appendix)
[包含任何其他信息]
- 研究发现: [描述]
- 技术规格: [描述]
- 参考资料: [链接或引用]

使用指南

模板适配
- 根据具体需求的规模和复杂性，适当调整模板的详细程度
- 对于小型功能，可以简化某些部分
- 对于复杂系统，可能需要更详细的架构描述
章节完整性
- 确保"概述"、"核心功能"和"技术架构"章节始终包含充分详细的信息
- "验收标准"对于任务分解至关重要，应尽可能具体
技术细节
- 在"技术架构"部分包含足够的细节，以便开发人员理解实现方式
- 包括具体的技术要求、框架、库和设计模式
- 数据模型应尽可能详细，以便正确设计数据结构
依赖关系
- 在"逻辑依赖链"部分清晰地定义开发顺序
- 标明哪些部分需要首先实现，以及为什么
- 确保考虑到技术依赖和业务依赖
风险评估
- 提前识别可能的技术挑战和实现风险
- 为每个风险提供明确的缓解策略
- 评估风险的影响程度，以便正确优先处理

示例（节选）

# 营销数据导出功能 PRD

## 1. 概述 (Overview)
### 1.1 目标
为企业客户提供一个简单直观的功能，使他们能够将营销活动数据导出为CSV格式，以便进行离线分析和自定义报告。

### 1.2 背景
我们的企业客户经常需要在其内部报告和分析工具中使用我们平台上的营销数据。目前，他们只能通过截图或手动复制来获取这些数据，这既耗时又容易出错。

### 1.3 用户价值
- 节省时间：自动化数据导出过程，无需手动复制
- 提高准确性：减少手动操作导致的错误
- 增强分析能力：支持在专业分析工具中处理完整数据集

## 2. 目标用户 (Target Users)
- 主要用户角色: 企业营销经理, 数据分析师
- 用户特征: 中等技术水平, 需要定期生成报告, 使用Excel或类似工具进行数据分析

## 3. 核心功能 (Core Features)

### 3.1 数据选择与过滤
- 描述: 用户可以选择要导出的特定营销活动，并可以按时间范围、活动类型和性能指标进行过滤
- 优先级: 高
- 限制条件: 单次导出限制为最多10个营销活动的数据

### 3.2 格式选项配置
- 描述: 用户可以配置CSV文件的基本格式选项，包括分隔符类型、是否包含表头、数字格式等
- 优先级: 中
- 限制条件: 支持常见的CSV格式选项，但不支持复杂的自定义格式

[...]

Install prd_template and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

## 模板结构 ```markdown # {功能/产品名称} PRD ## 1. 概述 (Overview) ### 1.1 目标 [简明扼要地描述这个功能/产品的目标] ### 1.2 背景 [描述为什么需要此功能/产品，以及当前面临的问题或机会] ### 1.3 用户价值 [描述此功能/产品为目标用户带来的价值] ## 2. 目标用户 (Target Users) [描述主要用户群体及其特点] - 主要用户角色: [角色1, 角色2, ...] - 用户特征: [技术水平, 使用场景, 特殊需求, ...] ## 3. 核心功能 (Core Features) [列出并详细描述主要功能点] ### 3.1 [功能点1] - 描述: [详细描述] - 优先级: [高/中/低] - 限制条件: [如有] ### 3.2 [功能点2] - 描述: [详细描述] - 优先级: [高/中/低] - 限制条件: [如有] [...] ## 4. 用户体验 (User Experience) [描述用户如何与功能交互] ### 4.1 用户流程 [描述主要用户流程，可使用步骤列表] 1. [步骤1] 2. [步骤2] [...] ### 4.2 UI/UX设计考虑 - 界面元素: [描述] - 交互模式: [描述] - 可访问性考虑: [描述] ## 5. 技术架构 (Technical Architecture) [概述技术实现细节] ### 5.1 系统组件 [描述主要系统组件及其关系] ### 5.2 数据模型 [描述核心数据结构，可使用伪代码或图表] ### 5.3 API和集成 [描述必要的API和外部集成] - API 1: [描述] - API 2: [描述] [...] ### 5.4 技术约束 [描述技术实现的限制或约束条件] - 必须使用的技术/框架: [描述] - 性能要求: [描述] - 安全要求: [描述] ## 6. 开发路线图 (Development Roadmap) [将开发过程分解为阶段] ### 6.1 MVP阶段 (最小可行产品) - 必须实现的功能: [列表] - 验收标准: [描述] ### 6.2 未来迭代 - 迭代1: [描述] - 迭代2: [描述] [...] ## 7. 逻辑依赖链 (Logical Dependency Chain) [定义开发的逻辑顺序] 1. [第一步]: [描述] 2. [第二步]: [描述] [...] ## 8. 风险与缓解策略 (Risks and Mitigations) [识别潜在风险并说明应对方法] ### 8.1 [风险1] - 描述: [详细描述] - 影响: [高/中/低] - 缓解策略: [描述] ### 8.2 [风险2] - 描述: [详细描述] - 影响: [高/中/低] - 缓解策略: [描述] ## 9. 验收标准 (Acceptance Criteria) [列出明确的验收标准] - 标准1: [描述] - 标准2: [描述] [...] ## 10. 附录 (Appendix) [包含任何其他信息] - 研究发现: [描述] - 技术规格: [描述] - 参考资料: [链接或引用] ``` ## 使用指南 1. **模板适配** - 根据具体需求的规模和复杂性，适当调整模板的详细程度 - 对于小型功能，可以简化某些部分 - 对于复杂系统，可能需要更详细的架构描述 2. **章节完整性** - 确保"概述"、"核心功能"和"技术架构"章节始终包含充分详细的信息 - "验收标准"对于任务分解至关重要，应尽可能具体 3. **技术细节** - 在"技术架构"部分包含足够的细节，以便开发人员理解实现方式 - 包括具体的技术要求、框架、库和设计模式 - 数据模型应尽可能详细，以便正确设计数据结构 4. **依赖关系** - 在"逻辑依赖链"部分清晰地定义开发顺序 - 标明哪些部分需要首先实现，以及为什么 - 确保考虑到技术依赖和业务依赖 5. **风险评估** - 提前识别可能的技术挑战和实现风险 - 为每个风险提供明确的缓解策略 - 评估风险的影响程度，以便正确优先处理 ## 示例（节选） ```markdown # 营销数据导出功能 PRD ## 1. 概述 (Overview) ### 1.1 目标为企业客户提供一个简单直观的功能，使他们能够将营销活动数据导出为CSV格式，以便进行离线分析和自定义报告。 ### 1.2 背景我们的企业客户经常需要在其内部报告和分析工具中使用我们平台上的营销数据。目前，他们只能通过截图或手动复制来获取这些数据，这既耗时又容易出错。 ### 1.3 用户价值 - 节省时间：自动化数据导出过程，无需手动复制 - 提高准确性：减少手动操作导致的错误 - 增强分析能力：支持在专业分析工具中处理完整数据集 ## 2. 目标用户 (Target Users) - 主要用户角色: 企业营销经理, 数据分析师 - 用户特征: 中等技术水平, 需要定期生成报告, 使用Excel或类似工具进行数据分析 ## 3. 核心功能 (Core Features) ### 3.1 数据选择与过滤 - 描述: 用户可以选择要导出的特定营销活动，并可以按时间范围、活动类型和性能指标进行过滤 - 优先级: 高 - 限制条件: 单次导出限制为最多10个营销活动的数据 ### 3.2 格式选项配置 - 描述: 用户可以配置CSV文件的基本格式选项，包括分隔符类型、是否包含表头、数字格式等 - 优先级: 中 - 限制条件: 支持常见的CSV格式选项，但不支持复杂的自定义格式 [...]

{ "prompt": "## 模板结构\n\n```markdown\n# {功能/产品名称} PRD\n\n## 1. 概述 (Overview)\n### 1.1 目标\n[简明扼要地描述这个功能/产品的目标]\n\n### 1.2 背景\n[描述为什么需要此功能/产品，以及当前面临的问题或机会]\n\n### 1.3 用户价值\n[描述此功能/产品为目标用户带来的价值]\n\n## 2. 目标用户 (Target Users)\n[描述主要用户群体及其特点]\n- 主要用户角色: [角色1, 角色2, ...]\n- 用户特征: [技术水平, 使用场景, 特殊需求, ...]\n\n## 3. 核心功能 (Core Features)\n[列出并详细描述主要功能点]\n\n### 3.1 [功能点1]\n- 描述: [详细描述]\n- 优先级: [高/中/低]\n- 限制条件: [如有]\n\n### 3.2 [功能点2]\n- 描述: [详细描述]\n- 优先级: [高/中/低]\n- 限制条件: [如有]\n\n[...]\n\n## 4. 用户体验 (User Experience)\n[描述用户如何与功能交互]\n\n### 4.1 用户流程\n[描述主要用户流程，可使用步骤列表]\n1. [步骤1]\n2. [步骤2]\n[...]\n\n### 4.2 UI/UX设计考虑\n- 界面元素: [描述]\n- 交互模式: [描述]\n- 可访问性考虑: [描述]\n\n## 5. 技术架构 (Technical Architecture)\n[概述技术实现细节]\n\n### 5.1 系统组件\n[描述主要系统组件及其关系]\n\n### 5.2 数据模型\n[描述核心数据结构，可使用伪代码或图表]\n\n### 5.3 API和集成\n[描述必要的API和外部集成]\n- API 1: [描述]\n- API 2: [描述]\n[...]\n\n### 5.4 技术约束\n[描述技术实现的限制或约束条件]\n- 必须使用的技术/框架: [描述]\n- 性能要求: [描述]\n- 安全要求: [描述]\n\n## 6. 开发路线图 (Development Roadmap)\n[将开发过程分解为阶段]\n\n### 6.1 MVP阶段 (最小可行产品)\n- 必须实现的功能: [列表]\n- 验收标准: [描述]\n\n### 6.2 未来迭代\n- 迭代1: [描述]\n- 迭代2: [描述]\n[...]\n\n## 7. 逻辑依赖链 (Logical Dependency Chain)\n[定义开发的逻辑顺序]\n1. [第一步]: [描述]\n2. [第二步]: [描述]\n[...]\n\n## 8. 风险与缓解策略 (Risks and Mitigations)\n[识别潜在风险并说明应对方法]\n\n### 8.1 [风险1]\n- 描述: [详细描述]\n- 影响: [高/中/低]\n- 缓解策略: [描述]\n\n### 8.2 [风险2]\n- 描述: [详细描述]\n- 影响: [高/中/低]\n- 缓解策略: [描述]\n\n## 9. 验收标准 (Acceptance Criteria)\n[列出明确的验收标准]\n- 标准1: [描述]\n- 标准2: [描述]\n[...]\n\n## 10. 附录 (Appendix)\n[包含任何其他信息]\n- 研究发现: [描述]\n- 技术规格: [描述]\n- 参考资料: [链接或引用]\n```\n\n## 使用指南\n\n1. **模板适配**\n - 根据具体需求的规模和复杂性，适当调整模板的详细程度\n - 对于小型功能，可以简化某些部分\n - 对于复杂系统，可能需要更详细的架构描述\n\n2. **章节完整性**\n - 确保\"概述\"、\"核心功能\"和\"技术架构\"章节始终包含充分详细的信息\n - \"验收标准\"对于任务分解至关重要，应尽可能具体\n \n3. **技术细节**\n - 在\"技术架构\"部分包含足够的细节，以便开发人员理解实现方式\n - 包括具体的技术要求、框架、库和设计模式\n - 数据模型应尽可能详细，以便正确设计数据结构\n\n4. **依赖关系**\n - 在\"逻辑依赖链\"部分清晰地定义开发顺序\n - 标明哪些部分需要首先实现，以及为什么\n - 确保考虑到技术依赖和业务依赖\n\n5. **风险评估**\n - 提前识别可能的技术挑战和实现风险\n - 为每个风险提供明确的缓解策略\n - 评估风险的影响程度，以便正确优先处理\n\n## 示例（节选）\n\n```markdown\n# 营销数据导出功能 PRD\n\n## 1. 概述 (Overview)\n### 1.1 目标\n为企业客户提供一个简单直观的功能，使他们能够将营销活动数据导出为CSV格式，以便进行离线分析和自定义报告。\n\n### 1.2 背景\n我们的企业客户经常需要在其内部报告和分析工具中使用我们平台上的营销数据。目前，他们只能通过截图或手动复制来获取这些数据，这既耗时又容易出错。\n\n### 1.3 用户价值\n- 节省时间：自动化数据导出过程，无需手动复制\n- 提高准确性：减少手动操作导致的错误\n- 增强分析能力：支持在专业分析工具中处理完整数据集\n\n## 2. 目标用户 (Target Users)\n- 主要用户角色: 企业营销经理, 数据分析师\n- 用户特征: 中等技术水平, 需要定期生成报告, 使用Excel或类似工具进行数据分析\n\n## 3. 核心功能 (Core Features)\n\n### 3.1 数据选择与过滤\n- 描述: 用户可以选择要导出的特定营销活动，并可以按时间范围、活动类型和性能指标进行过滤\n- 优先级: 高\n- 限制条件: 单次导出限制为最多10个营销活动的数据\n\n### 3.2 格式选项配置\n- 描述: 用户可以配置CSV文件的基本格式选项，包括分隔符类型、是否包含表头、数字格式等\n- 优先级: 中\n- 限制条件: 支持常见的CSV格式选项，但不支持复杂的自定义格式\n\n[...]", "variables": [], "notes": "此文件定义了AI-Tasks项目使用的标准化PRD模板，用于需求沟通阶段生成的PRD文档。该模板设计用于结构化功能需求，以便于后续在Linear中创建任务。", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/laozhong86/AI-tasks", "path": ".windsurf/workflows/prd_template.md", "ref": "a8fdb882637cb2b85d6fe6f6f606ea64dca52807", "url": "https://github.com/laozhong86/AI-tasks/blob/a8fdb882637cb2b85d6fe6f6f606ea64dca52807/.windsurf/workflows/prd_template.md", "key": "laozhong86/AI-tasks/.windsurf/workflows/prd_template.md" } } }

prd_template

About

模板结构

使用指南

示例（节选）

Install prd_template and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews