القائمة
当维护项目版本、CHANGELOG、release archive 或发布策略说明时使用；用于区分 issue 执行粒度和 release 发布粒度，并保证写入默认 dry-run、版本号显式输入、外部副作用由人工或项目流程处理。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当需要归档 `.agents/plans/` 根目录下已完成的日期计划文件时使用；先由 agent 按当前 issue provider 查证完成态，再用本 skill 做 dry-run 归档、ISO 周目录移动和旧 plan 路径精确改写。
当生成、执行或回写 `docs/test/*` runbook 时使用；尤其适用于需要声明执行副作用、记录业务 request/response、区分 `.agents/runs` 原始痕迹与提交版测试文档边界的场景。
| name | project-version-release |
| description | 当维护项目版本、CHANGELOG、release archive 或发布策略说明时使用；用于区分 issue 执行粒度和 release 发布粒度，并保证写入默认 dry-run、版本号显式输入、外部副作用由人工或项目流程处理。 |
用于项目内版本、CHANGELOG 和 release policy 的通用维护。
核心规则：issue 是执行粒度，release 是发布粒度。不要因为一个 issue 完成就自动提升 release version。
AGENTS.md、docs/harness/control-plane.md 和项目 release 文档。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
--write。git push、修改 Issue Tracker、连接数据库、上传对象存储或发布 artifact。CHANGELOG.md 使用 Unreleased + release archive 模式；issue 结果先写入 Unreleased，只有真实 release 时才归档。v 前缀。## Unreleased。CHANGELOG.md 前，必须先在 plan 或回复中写明目标段：CHANGELOG.md -> Unreleased -> #### <category>:。### vX.Y.Z(YYYYMMDD) 都视为已归档 release 段；除非用户明确要求执行真实 release/archive 并给出版本号与日期，不得把新的 issue 条目追加到历史版本段。## Unreleased 后紧跟最新版本段，不要把第一个版本段当成本次变更目标。当任务涉及 release 边界、channel policy、兼容性或外部发布流程时，读取 references/project-version-policy.md。