一、用途 该技能用于为 Basic Memory 生成仓库视觉图像,覆盖 PR、changelog、release 与双周回顾(2-Week Retro)等场景。文件与标记名仍沿用“infographic”以保持兼容,但 PR 生成以图像为先,可表现为场景、海报、绘画、照片、封面、画面等编辑性视觉。PR 图像是 BM Bossbot 的非门禁产物;changelog 与 release 摘要图像属于手动证据包工作流。
二、输出约定 基础目录为 docs/assets/infographics/。PR 图像:docs/assets/infographics/pr-<number>.webp;changelog 图像:docs/assets/infographics/changelog.webp;周报图像:同一年为 docs/assets/infographics/<year>-w<start-week>-w<end-week>.webp,跨年为 docs/assets/infographics/<start-year>-w<start-week>-<end-year>-w<end-week>.webp。周报窗口固定为上一 ISO 周至当前 ISO 周。
三、PR 模式 以 BM Bossbot 摘要块为素材,不得手写 PR 正文中不存在的声明。获取 PR 正文:gh pr view <number> --json body --jq '.body // ""' > /tmp/bm-pr-body.md。生成资产:uv run --script scripts/generate_pr_infographic.py --pr-number <number> --pr-body-file /tmp/bm-pr-body.md --theme "<optional visual theme>" --provenance-output /tmp/bm-infographic-provenance.md --output docs/assets/infographics/pr-<number>.webp。可用 --print-prompt 或等价的 --dry-run 在调用图像模型前本地测试提示,不调用 OpenAI。若 PR 正文含托管主题块(BM_INFOGRAPHIC_THEME 标记),脚本自动读取;未提供主题时按 PR 编号与摘要从风格池中确定性选择视觉方向。图像生成后可用 --provenance-output 写出溯源块(BM_INFOGRAPHIC_PROVENANCE 标记),记录资产路径、模型、尺寸、质量、模式、主题来源等,仅作调试与创作溯源,不是合并门禁。
四、Changelog 模式 先构建证据包:合并 PR diff/合并提交/本地重建 diff、git diff --stat 与关键文件、影响台账、丢弃清单(误导标题、回滚工作、仅重命名、推测性 TODO)、选定图像形式与唯一 BM 风格类别。撰写提示前阅读 references/prompt-blueprint.md 与 references/style-balance.md,并读取当前 CHANGELOG.md 条目。
五、风格选择 每条图像只选一个 BM 类别,不混合。类别池包括计算机教材、经典文学、奇幻/D&D、音乐、科幻、剑与魔法、美漫、法国新浪潮、二战宣传海报、意大利电影海报、莎士比亚、希腊神话、黑色侦探板、NASA 任务控制、太空探索、绘画、黑白摄影、80 年代动作片、炼金手稿、粗野主义城市规划等。禁止使用受版权保护的角色、标志或具名虚构宇宙;部分类别有明确禁忌(如真实政党符号、仇恨图像、非人化口号、真实历史虚假声明、直接乐队标志/专辑封面/音乐人肖像等)。未提供主题时脚本按 PR 编号与摘要确定性选择。
六、生成与质量 将最终提示写入临时 markdown 文件后,用共享图像助手生成:uv run --script scripts/generate_infographic.py --prompt-file /tmp/bm-infographic-prompt.md --output docs/assets/infographics/<name>.webp。生成后须验证图像存在且可读。质量要求:讲清前后价值故事而非空泛改进,兼顾工程与非技术读者,文本标签清晰、层级明确、高对比、避免编造事实,优先已交付成果。
七、限制 合并门禁为 GitHub commit status“BM Bossbot Approval”,PR 图像仅供视觉支持;溯源块不写入完整提示。分类器、模型、价格、平台与效果等未在资料中提供。