release-announcementlisted
Install: claude install-skill CookiesHaha/ash-claude-skills
# 发版公告自动生成工作流
**CRITICAL — 开始前 MUST 用 Read 工具读取以下文件:**
1. [`../lark-shared/SKILL.md`](../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
```
## 前置条件
```bash
# 飞书云文档(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 身份可用于读写飞书文档:
```bash
lark-cli auth