用途:审校 Altimate Platform 更新日志(https://altimate.ai/changelog)的草稿条目。CI 只能拦截违反 schema 或托管规则的内容,无法判断语气、风格以及条目是否真正传达用户价值,这项技能负责后者。
输入:用户可提供条目文件路径(如 entries/2026-05-13-feature.md),或直接粘贴草稿(frontmatter 加正文)。两者都没有时,需先询问要润色哪一条。
使用前需按顺序阅读:STYLE.md(语气、标签指引、正反例)、products.yml(产品 slug 与允许的嵌入主机白名单)、README.md(frontmatter 字段 schema)。若无法读取这些文件,应请用户指明仓库根目录或粘贴 STYLE.md。
检查项:frontmatter 方面,title 不超过 80 字符、句首大写、点明功能而非描述句子;date 为 YYYY-MM-DD 且与文件名一致;products 为非空且来自 products.yml 的 slug 列表;emoji 为单个且贴合功能类别;tag 若设置须为 new、improved、beta 之一;hero 若设置须为 HTTPS 且主机在 allowed_hosts 内。正文方面,一段或至多两段短段落,超过 400 词会被 CI 拒绝;以用户收益开头而非实现细节;主动语态、现在时;不得出现 Jira 编号(如 AI-1234)、Slack 链接、项目代号、团队名、“we're excited to announce”式措辞或营销最高级;不得使用原始 HTML 或 script、iframe 等;链接须为 HTTPS 且主机在白名单内;图片须有非空 alt 文本;正文不得以 Markdown 标题开头。
回应方式:先给一句话结论;再列关键问题(问题、原因、具体修改建议,并引用 STYLE.md 规则);随后在代码块中给出完整润色稿(frontmatter 加正文),保留作者语气;再用三到六条说明改动及对应规则;最后询问是否写入文件,用户同意才用 Write 工具覆盖。
限制:无法验证的声明(如百分比提升)应标记并请工程师提供来源;多产品标签但正文只提一个时需确认;营销式文案应剥离并替换为具体行为变化。回应语气应与更新日志一致:直接、具体、不夸张。