release-announcement

发版公告自动生成工作流

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

1. ../lark-shared/SKILL.md — lark-cli 认证与权限处理

---

适用场景

• "生成发版公告"
• "从 PRD 生成 release notes"
• "发版简报 / 发版说明"
• "release-announcement {PRD链接} {版本号}"

输入

参数	示例	说明
PRD 来源	飞书 wiki URL 或 doc_token	PRD 文档地址（必填）
版本号	v26.4.1.0	发版版本号（必填）
发版日期	2026年5月13日	可选，默认取当天
产品名	PST	可选，默认 PST
产品全称	海柔售前工具（PST）	可选，默认 海柔售前工具（PST）

输入示例：

/release-announcement
PRD: https://hairobotics.feishu.cn/wiki/G36owOYXNiIDG9k7XlOc6vXlnob
版本号: v26.4.1.0

前置条件

# 飞书云文档（user 身份）— 用于读取 PRD 和创建公告文档
lark-cli auth login --domain docs,drive,wiki

工作流

{PRD 来源, 版本号, [发版日期], [产品名]}
        │
        ▼
Step 0  认证检查 ──► 确认 lark-cli user 身份可用
        │
        ▼
Step 1  获取 PRD 内容
        ├─ wiki URL → lark-cli wiki +get-node → doc_token
        ├─ lark-cli docs +fetch --as user --doc-format markdown → PRD 正文
        ▼
Step 2  分析 PRD ──► 提取更新内容
        ├─ 识别功能模块（选型/货架/布局/CAD/检测等）
        ├─ 按模块分组，P0 需求优先
        ├─ 提取核心价值方向（3个）
        ▼
Step 3  生成三版公告
        ├─ 简略版（日期 + 版本号 + 3要点摘要）
        ├─ 详细中文版（价值总览 + 分模块详述）
        ├─ 详细英文版（对应英文翻译）
        ├─ 输出预览，用户确认后进入 Step 4
        ▼
Step 4  创建飞书文档（×3）
        ├─ lark-cli docs +create --as user（关键：用户名下）
        ├─ 记录每个文档的 URL 和 doc_token
        ▼
Step 5  输出结果 + [HANDOFF] 块

---

Step 0：认证检查

确认 lark-cli user 身份可用于读写飞书文档：

lark-cli auth status

若未认证或 scope 不足，按 lark-shared/SKILL.md 引导用户完成授权：

lark-cli auth login --domain docs,drive,wiki

Step 1：获取 PRD 内容

1a. 从 wiki URL 解析 doc_token

若用户提供的是飞书 wiki URL（如 https://hairobotics.feishu.cn/wiki/XXXXX）：

lark-cli wiki +get-node --as user --node-token {wiki_token}

从返回中提取 obj_token（即 doc_token）。

1b. 拉取 PRD 正文

lark-cli docs +fetch --as user \
  --api-version v2 \
  --doc "{doc_token}" \
  --doc-format markdown

返回 PRD 的 Markdown 全文。若内容过长，重点关注：

• §4 需求详细设计 — 各功能模块的详细描述
• §5 功能清单 — P0 功能条目列表
• §3 整体说明 — 整体变更概要