SuperAPI AI 工具集

generating-release-content

智能体与模型

查看项目

更新于 10-15 20:09

技能介绍

用途:为 Releases 注册表中的单条、一个时间窗口或整批发布记录补齐四个 AI 生成字段——title_generated(60–90 字符的独立新闻标题,硬上限 100)、title_short(Axios 风格短标题)、summary(1–2 句摘要)、composition(bugs/features/enhancements 计数)。首次生成与提示词变更后重写走同一条管线,最后一次写入生效。

主要能力与用法:系统提示词与解析规则位于 packages/ai/src/release-content.ts,需直接读取,不要改写进用户消息;从该文件导入 SYSTEM_PROMPT、buildReleaseBlock、isEmptyContent、parseReleaseContent。生产提示词还会输出 <breaking> 与 <migration>,但本技能的写入路径(PATCH /v1/releases/:id 与批量脚本)不接收这两项,解析后丢弃即可。

执行按候选数量分三种模式:1–10 条用内联模式,调用 summarizeRelease,走生产代码路径(OpenRouter DeepSeek Flash,Anthropic Haiku 为兜底);10–200 条派发并行子智能体(每批最多 10 条,Sonnet,最多 10 个并行),子智能体只返回结构化字段、由父级写入;200 条以上改用回填脚本。写入命令为 releases admin release update <id>,支持 --title-generated、--title-short、--summary,空字符串写 NULL;composition 仅能通过 API 写入,使用 curl -fsS -X PATCH 传 JSON。

适用场景:新组织开启自动生成前后的补写、提示词迭代(5–20 条小样本对比)、供应商/模型对比、摄取异常后的修补。

限制:超过 200 条优先用 bun scripts/generate-release-content.ts --orgs=… --since=… --apply(默认 OpenRouter DeepSeek Flash,可加 --anthropic-batch)。空正文由 isEmptyContent 短路,写入四个 NULL,避免模型幻觉。畸形 XML 会返回空字符串,写入前需转成 null。输出被 max_tokens 截断时先写已有字段、composition 传 null。标题超 100 字符需截断或重试。工具失败时应上报而非绕过写路径。提示词以代码中版本为准,本技能不维护副本。