Communitygithub.com

karolinakita-ux/portfolio

将 develop 分支发布到 main(生产环境):编写发布说明、合并、打标签、推送,并检查 Netlify 生产环境部署。仅在 Karolina 要求发布时运行。

portfolio 是什么?

这是一个用于将 `develop` 分支发布到 `main` 分支(生产环境)的 AI Agent 技能。它完整地自动化了从确认要发布的变更内容、编写发布说明、合并与打标签、到检查 Netlify 生产环境部署状态的整个流程。该技能特别针对个人博客/作品集网站 `karolina.kita.company` 设计,遵循 `CONTRIBUTING.md` 中定义的严格发布规范。它支持在任何代码编辑或终端环境中执行,通过一系列有序的步骤确保发布过程的准确性和一致性。使用时,AI Agent 会按照给定的步骤依次执行,并在遇到失败、缺少变更日志条目等异常情况时主动询问用户,不会擅自执行 stash、reset 等危险操作。该技能要求用户仅按文件名暂存文件,禁止使用 `git add -A`。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/karolinakita-ux/portfolio/tree/HEAD/.claude/skills/release

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

将 develop 发布到 main

一次发布会将 develop 上等待的所有内容上线到 karolina.kita.company。完整流程和发布说明规则在 CONTRIBUTING.md(“发布”)中;请逐步遵循。

  1. 检查发布内容。 在 develop 分支上:执行 git fetch origin、git pull --ff-only、yarn verify。显示 git log --oneline origin/main..develop 以及 ## Unreleased 条目。如果验证失败、某个提交没有变更日志条目、或 origin/main 包含 develop 所没有的提交,则停止并询问。
  2. 编写发布说明,放在重命名的标题 ## Release vX.Y.Z - YYYY-MM-DD(今天,ISO 格式)下。版本号是 ## Unreleased 下的最新版本,该版本与 package.json 中的版本一致。此次发布本身不进行版本更新。发布说明面向访问者和招聘方:2 到 6 个要点,使用简单的 B2 级别英语,短横线列表,以 Versions: a - b. 结尾。
  3. 合并、打标签并推送,严格按照 CONTRIBUTING.md 中的说明:仅提交 CHANGELOG.md,提交信息为 Release vX.Y.Z;将 develop 合并到 main(使用 --no-ff);创建附带注释的标签 vX.Y.Z;推送 main 及标签;将 develop 快进到 main 并推送。
  4. 检查部署:使用 Netlify MCP(项目 karolina-kita):生产环境部署的 commit_ref 应是此次发布合并的提交,其状态应为 ready。如果部署失败,读取部署日志并报告。然后从线上站点获取一个此发布修改过的页面。
  5. 回复:包括版本号、按撰写内容发布的说明以及部署结果。

规则:

  • 未提交的用户编辑内容不得纳入发布。如果因为未提交的编辑导致 git switch 拒绝,则停止并询问;切勿 stash、reset 或丢弃它们。
  • 通过文件名暂存文件;切勿使用 git add -A。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能