// 從最新的 git tag 到 HEAD 生成結構化變更日誌並推薦新版本。當使用者請求生成變更日誌、發行說明或版本升級文件時使用。
| name | version-generate |
| description | 從最新的 git tag 到 HEAD 生成結構化變更日誌並推薦新版本。當使用者請求生成變更日誌、發行說明或版本升級文件時使用。 |
從最新的 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 | 收集變更（Conventional Commits 優先） | 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 config user.name 與 user.email 必須設定（步驟 0）.doc/version-generate/<NEW_VERSION>.md — 完整 changelog（含 frontmatter）.doc/version-generate/CHANGELOG.md — 主索引（prepend 最新版本）| 偵測到的標籤 | 版本影響 |
|---|---|
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，任一階段前置條件未達即中止，不產出殘缺文件。
Install an Agenvoy extension from pkg.agenvoy.com registry (browse/pick) or local tarball into ~/.config/agenvoy/tools/.extension/<type>/<name>@<version>/. Extracts tar.gz, validates manifest (email field, type api/script only), installs deps, stores keychain keys, atomically moves staged dir. Collisions handled by Overwrite/Rename/Cancel popup.
Package a script tool under ~/.config/agenvoy/tools/script/ into a tar.gz and publish to pkg.agenvoy.com registry. Keyword picker, dep/key detection, config-stored email (ask + lowercase + persist), ask version, email verification gate, multipart upload with downgrade/unique guards.
Convert user-supplied API source (Swagger/OpenAPI JSON, cURL, or natural-language endpoint description) into Agenvoy APIDocumentData format and write each endpoint as a separate JSON file under `~/.config/agenvoy/tools/api/`. Triggers on requests like "add an API tool", "新增 api tool", "把這個 swagger 轉成 api tool", "註冊一個 API 給 agent 用". Handles auth schema (bearer / apikey / basic) and warns on intranet/localhost hosts before write.
將模糊需求煉成可執行計畫並立即執行。僅由 `/plan {需求}` 顯式觸發。流程：呼叫 `ask_user` tool 依需求複雜度蒐集多面向資訊（核心 3 維度為底，依風險／不可逆性／資源缺口擴充至 5-7 題）→ 呼叫 `generate_plan` tool 產出結構化計畫 → 視計畫缺口 ask_user 補問 或 直接逐步執行。第一個 tool call 永遠是 `ask_user`；不自己組計畫，必走 `generate_plan` tool。
建立並排程定時觸發的 skill。**所有新增定時／週期任務、提醒、排程通知的請求必須走此 skill**，禁止直接呼叫 add_task / add_cron（那是 skill 已存在時的時間綁定工具，不該作為新建排程的入口）。 必定觸發的訊息特徵（任一即活化）： - 相對延遲：「X 分鐘後」「X 小時後」「稍後」「待會」「等一下」 - 明確時間：「X 點」「下午 X 點」「明天 X 點」「後天」「YYYY-MM-DD HH:MM」 - 週期性：「每 X 分鐘」「每小時」「每天」「每週」「每月」「定時」「固定」 - 提醒 / 通知意圖：「提醒我」「通知我」「告訴我」+ 時間描述 範例觸發訊息：「5 分鐘後提醒我喝水」「每天早上 9 點抓 HN 頭條」「明天下午 3 點開會」「每 5 分鐘查台積電股價」。 **不觸發**（即使訊息含「觸發」「排程」字眼也不 activate）： - 訊息含 `[執行已存在 scheduler skill:` 標記 → 為 `/sched-<name>` 手動 trigger，當前 agent 直接執行 body - 訊息為一份完整的 SKILL.md body（`# Title` + `## 任務` + `## 輸出格式` 結構），無建立／排程動詞 → 為 skill execution，非 creation - 訊息僅含「執行 skill X」「跑 X」「run skill X」無時間 token → 為 execution 流程：解析訊息抽出「要做什麼」「何時觸發」→ 缺項用 ask_user 補問 → 生成 skill 檔案至 ~/.config/agenvoy/skills/scheduler/<short>-<hash8>/SKILL.md（無 scheduler- 前綴，hash 用於避免命名衝突）→ 呼叫 add_task 或 add_cron 綁定時間 → 回報。
Design and scaffold a Python (or JavaScript) script tool for Agenvoy, writing `tool.json` + `script.py`/`script.js` pair under `~/.config/agenvoy/tools/script/<tool_name>/`. Triggers on requests like "add a script tool", "幫我寫一個 python tool", "做一個 script tool 給 agent 用", "新增腳本工具". Handles parameter schema design, stdlib-vs-third-party dependency check, keychain secret access via local `/v1/key` endpoint, sandbox awareness, and test execution before write.