lark-workflow-prd-to-userstory

PRD → User Story → 需求矩阵 → 飞书项目 工作流

CRITICAL — 开始前 MUST 用 Read 工具读取以下文件：

1. references/userstoryrule.md — User Story 通用书写规则（INVEST、P0、格式约束、跨项目复用）
2. references/template-mapping.md — 字段/角色/模板映射的 通用契约 + 项目实例
3. ../lark-shared/SKILL.md — lark-cli 认证与权限处理

---

PRD 三件套定位

write-a-prd ────► prd-sync ────► [本 skill: prd-to-userstory]
   (创建)           (同步)              (拆 Story + 同步到 Base / 飞书项目)

本 skill 是「需求落地」环节，独立可用：

• 上游可以是 write-a-prd + prd-sync 串联产出（自带 [HANDOFF] 块和 frontmatter），也可以是任何符合「§5 功能清单」结构的 PRD（手写/历史 PRD）
• 通过 template-mapping.md 的「项目实例」段落注入差异，主流程不变

本 skill 与具体产品线（PST / CPQ / WLS / 其他）解耦。

---

适用场景

• "把 PRD 同步到需求矩阵和飞书项目"
• "从 PRD 的功能清单生成 user story"
• "按版本批量创建需求"
• "对齐 {项目} 需求矩阵 v{版本} 与飞书项目 {项目}-{版本}"

输入

参数	示例	说明
项目代号	PST / CPQ / WLS 等	决定加载 template-mapping.md 中的哪个项目实例。可从 PRD frontmatter.project 读取；都没有时用 AskUserQuestion
PRD 版本号	26.5.1.0	飞书项目对应版本工作项需提前建好，名为 {项目}-{版本号}。可从 PRD frontmatter.target_version 读取
PRD 来源	本地目录 prd/2026/5/ 或飞书 wiki URL	二选一；本地优先。若前置 skill 输出了 [HANDOFF]，自动读取 local_path

如上述信息从 [HANDOFF] / frontmatter 都拿不到，用 AskUserQuestion 询问，不要猜。

前置条件

# 飞书 Base + 文档（user 身份）
lark-cli auth login --domain bitable,docs,drive

# 飞书项目 MCP 已配置（mcp__FeishuProjectMcp__*）
# 飞书云文档 MCP 已配置（mcp__feishu__*，仅在跨 wiki 读取 PRD 时使用）

另需在 references/template-mapping.md 中提前配好目标项目的实例（首次跑某个项目时，约 5 分钟一次性维护工作）。

工作流

{项目代号, PRD 版本号, PRD 来源}
        │
        ▼
Step 0    加载项目实例配置（template-mapping.md 中的 PROJECTS[{项目}]）
          │
        ▼
Step 0.5  从 [HANDOFF] / frontmatter 自动填充缺失参数
          │
        ▼
Step 1    扫描 PRD 来源 ──► 让用户确认本次同步的 PRD 文件
          │
        ▼
Step 2    Read PRD ──► 提取 §5 功能清单 + 引用的 §4 需求详细设计章节
          ├─ 按 mapping.title_prefix_rules 自动判别标题前缀
          ▼
Step 3    生成 P0 User Story 草稿（依据 references/userstoryrule.md）
          ├─ 父子去重：识别覆盖关系，AskUserQuestion 让用户确认合并策略
          ├─ 输出标准化 checkpoint 表，用户确认后才进入 Step 4
          ▼
Step 4    写入需求矩阵 Base 表（mapping.base.*）
          ├─ +record-search 检查同名记录避免重复
          ├─ +record-create 批量创建（字段名按 mapping.base.fields 映射）
          ▼
Step 5    同步到飞书项目（mcp__FeishuProjectMcp__）
          ├─ 5a 验证版本工作项存在
          ├─ 5b 批量 create_workitem
          ├─ 5c 设置当前用户为产品经理（必须，否则 5d 无权写）
          ├─ 5d 设置规划版本字段
          ├─ 5e 勾选节点开关
          ▼
Step 6    双向对齐核对 ──► 输出最终对照表