versioninglisted

# Versioning Standard ## SemVer 应用细则 按 [SemVer 2.0.0](https://semver.org/spec/v2.0.0.html)。本仓库是 AI 团队模板（产物 ≠ 传统代码 API），下表把 "public API change" 具象化为模板特定触发器。 ### MAJOR — `vX.0.0`（标题必加 `(BREAKING)`） **以下任一**视为 MAJOR： - 删除或重命名：`.claude/agents/*.md` / `.claude/skills/*/` / `.claude/commands/*.md` / `.claude/hooks/*.sh` / skill `agf:*` - 文档路径约定改名（如 `docs/prd/` → 其他） - 任一 agent 的 frontmatter 必填字段变更（`name` / `description` / `tools`） - 任一 agent 的 Definition of Done 变严（既有产物不再合规） - hook 范围扩大到既有合法操作被阻断 - PRD / ADR / SIT 等模板新增必填字段（旧产物不再合规） ### MINOR — `vX.Y.0`（向后兼容增量） - 新增 agent / skill / slash command / hook / standards 文件 - 既有 agent 增加职责但不改既有行为 - 新增 frontmatter 可选字段（限官方支持的字段，如 `effort:` / `maxTurns:` / `isolation:`） - 新增 CLAUDE.md / standards / agent 中的可选段落 - hook 放宽（既有阻断变软告警） - 新增 PRD / ADR 等模板可选字段 - 新增 examples / persona / 经典示例 ### PATCH — `vX.Y.Z`（向后兼容修复） - typo / wording / formatting - 不改接口的 hook bug 修复 - README / 内部文档调整 - eval JSONL 内容增减 - CHANGELOG 自身修订 ## Release 流程 | 步骤 | 谁做 | 产物 | |---|---|---| | 1. 合并到 main 前判定版本号 | `product-lead` | PR 描述里�� `Bump: MAJOR / MINOR / PATCH + 理由` | | 2. 更新 `CHANGELOG.md` | `product-lead` | 顶部追加 `## [vX.Y.Z] — YYYY-MM-DD — 一句话标题`，下分 Added / Changed / Deprecated / Removed / Fixed / Security 节 | | 3. Commit changelog | 任意 dev | commit msg: `docs(changelog): vX.Y.Z` | | 4. 创建 git tag | `product-lead` | `git tag -a vX.Y.Z -m "..."`（annotation body 必须列出本 tag 实际覆盖但未在 CHANGELOG vX.Y.Z 节描述的 "out-of-scope but tagged-along" commits，避免 tag 覆盖范围与 CH