Communitygithub.com

karolinakita-ux/portfolio

按照仓库规范提交 develop 分支上的完成变更 —— 执行 yarn verify、语义化版本号升级、更新 CHANGELOG、按文件名暂存、在主题中包含版本号、推送。每当一个变更准备就绪可提交时使用。

portfolio 是什么?

该技能定义了在 `develop` 分支上提交变更的标准化工作流,与仓库的 `CONTRIBUTING.md` 规则严格对齐。它确保每个提交对应一个版本,要求开发者按顺序执行:运行 `yarn verify`(类型检查、零警告 lint、Prettier 检查、测试、预渲染构建)、检查 Git 状态、根据变更影响决定语义版本号升级(major/minor/patch)、在 CHANGELOG.md 的 `## Unreleased` 下方添加对应条目、按文件名显式暂存文件、编写包含版本号的主题行和简短的正文,最后验证提交并通过 `git show --stat HEAD` 确认后再推送。技能还建议列出每个变更单元及其覆盖测试,对未经测试的分支强制要求补充测试。支持任何遵循此规范的仓库,尤其适合要求严格治理的软件项目。

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

在你喜欢的 AI 中提问

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

文档

在 develop 上提交一个变更

每个提交对应一个版本。规则详见 CONTRIBUTING.md(“每个提交”)的简短形式:

  1. 验证。 yarn verify(类型检查、零警告 lint、Prettier 检查、测试、预渲染构建)。修复代码,而非规则:规则异常应使用单行禁用并在 -- 后附上理由。
  2. 检查工作树。 git status。用户可能有未完成的编辑:仅列出此变更涉及的文件。其他内容保持未暂存状态。
  3. 在提交前确定版本号(读取 package.json 中的 version 以及 CHANGELOG.md 的最新条目,而非更早版本):
    • major:已删除或重命名页面、URL 变更、重新设计
    • minor:新增可见内容或功能
    • patch:修复、文案、图片、样式、依赖、配置、测试、文档
  4. 更新 CHANGELOG。 在 ## Unreleased 标题下方(若有发布则为空,应添加在最新的 ## Release 之上)添加 ### X.Y.Z - YYYY-MM-DD,并按 Added / Changed / Fixed / Removed 分组,每行一句简短描述,仅使用短横线。
  5. 提交 列出的文件:git commit -- <文件>,主题为 <变更内容,使用祈使句>(X.Y.Z),短正文,若由 Claude 编写则包含 co-author 信息。
  6. 检查提交 及其消息:git show --stat HEAD。然后推送 develop。

在提交前,列出每个变更单元(文件、函数、分支)及其对应的测试。未经过测试的分支应补充测试,或在回复中注明。

Individual skills in this repo

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

相关技能