开发工具CLI机器学习【免费下载链接】huggingface_hubThe official CLI and Python client for the Hugging Face Hub.项目地址https://gitcode.com/gh_mirrors/hu/huggingface_hub点击查看免费下载本篇技术指南聚焦 huggingface_hub 仓库内置的.opencode技能hf-release-notes:slack定义于 SLACK.md它负责把已经起草好的 Release Notes 压缩成一段面向内部团队、用于征集预发布prerelease测试的 Slack 公告消息。读完本文你将掌握该技能的消息正文结构问候语 → Release Notes 链接 → Highlights → Breaking changes、Highlights 内容筛选规则、Slack 格式化约束以及它与调用脚本 generate_slack_message.py 之间技能只写正文、脚本追加 Ping 段落的分工机制。一、这个技能解决什么问题在huggingface_hub的发布流程中每次推出预发布版本如v1.7.0.rc0时团队需要在 Slack 频道内向内部同事公告新版本并邀请下游维护者进行回归测试。但完整 Release Notes 往往包含大量细节PR 归属、代码示例、CI 与内部改动、文档更新等直接全文转发既冗长又不适合团队沟通场景。hf-release-notes:slack技能由 SLACK.md 定义解决的就是这一需求基于已有的 Release Notes 生成一段简明、友好、面向内部团队的 Slack 公告正文。其技能描述frontmatter明确写道name: hf-release-notes:slack description: Generate a concise Slack announcement message from drafted release notes. Use when asked to create a Slack post for a huggingface_hub prerelease.该技能最关键的边界约束是它只生成消息正文从问候语到 Breaking changes 行为止。Ping: 段落和结尾行由调用脚本追加技能本身绝不能生成这两部分。这一分工在 SLACK.md 的 Overview 中被明确强调。二、技能所属的完整发布自动化家族SLACK.md并非孤立文件它是.opencode/skills/hf-release-notes/目录下技能族的一部分文件职责SKILL.md主技能从缓存的 PR JSONoutput_dir/tmp/pr_*.json生成完整 Release NotesRELEASE_NOTES_version.mdSLACK.md子技能把已生成的 Release Notes 压缩为 Slack 公告正文VALIDATE.md子技能校验 Release Notes 与 manifest 完全一致补缺失 PR、删多余 PRreferences/release-notes-template.mdRelease Notes 骨架结构含各类 emoji 分节references/slack-post-template.mdSlack 公告模板结构与历史真实消息示例references/sections.md基于关键词的 PR 分节启发式规则在仓库侧的配套脚本中generate_release_notes.py 负责调用主技能产出 Release Notesgenerate_slack_message.py 负责调用hf-release-notes:slack技能并追加 Ping 段落validate_notes.py 对应校验逻辑。三者与三个技能文件一一对应共同构成从 PR 数据到发布沟通消息的自动化管线。三、工作流总览五步生成公告正文SLACK.md 将生成过程组织为五个明确步骤1. 读取输入Read inputs提示词中会指定三个参数Version基础发布版本号如v1.7.0Release notes path完整 Release Notes Markdown 文件的路径Output pathSlack 消息的写出位置先完整阅读 Release Notes 文件理解本次发布包含哪些内容这是后续压缩与筛选的前提。2. 阅读参考示例Read reference examples读取references/slack-post-template.md即仓库内 slack-post-template.md。该文件包含模板结构以及历史上真实发布的 Slack 消息用于校准语气tone、排版formatting和信息密度level of detail要求与既有风格高度一致。3. 生成消息Generate the message按固定顺序写出消息正文的四个部分问候语 → Release Notes 链接 → Highlights → Breaking changes详见下一节。4. 应用格式规则Formatting rules遵守 Slack 排版约束详见第六节。5. 写出输出Write output只把消息正文写入指定输出路径在 Breaking changes 行之后停止不包含pip 安装命令、Ping: 段、Let us know if you spot any regressions... 结尾行以及任何分隔线。四、消息正文结构详解SLACK.md 规定了消息正文必须按以下顺序包含四个部分4.1 问候语Greeting固定格式为Hello channel :hello: Release ... is on its way!直接channel全频道广播Hello channel :hello: Release huggingface_hub vX.Y.Z is on its way!注意版本号用反引号包裹便于 Slack 中作为代码片段高亮显示。4.2 Release Notes 链接Release notes link紧随问候语给出指向该版本 GitHub Releases 标签页的链接技能文档中示意为https://github.com/huggingface/huggingface_hub/releases/tag/vX.Y.Z实际链接由调用方按版本拼装Release notes :point_right: release-tag-url该行让关心完整变更的同事能一键跳转到完整 Release Notes。4.3 Highlights 要点Highlights这是正文中最核心、也最考验压缩能力的部分结构为加粗标题加无序列表**Highlights:** - **[Feature name]** 1 sentence summary of the feature. - **[Another feature]** brief description.Highlights 必须遵守一组严格的筛选规则详见第五节。4.4 Breaking changes破坏性变更如果存在破坏性变更使用:warning:表情前缀:warning: Breaking changes: brief description of what changed.如果本次发布没有破坏性变更则输出固定句No breaking changes in this release.Breaking changes 行是整个消息正文的最后一行——技能在写出输出时严格在此停止。五、Highlights 内容筛选规则压缩而不失重点SLACK.md 为 Highlights 部分规定了六条硬性规则这些规则决定了什么能上公告、什么必须砍掉每条 12 句越短越好——这是摘要而非完整 Release Notes甚至不必是一个完整句子删除所有 PR 归属行by author in #1234一律去掉删除所有代码示例与代码块删除内部/CI/测试类改动删除纯文档类改动删除 bug 修复不列入 Highlights将相关的小改进合并成一条而不是逐条罗列。这套规则与主技能 SKILL.md 中的高亮判定highlight标签或显著功能/UX 改进形成互补SKILL.md 负责在完整 Release Notes 中挑选值得展开的重点而 SLACK.md 负责把这些重点再压缩成一句话级别的摘要。同时sections.md 中的分节启发式如 Breaking Change匹配 breaking/deprecated/remove️ Internal匹配 CI/tests/refactor也为判断该不该出现在公告里提供了分类依据——内部、文档、bug 类条目正是被明确排除在 Highlights 之外的类别。六、Slack 格式规范四条硬约束由于目标是直接粘贴进 SlackSLACK.md 明确规定了四条格式约束不使用 Markdown 标题##、###——Slack 不渲染这些语法命令名与代码用反引号包裹如hf extensions install保持非正式友好的语气——这是团队内部沟通不是正式 changelog输出末尾不留尾随换行。这些约束直接决定了消息的最终形态纯文本段落 加粗 反引号 Slack 表情而不是一套 Markdown 文档结构。七、参考模板references/slack-post-template.md技能生成时必须参考 slack-post-template.md其中给出的模板结构如下Hello channel :hello: Release huggingface_hub vX.Y.Z is on its way! Release notes :point_right: release-tag-url **Highlights:** - **[Feature name]** 1 sentence summary of the feature. - **[Another feature]** brief description. If breaking changes :warning: Breaking changes: brief description of what changed. If no breaking changes No breaking changes in this release.该文件同时再次强调脚本会自动追加 Ping: 段和结尾行技能只负责从问候语到 Breaking changes 行的正文。因此生成的内容必须能无缝衔接后续脚本追加部分即正文末尾Breaking changes 行之后可直接拼接空行与 Ping 段。八、与调用脚本的分工generate_slack_message.py技能的实际驱动者是 generate_slack_message.py其 docstring 描述的完整流程为读取生成的 Release Notes Markdown调用 OpenCode 技能将其总结为 Slack 格式消息追加带 CI 链接的确定性 Ping 段将最终消息输出到.release-notes/。8.1 技能调用方式脚本通过opencodeCLI 触发技能构造的提示词为Run the hf-release-notes:slack skill. Generate a Slack announcement message for version {version}. Read the release notes from {input_file}. Write the message body to {output_file}. Do NOT include the Ping section or closing line — those are appended by the script.其中{version}、{input_file}、{output_file}会被实际参数替换且提示词显式重申不要包含 Ping 段和结尾行。模型可通过环境变量RELEASE_NOTES_MODEL指定脚本会在开始前用check_opencode_model定义于 opencode.py验证该模型是否有效——因为 OpenCode 对未知模型会以 0 退出若不提前校验一个拼写错误会静默产生空的 Slack 消息。8.2 Ping 段与结尾行的自动追加技能只生成正文写入_slack_body_{version}.md中间文件脚本随后通过build_ping_section(rc_version)追加 Ping 段。该段落针对固定的一组下游仓库DEFAULT_PING_LISTtransformers、datasets、diffusers、sentence-transformers为每个仓库生成一条 CI 对比链接Ping: - transformers compare-url - datasets compare-url - diffusers compare-url - sentence-transformers compare-url对比链接的格式为https://github.com/huggingface/{repo}/compare/main...ci-test-huggingface-hub-{rc_version}-release其中{rc_version}是完整的 RC 版本号如1.7.0.rc0。结尾行固定为Let us know if you spot any regressions! Release should be happening pretty soon :hugging_face:最终消息由body \n\n ping_section \n拼接而成写至默认输出路径OUTPUT_DIR/SLACK_MESSAGE_{version}.mdOUTPUT_DIR默认.release-notes可用环境变量RELEASE_NOTES_OUTPUT_DIR覆盖。8.3 典型命令用法# 标准用法为 v1.7.0 预发布生成 Slack 消息 python -m utils.release_notes.generate_slack_message --version v1.7.0 --rc-version 1.7.0.rc0 # 自定义输入/输出路径 python -m utils.release_notes.generate_slack_message \ --version v1.7.0 --rc-version 1.7.0.rc0 \ --input .release-notes/RELEASE_NOTES_v1.7.0.md \ --output slack_message.md输入文件默认通过 validate_notes.py 中的find_release_notes_file(version)自动探测预期位于OUTPUT_DIR/RELEASE_NOTES_{version}.md输出默认写入OUTPUT_DIR/SLACK_MESSAGE_{version}.md。脚本运行结束后会把完整消息同时打印到 stdout方便复制到 Slack。九、与整体发布流程的衔接这条 Slack 生成管线是整个 huggingface_hub 发布流程的末端一环。完整的发布链路为拉取 PR 数据主技能 SKILL.md 读取output_dir/tmp/pr_*.json每个文件含 PR 号、标题、作者、合并时间、标签、正文及doc_diffs文档 diff由 fetch_prs.py 等脚本准备这些缓存文件生成 Release Notes按 release-notes-template.md 的结构输出RELEASE_NOTES_version.md每个条目带by author in #1234归属校验VALIDATE.md 确保所有 PR 恰好出现一次、无跨发布的多余 PR对应仓库脚本 validate_notes.py生成 Slack 公告本指南主角 SLACK.md 将 Release Notes 压缩为公告正文由 generate_slack_message.py 追加 Ping 段。而实际发版动作更新__version__、构建 conda/pip 包、打 tag、推进版本号至.dev0则遵循 docs/dev/release.md 中记录的标准流程本技能生成的公告正是在该流程完成预发布构建后向内部团队通报并征集测试的沟通环节。十、完整输出示例综合 SLACK.md、slack-post-template.md 与脚本的拼接逻辑一次完整生成最终落盘的消息形态如下以v1.7.0预发布为例功能名以占位符示意Hello channel :hello: Release huggingface_hub v1.7.0 is on its way! Release notes :point_right: release-tag-url **Highlights:** - **[Feature name]** 1 sentence summary of the feature. - **[Another feature]** brief description. No breaking changes in this release. Ping: - transformers compare-url - datasets compare-url - diffusers compare-url - sentence-transformers compare-url Let us know if you spot any regressions! Release should be happening pretty soon :hugging_face:其中第一段问候语到No breaking changes in this release.由技能生成并严格止步于此其后空行、Ping:段与结尾行全部由 generate_slack_message.py 脚本自动追加。若本次发布存在破坏性变更则正文末行替换为:warning: Breaking changes: brief description of what changed.。十一、使用要点小结边界意识技能永远只写正文Ping 段与结尾行是脚本的职责二者不能越界否则脚本拼接时会产生重复或格式错乱压缩优先Highlights 是一句话摘要而非小 changelogPR 归属、代码示例、CI/测试、纯文档、bug 修复一律不进入公告相关小改进应合并表述Slack 优先不用 Markdown 标题、代码用反引号、语气非正式、末尾不留尾随换行版本一致性脚本的--version用于定位 Release Notes 与命名输出和--rc-version用于拼装 Ping 段的 CI 分支名是两个不同参数例如--version v1.7.0 --rc-version 1.7.0.rc0前者是基础版本后者是完整 RC 版本不可混淆。赞分享开发工具CLI机器学习【免费下载链接】huggingface_hubThe official CLI and Python client for the Hugging Face Hub.项目地址https://gitcode.com/gh_mirrors/hu/huggingface_hub点击查看免费下载相关推荐Langfuse Slack集成团队协作通知Langfuse Slack集成团队协作通知 概述 在LLM应用开发过程中实时监控和团队协作至关重要。Langfuse的Slack集成功能让开发团队能够直接人工智能LLMOps可观测性AI 评测LLM 网关后端前端OpenSEO 版本发布笔记Release Notes工作流从 pnpm release:notes 到 GitHub Releases 的完整指南OpenSEO 版本发布笔记Release Notes工作流从 pnpm release:notes 到 GitHub Releases 的完整指南 Op后端前端MCP 服务数据分析WVP-PRO 怎么跑出第一路画面GB28181 平台部署与国标级联的新手避坑指南WVP PRO 怎么跑出第一路画面GB28181 平台部署与国标级联的新手避坑指南 今天的活是这样的把园区几十台海康、大华、宇视的摄像头接到一个平台里统一管开发工具CLI机器学习上一篇Open Source Guides 中的“启动开源项目”全攻略从许可证、README 到品牌与上线清单下一篇react-admin 软删除回收站列表useDeletedRecordsListController 无头 Hook 完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考