Agent Skills › SisyphusSQ/harness-template › project-version-release

project-version-release

GitHub

维护基于约定式发版的项目版本与发布记录，支持变更分类、Unreleased管理、归档及SemVer升版。不接管原生工具或执行部署，确保版本更新符合项目规范且可追溯。

plugins/project-workflows/skills/project-version-release/SKILL.md SisyphusSQ/harness-template

Trigger Scenarios

需要更新CHANGELOG的Unreleased部分执行正式发版归档release 根据变更文件判断是否需要升版执行SemVer版本号升级

Install

npx skills add SisyphusSQ/harness-template --skill project-version-release -g -y

More Options

Non-standard path

npx skills add https://github.com/SisyphusSQ/harness-template/tree/main/plugins/project-workflows/skills/project-version-release -g -y

Use without installing

npx skills use SisyphusSQ/harness-template@project-version-release

指定 Agent (Claude Code)

npx skills add SisyphusSQ/harness-template --skill project-version-release -a claude-code -g -y

安装 repo 全部 skill

npx skills add SisyphusSQ/harness-template --all -g -y

预览 repo 内 skill

npx skills add SisyphusSQ/harness-template --list

SKILL.md

Frontmatter

{
    "name": "project-version-release",
    "description": "项目明确采用 Unreleased CHANGELOG 和纯 VERSION 文件约定时维护发布记录；不接管项目原有发版工具，不因依赖清单变化自动升版。"
}

版本与发布记录

先读取工作项目 AGENTS.md 和发布约定。当前用户指令、指定版本与已有授权优先；项目采用其它发布格式或工具时使用项目入口，不强制迁移到本技能。

SKILL_ROOT 是本次读取的 SKILL.md 所在绝对目录。脚本从实际安装目录调用，--repo 指向工作项目。

python3 "$SKILL_ROOT/scripts/project_version_release.py" check --repo "$PWD" --json
python3 "$SKILL_ROOT/scripts/project_version_release.py" classify --repo "$PWD" --changed-files <路径...> --json

classify 只给出变化提示：go.mod 不代表 release version；package.json 等清单需要查看实际版本字段，结果列在 version_review_files。不能仅凭文件名决定升版。

变更规则

Issue 完成可追加 Unreleased；只有真实发布意图才归档 release。
版本号来自用户明确指定或项目已经授权的版本策略，来源不清时询问。
changelog-add、release-archive、version-bump 支持预览，添加 --write 才写入；已有明确授权时自行完成预览和执行，不重复确认。
version-bump 只接受仓库内内容为 SemVer 的 VERSION/version.txt。package.json、pyproject.toml 等使用项目原生工具编辑。
不执行 git push、不发布产物、不连接外部系统；任务另有交付授权时使用对应发布入口。
验证范围服从项目与用户要求。开发阶段按影响验证，提交/发版收尾复用结果，不自动重新跑测试。

CHANGELOG 格式见 references/project-version-policy.md。