开发与工程 release-managementgit-branchingchangelogversioningrelease-notesfast-forward

DeepChat 版本发布助手

按项目规范准备并发布 DeepChat 版本:更新版本号与双语更新日志,管理发布分支并快速推进主分支。

FollowSkills 评估 · FSRS-2.0
不推荐
46/ 100 五分制 2.3 / 5
1 2 3 4 5 6
1信任安全10 / 25 · 2.0/5

证据显示该技能文件未包含任何恶意行为,也未请求额外权限,但其执行会修改代码仓库(更新版本号、修改CHANGELOG、创建标签和分支),属于外部影响。技能要求在某些操作前检查状态并询问用户(如标签已存在时),但未明确要求所有关键操作的用户确认,且未提供回滚机制说明。因此,权限和确认流程不完整,扣分。

2可靠稳定7 / 20 · 1.8/5

技能文件本身逻辑自洽,提供了清晰的命令序列和检查规则,但未提供测试或错误处理机制。引用文件(如release-checklist.md)提供了详细命令,但未验证其在真实环境中的可执行性。由于是静态审查,无法确认happy path是否真正可行,且错误处理不足,因此评分仅为7。

3适用触发10 / 15 · 3.3/5

技能明确描述了使用场景(发布DeepChat版本)、受众(项目维护者)、能力边界(仅处理发布相关操作)和触发条件(用户请求发布或继续发布)。虽然未明确非适用场景,但整体清晰。环境适配方面,技能支持中英文双语changelog,但核心操作依赖Git和pnpm,可在本地或CI中运行,但未涉及中国大陆网络可达性问题。因此评分10。

4规范维护10 / 15 · 3.3/5

技能文档结构良好,有概述、步骤、参考文件和示例,且包含versioning(指出从v1.0.1开始双语格式)和已知限制(如已存在标签时需询问)。但缺少明确的FAQ、依赖安装说明(假设环境已配置)以及维护责任说明。因此评分10。

5有效结果5 / 15 · 1.7/5

技能声称能完成发布流程,但静态审查无法验证其实际效果。未提供代表性输出或第三方执行证据,因此无法确认输出直接可用。边际价值可能高于手动操作,但缺乏比较基准。因此评分5。

6证据核验4 / 10 · 2.0/5

提供了详细的命令序列和流程,但未提供测试结果或第三方验证。存在CI工作流文件,但并非针对该技能,且未提供技能路径的测试。因此评分4。

证据充分度: 评估于 2026年8月7日 审查版本 4e3771b44d4f
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 该技能会修改仓库状态(更新版本、创建标签和分支),请确保在执行前有备份或回滚方案。
  • 技能文档未明确说明所有关键操作的用户确认要求,建议在实际使用前完善。
  • 技能依赖Git和pnpm,请确保环境中已正确配置。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

该技能为 DeepChat 仓库定义了完整的版本发布流程。它负责在 dev 分支更新 package.json 和 CHANGELOG.md(v1.0.1 起中英双语条目),创建或更新 release/<version> 分支,运行格式检查、i18n、lint 等发布检查,并在 PR 批准后通过快速推进主分支并打标签完成发布。技能还处理常见的恢复场景,例如在发布分支已存在但标签尚未创建时继续发布。

该技能会读取当前 git 状态,检查 release/<version> 分支和 v<version> 标签是否存在;在 dev 分支更新 package.json 和 CHANGELOG.md,并按中英双语格式(英文在前)添加更新日志;运行 pnpm run format、i18n、lint,并在发布分支前可选运行 typecheck;根据用户请求创建或更新 release/<version> 分支;在发布 PR 批准后,使用 pnpm run release:ff -- release/<version> --tag v<version> 快速推进 main 分支并创建标签,然后删除临时发布分支;处理标签未创建或更新日志修复等恢复场景。

  1. 维护者需要准备新版本(如 v1.0.2)的版本号和更新日志
  2. 发布流程进行到一半,release 分支已存在但标签尚未创建,需要继续完成发布
  3. 需要按项目流程创建并推送 release/v1.0.3 发布分支
  4. 发布前需要运行格式检查、i18n 和 lint 等检查,确保代码质量
  5. 发布 PR 获批后,需要快速推进 main 分支并创建版本标签

这个 Skill 有哪些优点和局限?

优点
  • 明确的分步发布流程,从元数据准备到分支管理再到最终发布
  • 与仓库特定命令集成,如 pnpm run release:ff,确保符合项目规范
  • 包含双语更新日志格式,v1.0.1 起英文在前中文在后
  • 提供常见恢复场景的具体指导,如分支已存在但标签未创建
  • 强制使用 release 分支策略,避免直接在 main 上合并
局限
  • 仅针对 DeepChat 仓库,不适合通用项目(依赖特定命令和路径)
  • 需要熟悉仓库的发布策略(如快速推进而非合并)
  • 未提及自动化测试,除非用户要求或改动涉及行为变更
  • 需要预先配置 pnpm 和 git 环境

如何安装这个 Skill?

此技能已包含在 DeepChat 仓库中,路径为 .agents/skills/deepchat-release/SKILL.md。安装整个技能集合:克隆仓库,并将 .agents/skills 文件夹复制到你的 Agent 工作区,或直接将 deepchat-release 文件夹放入相应位置。

如何使用这个 Skill?

在支持 Agent Skills 的客户端中启用 deepchat-release 技能,然后使用类似以下请求触发:"准备发布 1.0.2,更新版本号和 changelog" 或 "继续发 1.0.1,release 分支已经有了,还没打 tag"。技能会指导你完成各步骤,并可能要求确认 git 状态。

这个 Skill 与同类方案有什么区别?

未提及具体替代方案。

常见问题

这个技能适用于其他项目吗?
不适用。它基于 DeepChat 仓库的特定命令(如 pnpm run release:ff)、路径和流程,因此只在该仓库或其克隆中有效。
发布分支已存在但标签未创建怎么办?
技能提供了恢复流程:在 dev 上提交修复并推送,将 release/<version> 移动到新的 dev 提交,强制推送(--force-with-lease),更新 PR,批准后发布并创建标签。
这个技能会运行哪些检查?
它运行 pnpm run format、pnpm run i18n 和 pnpm run lint;在分支前可选运行 typecheck;测试仅在用户要求或变更涉及行为时运行。
需要什么权限?
需要 git 仓库的读写权限(推送 dev、release 分支和标签),以及运行 pnpm 命令的能力。

同仓库的其他 Skills

均来自 ThinkInAIXYZ/deepchat

相关 Skills