tapd-prd Skill
概述
本技能帮助产品经理将业务诉求点快速转化为结构化 PRD，并一键提报至 TAPD 平台指定空间的 Story（需求单）。AI 负责自动补全系统实现逻辑、优化表达，用户确认后直接提报，全程无需手动填写 TAPD 表单。
触发条件
当用户提出以下需求时触发本 Skill：
- 根据业务诉求点写 PRD / 生成需求文档
- 把需求提报到 TAPD
- 创建 TAPD Story / 需求单
- 整理需求并同步到 TAPD
- 帮我写 PRD 并提交
使用流程
- AI 收集 workspace_id 和业务诉求点
- AI 生成四段结构化 PRD 草稿并展示
- 用户确认或要求修改
- 确认后 AI 调用 TAPD 工具提报 Story
- 展示提报结果（Story ID / 链接）
执行指令
> 以下是 AI 执行本 Skill 时必须严格遵循的逐步指令。
Step 1：收集信息
首先检查用户是否已提供以下两项信息：
A. workspace_id（TAPD 空间 ID）
- 如果用户已提供，记录该值，进入 Step 1B。
- 如果用户未提供，调用 mcp__tapd__get_user_participant_projects 获取用户参与的项目列表。
- 若返回空列表（用户未加入任何项目），提示："您当前未加入任何 TAPD 项目，请确认是否已加入项目或联系管理员。"然后结束流程，不再进入 Step 1B 及后续步骤。
- 若返回非空列表，格式化展示项目名称和对应的 workspace_id，让用户选择目标空间。例如：
请选择要提报的 TAPD 空间：
1. 项目 A（workspace_id: 12345678）
2. 项目 B（workspace_id: 87654321）
请输入序号或直接输入 workspace_id：
用户选择后记录 workspace_id，进入 Step 1B。
B. 业务诉求点
- 如果用户已提供业务诉求点（可以是一句话、多条要点、或自然语言描述），记录原始内容，进入 Step 2。
- 如果用户仅表达了模糊意图（如"帮我写个需求"），追问：
请描述这次需求的业务诉求点，可以包括：
- 目前存在的问题或痛点
- 希望实现的功能或改变
- 面向的用户群体
收到回答后进入 Step 2。
Step 2：生成 PRD 草稿
基于收集到的业务诉求点，按以下规则生成 PRD 草稿：
生成规则：
1. 内容风格：精准凝练，补全系统实现逻辑（包括用户操作流程、后端处理逻辑、边界情况、异常处理），不添加与诉求点无关的内容。
2. 格式要求：纯文本，不使用 Markdown（无 #、、- 等符号），不使用 HTML。
3. 字数参考：需求背景 100-200 字，需求收益 80-150 字，需求详情 300-600 字，上线计划 100-200 字。
4. 排版规则**（提升可读性）：
- 段落标题使用中文序号：一、需求背景；二、需求收益；三、需求详情；四、上线计划
- 段落标题后空一行再接内容
- 段落内容按逻辑分段，每段之间空一行
- 遇到并列要点（如多条策略、多个收益点、多个里程碑）时，使用 1. 2. 3. 编号逐条列举，每条独占一行
- 四个大段落之间用两个空行分隔
PRD 四段结构：
一、需求背景
[说明业务背景：现有系统或流程的现状、存在的痛点、触发本次需求的具体场景。要结合诉求点中的实际问题展开，避免空泛描述。]
二、需求收益
[量化或定性说明该需求带来的价值。能量化的给出数据预期（如减少操作步骤 X 步、降低错误率 X%），不能量化的用清晰的定性描述（如提升用户体验、降低人工介入成本）。多个收益点用 1. 2. 3. 编号逐条列举。]
三、需求详情
[完整描述功能逻辑，多个并列要点用 1. 2. 3. 编号逐条列举。包括：用户操作流程（入口在哪、操作步骤、最终结果）；系统处理逻辑（前后端各自的职责、数据流转方式）；边界情况（并发、数据为空、超限等场景的处理方式）；异常处理（接口失败、网络异常时的兜底策略）；权限与角色（若有角色区分，说明各角色的操作权限）。各类别内部如有多个子项，也用 1. 2. 3. 编号列举。]
四、上线计划
1. PRD 评审：[建议日期或周期]
2. 开发周期：[建议工作日数]
3. 测试周期：[建议工作日数]
4. 上线时间：[建议日期或周期]
5. 灰度策略：[如适用，说明是否需要灰度及范围]
Story 标题提取规则：
从业务诉求点中提取一个清晰的 Story 标题，格式为：[模块名称]：功能描述
示例：
- 消息中心：支持群消息关键词筛选
- 审批流程：新增跨部门协同审批节点
- 数据报表：支持自定义日期范围导出
展示格式：
将生成结果以如下格式展示给用户：
Story 标题：[提取的标题]
========== PRD 草稿 ==========
一、需求背景
[内容]
二、需求收益
1. [收益点1]
2. [收益点2]
三、需求详情
1. [详情项1]
2. [详情项2]
[系统处理逻辑]
边界情况：
1. [边界项1]
2. [边界项2]
异常处理：
1. [异常项1]
2. [异常项2]
权限与角色：
1. [权限项1]
2. [权限项2]
四、上线计划
1. PRD 评审：[日期]
2. 开发周期：[天数]
3. 测试周期：[天数]
4. 上线时间：[日期]
5. 灰度策略：[说明]
==============================
Step 3：等待用户确认
展示草稿后，询问用户：
以上是根据您的诉求点生成的 PRD 草稿。
请确认：
A. 确认提报 → 直接提交到 TAPD
B. 修改某部分 → 请说明需要修改的内容
C. 取消 → 不提报，结束流程
处理用户反馈：
- 用户选 A（确认）：进入 Step 4。
- 用户要求修改：按用户意见调整对应段落，保持其他段落不变，重新展示完整草稿，再次进入 Step 3 确认流程。修改时只改用户指定的内容，不主动改动其他部分。
- 用户选 C（取消）：回复"已取消，PRD 未提报。如需重新开始，请告知。"并结束流程，不调用任何 TAPD 工具。
- 用户仅回复"好"、"可以"、"提交吧"等确认语：视为选 A，进入 Step 4。
- 用户回复含义不明确（既非确认、修改，也非取消，如"我再看看"、"想想再说"）：默认追问"请确认是否提报（A 确认 / B 修改 / C 取消）"，等待用户明确回复后再继续。
Step 4：提报 TAPD
预校验：提报前检查 name（Story 标题）和 description（PRD 全文）是否非空。若任一为空，提示用户补充对应内容，不直接调用接口；补充后重新执行预校验，通过后再调用接口。
调用 mcp__tapd__create_story_or_task 创建 Story，参数如下：
| 参数 | 值 |
|---|---|
| workspace_id | 用户提供或选择的空间 ID |
| name | Step 2 提取的 Story 标题 |
| description | Step 2 生成的 PRD 全文（四段纯文本拼接，段落之间空行分隔） |
| type | story |
description 字段拼接格式（纯文本，段落间空行分隔）：
一、需求背景
[内容]
二、需求收益
[内容]
三、需求详情
[内容]
四、上线计划
1. PRD 评审：[日期]
2. 开发周期：[天数]
3. 测试周期：[天数]
4. 上线时间：[日期]
5. 灰度策略：[说明]
提报成功后：
展示成功信息，包括：
- Story 标题
- Story ID（从接口返回中提取）
- TAPD 链接（如接口返回了 url 字段则展示，否则提示用户去 TAPD 查看）
示例：
Story 已成功提报至 TAPD！
标题：消息中心：支持群消息关键词筛选
Story ID：1234567890
TAPD 链接：https://tapd.cn/xxxxx/prong/stories/view/1234567890
提报失败时：
- 解析接口返回的错误信息，向用户展示可读的错误原因。
- 常见错误处理：
- workspace_id 无效或无权限 → 提示用户确认空间 ID 是否正确，并建议重新调用 mcp__tapd__get_user_participant_projects 获取可用空间
- 网络异常或服务不可用 → 提示稍后重试，并保留 PRD 内容供用户复制
- 提供重试选项：
提报失败，原因：[错误信息]
是否要重试？或者您可以：
1. 重新选择空间并提报
2. 复制 PRD 内容手动提报
示例
示例 1：完整流程（已知 workspace_id）
用户输入：
帮我写 PRD 并提报到 TAPD，workspace_id 是 12345678。
诉求点：
1. 目前审批消息只有站内通知，漏看率高
2. 希望支持企业微信推送审批提醒
3. 推送内容包括审批单标题、申请人、紧急程度
4. 用户可以在个人设置中开关该通知
AI 行为：
1. 记录 workspace_id=12345678，记录 4 条诉求点
2. 生成 PRD 草稿，Story 标题提取为"审批通知：新增企业微信推送提醒"
3. 展示草稿，询问确认
4. 用户确认后调用 mcp__tapd__create_story_or_task 提报
5. 展示 Story ID 和链接
示例 2：未提供 workspace_id
用户输入：
帮我写个 PRD，需求是：数据报表页面加个导出功能，支持按日期范围导出 CSV
AI 行为：
1. 发现用户未提供 workspace_id
2. 调用 mcp__tapd__get_user_participant_projects 获取项目列表
3. 展示项目列表让用户选择
4. 用户选择后继续生成 PRD 草稿
示例 3：用户要求修改
用户输入（看到草稿后）：
需求详情部分太简单了，帮我补充一下边界情况：导出数据量超过 10 万行时怎么处理？
AI 行为：
1. 仅修改"需求详情"段落，补充大数据量导出的边界处理（如分片导出、异步任务、进度提示等）
2. 重新展示完整草稿
3. 再次询问确认
示例 4：业务诉求点模糊
用户输入：
帮我写个需求，关于权限的
AI 行为：
1. 发现诉求点过于模糊，追问：
请描述这次需求的业务诉求点，可以包括：
- 目前存在的问题或痛点（例如：哪类用户看到了不该看的内容？）
- 希望实现的功能或改变（例如：按角色控制菜单显示？按数据维度控制查看权限？）
- 面向的用户群体（例如：管理员、普通员工、外部合作方）
2. 收到补充信息后生成 PRD
