agenvoy 本 Skill 為 Agenvoy 內部最佳化版本，依 Agenvoy 的執行環境撰寫（
run_command的 CWD、~/.config/agenvoy/skills/.system/安裝位置、edit_skill／schedules／find_edit_tool等工具、subagent 與排程的觸發路徑），不保證適配其他 AI harness。
版本產生器
從最新的 git tag 到 HEAD 生成 .doc/version-generate/vA.B.C.md 變更日誌（含 frontmatter 與可追溯欄位），同步維護 .doc/version-generate/CHANGELOG.md 主索引。
工作流程
| 階段 | 內容 | 實作細節 |
|---|---|---|
| 0 | 發版者驗證（git config 缺失即中止） | scripts/00-validate-releaser.md |
| 1 | 版本偵測（最新標籤 + remote URL） | scripts/01-detect-version.md |
| 2 | 收集變更（git diff 淨差異優先，commit 為溯源） |
scripts/02-collect-changes.md |
| 3 | 分類標籤與版本升級規則 | scripts/03-classify-and-bump.md |
| 4 | 產出 .doc/version-generate/NEW_VERSION.md（frontmatter + 追溯） |
scripts/04-output-template.md |
| 5 | 更新 .doc/version-generate/CHANGELOG.md 主索引 |
scripts/05-update-index.md |
| ∞ | 分類規則與邊界案例 | scripts/06-rules-and-edge-cases.md |
核心契約
條目定義（最高優先）
條目來自 git diff $LATEST_TAG..HEAD 的淨差異，不是 commit 逐筆轉錄。區間內互相抵銷的變更（新增後刪除、遷移後遷回、改後改回）不列入，連 REMOVE 與 Migration 都不寫；多 commit 對應同一淨差異者合併為一條，並保留全部貢獻 commit 的 short hash 作為溯源。
硬性前置條件
git config user.name與user.email必須設定（步驟 0）- BREAKING 變更必須附 Migration 指引（步驟 4，缺失則中止）；BREAKING 須在淨差異中仍成立，被還原者不算
輸出
.doc/version-generate/<NEW_VERSION>.md— 完整 changelog（含 frontmatter）.doc/version-generate/CHANGELOG.md— 主索引（prepend 最新版本）
版本映射（SemVer）
| 偵測到的標籤 | 版本影響 |
|---|---|
BREAKING |
MAJOR（+1.0.0） |
FEAT |
MINOR（+0.1.0） |
FIX / UPDATE / SECURITY / REFACTOR / PERF / ADD / REMOVE |
PATCH（+0.0.1） |
STYLE / DOC / TEST / CHORE |
不升版（type: none，不更新索引） |
執行順序
步驟 0 → 1 → 2 → 3 → 4 → 5，任一階段前置條件未達即中止，不產出殘缺文件。