SuperAPI AI 工具集

product-changelog

通用与其它

查看项目

更新于 10-15 22:37

技能介绍

用途:为产品更新日志(changelog)和发布说明(release notes)提供写作规范,目标是让用户看得懂、愿意读。通过 inference.sh CLI 使用。

主要能力与用法: 写作结构:分类标签 → 面向用户的标题 → 现在能做什么 → 怎么做 → 有何变化 → 配图。 面向用户措辞:写用户能做什么而非内部实现了什么,用现在时,以“You can now…”等开头,包含收益;避免内部术语、PR 编号、工单号。 分类:New(新功能)、Improved(改进)、Fixed(修复)、Removed(移除)、Security(安全)。规则要求区分 New/Improved/Fixed,避免无意义的“Updated”。 版本号:支持语义化版本 MAJOR.MINOR.PATCH(破坏性变更、向后兼容新功能、修复)及日期式版本(如 2026-02-08)。 页面结构:按日期分组,逐条列出。 配图:新 UI 用截图,改版用前后对比,新流程用分步截图或短视频,性能提升用图表,复杂功能用动图或视频;并给出生成配图的 infsh 命令,例如: infsh app run falai/flux-dev-lora --input '{"prompt": "...", "width": 1248, "height": 832}' infsh app run infsh/agent-browser --input '{"url": "...", "action": "screenshot"}' infsh app run infsh/stitch-images --input '{"images": [...], "direction": "horizontal"}' infsh app run bytedance/seededit-3-0-i2i --input '{"prompt": "...", "image": "screenshot.png"}'

破坏性变更:需说明变更内容、用户需要做什么、迁移时间线,并给出显眼警告与支持联系方式。 分发渠道:更新日志页(每次发布)、应用内通知(1-2 行)、邮件(精选亮点、重大版本)、博客(深度介绍)、社交媒体(单功能亮点)、Slack/Discord(社区简要公告)。

适用场景:SaaS 持续部署(按周汇总)、有版本号的软件(随 semver)、API(含弃用与迁移指南)、移动应用(随商店更新说明)。

限制与注意事项:资料未提供具体平台、收费或价格信息。写作时应避免“various bug fixes”这类空泛表述,不要列无人关心的依赖升级或内部重构,不要直接提交日志,破坏性变更不可埋没。