A collection of Claude Code Plugins and Skills for PRD 全流程工作流（PRD authoring → bi-directional sync → User Story pipeline → Release Announcement）on Lark / 飞书.
作者： 雪松-Ash Zeng · License： MIT
四个技能互相独立又串联，覆盖从功能大纲到发版公告的完整链路：
┌──────────────┐ ┌────────────────┐ ┌───────────────────────────┐ ┌──────────────────────┐
│ write-a-prd │ → │ prd-sync │ → │ prd-to-userstory │ → │ release-announcement │
│ ✍️ 创建 PRD │ │ 🔄 飞书 ↔ 本地 │ │ 📋 PRD → User Story │ │ 📢 PRD → 发版公告 │
│ 骨架 │ │ 同步 │ │ → 需求矩阵 → 飞书项目 │ │ 简略版 / 中文 / 英文 │
└──────────────┘ └────────────────┘ └───────────────────────────┘ └──────────────────────┘
↓ ↓ ↓ ↓
本地 .md + 下载飞书 PRD + 读功能清单 + 提取更新内容 +
飞书云文档骨架 整理评论为 OQ + 生成 P0 User Story + 生成三版公告 +
YAML frontmatter 增量同步回飞书 写 Base 表 + 飞书项目 创建飞书云文档
| 技能 | 作用 | 触发关键词 |
|---|---|---|
write-a-prd |
从功能大纲生成本地 Markdown PRD + 飞书云文档骨架，按统一章节规范（§1–§7）输出。 | 写 PRD / 创建 PRD 初稿 / write-a-prd |
lark-workflow-prd-sync |
飞书 ↔ 本地双向同步：下载 PRD、整理评论为 Open Questions、依据 §4 详细设计回填 §3.1 整体变更与 §5 功能清单、增量同步（不覆盖 §4）。 | prd sync / prd 同步 / 从飞书下载 PRD |
lark-workflow-prd-to-userstory |
PRD 功能清单 → P0 User Story → 飞书需求矩阵 Base 表 → 飞书项目对应版本工作项。 | prd to userstory / prd 转需求 / 按版本批量创建需求 |
release-announcement |
PRD → 三版发版公告（简略版 + 详细中文版 + 详细英文版），自动创建为飞书云文档。 | 生成发版公告 / release notes / 发版简报 |
npm install -g @larksuite/lark-cli
lark-cli --version
lark-cli config init
lark-cli auth login --scope "docs:document docs:document:readonly docs:document.comment:read docs:document.comment:write docx:document:write_only bitable:app wiki:wiki:write wiki:wiki:readonly"scope 是增量授权的：多次
auth login --scope "..."会把新 scope 累积到现有 token，无需重新授权已有 scope。
在 ~/.claude.json（全局）或 <project>/.mcp.json（项目级）中添加：
{
"mcpServers": {
"FeishuProjectMcp": { "command": "npx", "args": ["-y", "@feishu-project/mcp-server"] },
"feishu": { "command": "npx", "args": ["-y", "@larksuite/feishu-mcp"] }
}
}重启 Claude Code 后输入 /mcp 验证 mcp__FeishuProjectMcp__* / mcp__feishu__* 工具列表已加载。
# 1. 添加 marketplace（已添加可跳过）
/plugin marketplace add https://github.com/CookiesHaha/ash-claude-skills
# 2. 安装 plugin
/plugin install ash-workflow@ash-claude-marketplace
# 3. 运行向导：体检 lark-cli / OAuth scope / MCP / template-mapping
/lark-prd-workflow-setup安装后 Claude Code 会自动提示运行 /lark-prd-workflow-setup。
/plugin marketplace update ash-claude-skills
/plugin upgrade ash-workflow我：写一个 PRD，标题"商家后台批量导出订单"，目标版本 v1.2.0，项目 SHOP
- 订单列表勾选导出
- 单次导出上限 10000 条
- 权限校验
Claude → 触发 write-a-prd
→ 生成 prd/2026/5/shop-batch-export-prd.md
→ 创建飞书云文档（自动回填 feishu_url 到 frontmatter）
→ 输出 [HANDOFF] 块
我：好的，把它同步回飞书
Claude → 触发 prd-sync
→ 拉评论、维护 OQ、增量同步回飞书
我：把功能清单拆成 user story 同步到 SHOP 项目 v1.2.0
Claude → 触发 prd-to-userstory
→ 写 Base 表 → 写飞书项目 → 输出最终对照表
我：生成发版公告
Claude → 触发 release-announcement
→ 提取更新内容，生成简略版 + 详细中文版 + 详细英文版
→ 创建三份飞书云文档，输出链接
我：把这个飞书文档同步到本地并整理评论
https://xxx.feishu.cn/wiki/abc123
Claude → 触发 prd-sync → 下载 → 补 frontmatter → 整理 OQ → 同步回飞书
我：拆 user story 写到飞书项目
Claude → 触发 prd-to-userstory（自动读取 [HANDOFF]）
我：生成发版公告
PRD: https://xxx.feishu.cn/wiki/abc123
版本号: v1.2.0
Claude → 触发 release-announcement
→ 读取 PRD → 提取 P0 功能 → 生成三版公告预览
→ 用户确认后创建飞书云文档（简略版 / 详细中文版 / 详细英文版）
运行 /lark-prd-workflow-setup 后，按提示填入：
- 飞书需求矩阵 Base App Token / User Story 表 table_id
- 飞书项目 project_key
- User Story 字段 ID / 角色 ID 映射
配置保存在项目 .claude/lark-prd-workflow/template-mapping.local.md（已 gitignore）。
| 编号 | 章节 | 谁写 | 谁读 |
|---|---|---|---|
frontmatter |
YAML 元数据 | write-a-prd 生成 / prd-sync 维护 | 全流程共用 |
§1 版本信息 |
版本号 / 创建日期 / 审核人 | write-a-prd | prd-sync 维护 |
§2 变更日志 |
每次大/小版本一行 | prd-sync | — |
§3 整体说明 |
§3.1 整体变更 / §3.2 范围说明 |
prd-sync 从 §4 自动生成 | release-announcement 参考 |
§4 需求详细设计 |
核心创作区（## 模块 + ### 子项） |
用户主笔 | prd-sync 不覆盖 / release-announcement 提取内容 |
§5 功能清单 |
功能模块 / 描述 / P0 / 待开发 / 备注 表格 |
prd-sync 自动生成 | prd-to-userstory 解析 / release-announcement 参考 |
§6 Open Questions |
评论锚定的待澄清问题 | prd-sync 维护 | 评审用 |
§7 附录 |
参考文档 / 术语表 | 用户 | — |
关键约束：prd-sync 严禁覆盖 §4（用户的核心创作区），只增量更新 §3.1 / §5 / §6 / §2。
每个技能完成后输出标准化 [HANDOFF] 块，下一个技能自动读取：
[HANDOFF: write-a-prd → prd-sync]
- local_path: prd/2026/5/xxx-prd.md
- feishu_url: https://xxx.feishu.cn/wiki/xxx
- feishu_doc_token: xxx
- version: 1.0
- status: draft
- feature_count: 7
- open_questions: 0
- project: SHOP
- target_version: v1.2.0
[HANDOFF: release-announcement]
- product: SHOP
- version: v1.2.0
- release_date: 2026年5月14日
- prd_source: https://xxx.feishu.cn/wiki/xxx
- brief_url: https://xxx.feishu.cn/docx/xxx
- cn_url: https://xxx.feishu.cn/docx/xxx
- en_url: https://xxx.feishu.cn/docx/xxx
| 现象 | 可能原因 | 解决 |
|---|---|---|
lark-cli 报 Permission denied |
缺 scope | lark-cli auth login --scope "<缺失的 scope>" |
mcp__FeishuProjectMcp__* 工具不可见 |
MCP 未配置 / 未重启 | 检查 .mcp.json，重启后输入 /mcp |
| 同步回飞书后 §4 内容被清空 | 误用了 overwrite 模式 | prd-sync 必须用 block_replace，见 SKILL.md Step 6 |
| 飞书项目报"无权编辑规划版本" | 当前用户不是工作项「产品经理」 | prd-to-userstory Step 5c 会自动加角色，勿跳过 |
| 发版公告文档创建在 bot 名下 | 命令缺少 --as user |
release-announcement Step 4 强制检查，见 SKILL.md |
Unknown skill: lark-prd-workflow:xxx |
plugin 缓存版本过旧 | /plugin upgrade ash-workflow |
欢迎 PR / Issue。新增 skill 请遵循：
- skill 目录放在
plugins/<plugin-name>/skills/<skill-name>/ - 不在
SKILL.md或references/中包含任何企业内部 ID（app_token、project_key、field_xxx 等真实值） - 内部配置一律走
*.local.md并依赖.gitignore - SKILL.md 顶部
description字段要明确触发关键词，避免与已有 skill 冲突
⚠️ 以下 clone + symlink 方式已弃用，推荐改用 Plugin 方式（见上方安装步骤）。
cd ~/.claude/skills/
git clone https://github.com/CookiesHaha/ash-claude-skills.git _ash-prd
ln -s _ash-prd/skills/write-a-prd .
ln -s _ash-prd/skills/lark-workflow-prd-sync .
ln -s _ash-prd/skills/lark-workflow-prd-to-userstory .# 1. 删除旧 symlink（不删源文件）
rm -f ~/.claude/skills/write-a-prd
rm -f ~/.claude/skills/lark-workflow-prd-sync
rm -f ~/.claude/skills/lark-workflow-prd-to-userstory
rm -f ~/.claude/skills/lark-shared
# 2. 安装 Plugin
/plugin marketplace add https://github.com/CookiesHaha/ash-claude-skills
/plugin install ash-workflow@ash-claude-marketplace
# 3. 重跑向导
/lark-prd-workflow-setup