| name | baklib-release-note |
| description | Baklib 专用:根据 CHANGELOG/更新说明撰写面向用户的对外发布日志(Markdown 正文 + 封面图提示词), 用于 release.baklib.cn 等站点页;含标题规范、help.baklib.cn/术语表内链、DaisyUI baklib 品牌与 Liquid Glass 封面。 在用户要写 Baklib 发布日志、release note、版本更新文章、或从 CHANGELOG 生成对外稿时使用;出图与 MCP 写入须先确认。 |
Baklib 发布日志撰写(baklib-release-note)
将内部或工程向的更新说明(如 CHANGELOG.md、发版说明、PR 摘要)改写成面向终端用户的对外发布文章,发布目标通常为 Baklib 发布日志站点(示例:Baklib CLI v0.1.0)。
技能范围
| 负责 | 不负责 |
|---|
| 提炼发布要点、拟定页面标题与正文结构(Markdown) | 代替产品/法务做对外承诺或合规审校 |
| 按规范撰写封面图英文提示词,并路由到提示词/出图子技能 | 在未确认时调用计费图像 API |
| 匹配 帮助中心索引 与 术语表 并建议内链 | 未确认时通过 MCP 写入线上站点 |
| 输出可直接粘贴到 Baklib 页面编辑器的稿面 | 编造未在源 CHANGELOG 中出现的功能 |
执行前确认(强制)
收到任务后先用编号列出拟执行步骤,并等待用户明确同意后再继续(分析与起草正文可默认进行,除非用户只要提纲):
- 输入源:CHANGELOG 路径、粘贴正文,或版本/tag 说明。
- 发布上下文(可选):产品名、版本号、发布日期(默认用源文档日期或用户指定)。
- 封面图:仅输出提示词,还是调用出图 API(须单独确认;涉及密钥与费用)。
- 发布方式:仅本地 Markdown 文件,还是 Baklib MCP 写入(写入须遵守 baklib-mcp 的确认约定)。
未确认前:不得调用计费出图、不得 MCP 写入。
工作流
源 CHANGELOG → 提炼关键词与章节 → 封面提示词 →(可选)出图 → 正文 Markdown →(可选)站点发布
步骤 1:阅读源材料
- 区分 用户可见 与 仅工程/运维 条目;对外稿只写前者,或把后者改写成用户能感知的收益。
- 记录:版本号、发布日期、3–8 个核心关键词(用于标题与封面)。
- 标出须原文保留的命令、配置项、环境变量、包名、API 路径。
步骤 2:拟定页面标题
标题须同时满足 可搜索 与 一眼看懂本次发布:
{YYYY-MM-DD} 发布更新 - {产品/功能名} {版本或一句话亮点}
示例:2026-05-18 发布更新 - Baklib CLI v0.1.0 正式发布
规则见 references/article-structure.md。
步骤 3:撰写封面图提示词
- 从步骤 1 的关键词生成词云式 / 关键词卡片式封面构思(非真实数据图表)。
- 视觉:Baklib 青橙品牌 + Liquid Glass(液态玻璃) 毛玻璃面板、大圆角、柔和阴影;配色严格遵循 references/brand-palette.md(DaisyUI
baklib 主题)。
- 按 references/cover-image-prompt.md 填充分步英文提示词(Step 1–9)。
- 交给子技能(勿在本技能内重复长篇提示词写法):
- 推荐画幅:16:9 或 3:2 横图,适合发布日志头图;图内主标题英文或中文与页面标题一致或略短。
步骤 4:撰写正文(Markdown)
结构、语气与示例见 references/article-structure.md。要点:
步骤 5:交付物
向用户交付(路径由用户指定或协商,例如工作区 output/release-notes/):
| 文件 | 内容 |
|---|
{slug}-release-note.md | 完整正文(含建议的页面标题作为文首 H1 或元数据说明) |
{slug}-cover-prompt.txt | 封面图分步英文提示词 |
{slug}-cover.png | 仅当用户确认并已通过出图子技能生成 |
在回复中摘要:标题、章节列表、已添加的内链、封面关键词。
与其它技能的关系
- requirements-to-published-content:更长营销流水线;本技能专注版本发布日志体裁。
- nano-banana-pro-prompting / image-generation-*:封面图;本技能只产出提示词并触发子技能。
- baklib-mcp + baklib-bke-markdown:可选发布到 Baklib 站点页。
参考