飞书需求文档三件套创建

根据需求文档链接，在指定的飞书知识库目录下自动创建 CR文档、技术方案、发布计划，并填充标准模板内容。

AI 执行指令

当用户调用此 skill 时，按照以下步骤执行：

步骤 1：获取需求文档链接

用户只需提供一个飞书需求文档链接即可：

格式：https://xxx.feishu.cn/wiki/xxxx
用于提取需求名称作为文档标题前缀

三个文档各自的目标目录已内置默认值（脚本 scripts/create_docs.py 顶部），无需用户每次指定：

DEFAULT_CR_ROOT — CR 文档目录
DEFAULT_TECH_ROOT — 技术方案目录
DEFAULT_PLAN_ROOT — 发布计划目录

如需更改，直接修改脚本中对应的常量即可。

脚本会自动在每个目标目录下按 年份 → 季度 定位或创建子目录：

CR目录（DEFAULT_CR_ROOT）
└── 2026 → Q1 → {需求名称} CR文档

技术方案目录（DEFAULT_TECH_ROOT）
└── 2026 → Q1 → {需求名称} 技术方案

发布计划目录（DEFAULT_PLAN_ROOT）
└── 2026 → Q1 → {需求名称} 发布计划

步骤 2：直接执行

收到两个链接后，无需额外确认，直接执行创建。

步骤 3：执行创建

3.1 检查环境变量

确认 FEISHU_APP_ID 和 FEISHU_APP_SECRET 已设置

3.2 调用脚本

cd /Users/wepie/go/src/activity_ai_server/skills/common/feishu-technology-doc
python3 scripts/create_docs.py "<需求文档URL>"

只需传入需求文档 URL，三个文档的目标目录使用脚本内置默认值（DEFAULT_CR_ROOT、DEFAULT_TECH_ROOT、DEFAULT_PLAN_ROOT）。

步骤 4：展示结果

成功时： 脚本 stdout 输出 JSON 结果，stderr 输出进度信息。从 JSON 中提取信息，按以下固定格式输出（文档名称带飞书链接）：

玩法文档：[{需求名称}]({需求文档URL})
CR文档：[{需求名称} CR文档]({CR文档URL})
技术方案：[{需求名称} 技术方案]({技术方案URL})
发布计划：[{需求名称} 发布计划]({发布计划URL})

示例：

玩法文档：[法A-命运之轮集合页【3.16-3.22】玩法页【3.19-3.25】](https://wepie.feishu.cn/wiki/xxx)
CR文档：[法A-命运之轮集合页【3.16-3.22】玩法页【3.19-3.25】 CR文档](https://wepie.feishu.cn/wiki/aaa)
技术方案：[法A-命运之轮集合页【3.16-3.22】玩法页【3.19-3.25】 技术方案](https://wepie.feishu.cn/wiki/bbb)
发布计划：[法A-命运之轮集合页【3.16-3.22】玩法页【3.19-3.25】 发布计划](https://wepie.feishu.cn/wiki/ccc)

注意：不要输出其他多余信息，只输出以上四行。

失败时： 根据错误信息提供解决方案：

环境变量未设置 → 提示设置 FEISHU_APP_ID / FEISHU_APP_SECRET
权限不足 → 提示检查飞书应用的知识库读写权限
节点不存在 → 提示检查父节点链接是否正确

模板内容说明

CR 文档模板

包含以下结构：

活动玩法说明（含需求文档链接、MR、发布计划链接）
重点关注逻辑
CR 额外关注点（接口参数校验、发奖逻辑、锁使用）
修改点（测试回归勾选）

技术方案模板

包含以下结构：

活动文档（含需求文档链接）
方案标准（存储、安全、性能、数据量、问题查询）
活动玩法
涉及服务（Http/Tcp 服务勾选列表）
涉及区服
功能拆分
自测要点
联调文档
估时说明

发布计划模板

包含以下结构：

活动玩法说明（含需求文档、技术方案链接）
代码 CR（含 CR 文档链接）
涉及区服及服务
配置检查（活动配置、计费点、礼盒、盲盒、礼包等）
数据变更说明
灰度策略
线上体验&观察
活动下线

注意事项

环境要求

Python 3.6+
已安装 requests：pip install requests
已设置飞书 API 凭证

权限要求

飞书应用需要以下权限：

wiki:wiki:readonly - 读取知识库节点信息
wiki:wiki - 创建知识库节点
docx:document - 创建文档内容块

使用场景示例

场景 1：给链接直接创建

用户：创建文档 https://wepie.feishu.cn/wiki/xxx
→ 脚本自动提取需求名称，在默认目标目录下找到/创建 2026/Q1 目录，创建三个文档

场景 2：先说意图再给链接

用户：帮我创建文档三件套
AI：请提供需求文档链接
用户：https://wepie.feishu.cn/wiki/xxx
→ 直接执行

场景 3：需要更换目标目录

→ 修改脚本顶部 DEFAULT_CR_ROOT / DEFAULT_TECH_ROOT / DEFAULT_PLAN_ROOT 常量