SuperAPI AI 工具集

changelog

写作与研究

查看项目

更新于 10-16 01:57

技能介绍

用途

该技能用于把一段明确定义的变更范围转化为真实可信的发布沟通内容。它让已交付工作的数量与重要性决定条目数量、技术深度和视觉形式,而不是为了填满版面而堆砌内容。

主要能力

  • 确定范围:从请求和仓库中推断目标分支、标签区间、发布或日期窗口;判断是否排除未提交或未发布的工作;识别受众与预期技术深度;确定输出形式(散文、Markdown、HTML 卡片、图片或组合);参考既有更新日志政策、模板、视觉系统和历史示例。
  • 检查变更:优先使用仓库自带的发布工具;否则通过 git log --oneline <range>、git diff --stat <range>、git diff --name-status <range> 检查选定范围,阅读不清晰的 diff 及相关测试或文档,按用户可见行为而非提交边界分组。
  • 面向受众起草:每个条目回答“改了什么”以及“受众为何关心”;在读者需要时保留实现语言;保留产品语气与大小写;在受影响条目旁标注破坏性变更和所需操作。
  • 计算真实统计:仅在有助于说明时使用指标,并准确标注其含义。例如唯一文件数可用 git diff --name-only <range> | sort -u | wc -l,增删文本行可用 git diff --numstat <range>(需处理二进制条目)。提交数、唯一文件数或变更行数并不等同于用户价值。
  • 按需构建视觉产物:若用户要求卡片或仓库已有更新日志模板,则检查现有素材、CSS、尺寸和历史输出,保留锁定模板代码,选择与条目数量和文案长度匹配的布局,按仓库命名约定创建带日期的产物,并在目标尺寸下渲染或截图。无模板时,从仓库品牌证据推导字体、颜色和署名,不默认使用深色等宽卡片。

使用方式

技能会先建立范围,再检查变更、起草文案、计算统计、按需生成视觉产物,最后进行验证。输出契约要求交付所请求的产物,并附带:范围(提交/标签/日期与分支)、受众与渠道、发布状态(已验证上线、已发布、未发布或混合)、条目数、来源(条目对应提交或路径)、统计(定义与值,如使用)、产物(路径与尺寸)、限制(未核实的部署或内容事实)。对于仅需散文的请求,不创建 HTML;对于审计请求,除非用户同时要求编辑,否则止于发现和建议文案。

适用场景

  • 准备每周更新、发布摘要或社交内容。
  • 将 git 变更范围整理为面向不同受众的更新日志。
  • 需要按仓库模板生成带日期的可视化更新卡片。

限制

  • 不得将已合并、已提交或受功能开关控制的工作描述为已上线,除非有部署证据。
  • 范围或发布状态不明确时才询问;需在交接中记录确切范围。
  • 不得为了填充布局而增加条目;合并条目仅当它们构成一个连贯结果。
  • 统计指标必须与标签口径一致,并处理二进制文件。
  • 视觉产物需在目标尺寸下检查溢出、裁剪、对比度、层级和长条目行为。
  • 需报告部署/上线状态是直接验证还是推断得出。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。