Agent Skills
› SisyphusSQ/harness-template
› project-version-release
project-version-release
GitHub用于项目版本、CHANGELOG和发布策略的维护。区分issue与release粒度，支持变更分类及dry-run检查，确保SemVer规范及安全的发布流程管理。
Trigger Scenarios
更新项目版本号或CHANGELOG
执行release归档或策略规划
Install
npx skills add SisyphusSQ/harness-template --skill project-version-release -g -y
SKILL.md
Frontmatter
{
"name": "project-version-release",
"description": "当维护项目版本、CHANGELOG、release archive 或发布策略说明时使用；用于区分 issue 执行粒度和 release 发布粒度，并保证写入默认 dry-run。"
}
Project Version Release
用于项目内版本、CHANGELOG 和 release policy 的通用维护。
核心规则：issue 是执行粒度，release 是发布粒度。不要因为一个 issue 完成就自动提升 release version。
第一步
- 先读取根级
AGENTS.md和项目 release 文档； - 写文件前先判断本次变更属于哪一类；
- 先用 dry-run 跑检查：
python3 .agents/skills/project-version-release/scripts/project_version_release.py check \
--repo "$PWD" --json
先分类再变更
| 分类 | 含义 |
|---|---|
issue-only |
只更新 issue / run summary，不提升 release version。 |
changelog-only |
只追加到 CHANGELOG.md -> Unreleased，不归档 release。 |
version-bump |
项目版本文件发生变化，需要显式版本号和验证入口。 |
release-archive |
正在发布 artifact，需要把 Unreleased 归档为真实 release 段。 |
policy-plan |
release policy 需要操作计划；本 skill 只输出 operator intent。 |
python3 .agents/skills/project-version-release/scripts/project_version_release.py classify \
--repo "$PWD" \
--changed-files <文件路径...> --json
写入规则
- 脚本默认 dry-run；
- 只有目标动作明确后才添加
--write； - 脚本不得执行
git push、修改 Issue provider、连接数据库、上传对象存储或发布 artifact； CHANGELOG.md使用Unreleased + release archive模式；- 用户未明确指定版本号时，不得自行创建版本号；
- stable / beta / dev 版本都必须使用合法 SemVer 字符串。
涉及 release 边界、channel policy、兼容性或外部发布流程时，读取 references/project-version-policy.md。
Version History
- 838b539 Current 2026-08-27 17:13
- e3799d0 2026-07-24 12:23
