@fitlab-ai/agent-infra 0.3.0

package/templates/.agents/skills/refine-task/SKILL.md

@@ -0,0 +1,200 @@
+---
+name: refine-task
+description: >
+  处理代码审查反馈并修复审查中发现的问题。按优先级（Blocker -> Major -> Minor）修复。
+  仅处理审查中标记的问题，不添加额外变更。当用户要求修复审查问题时触发。参数：task-id。
+---
+
+# 修复审查问题
+
+## 行为边界 / 关键规则
+
+- 仅修复审查中标记的问题 —— 不要添加无关变更或额外的"改进"
+- 不要自动提交。绝不自动执行 `git commit` 或 `git add`
+- 执行本技能后，你**必须**立即更新 task.md 中的任务状态
+
+## 执行步骤
+
+### 1. 验证前置条件
+
+检查必要文件：
+- `.agent-workspace/active/{task-id}/task.md` - 任务文件
+- 至少一个审查产物：`review.md` 或 `review-r{N}.md`
+
+注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
+
+如果缺少 `task.md` 或没有任何审查产物，提示用户先完成前置步骤。
+
+随后执行以下发现与校验：
+1. 扫描任务目录中的审查产物文件（`review.md`、`review-r{N}.md`）
+2. 取最高轮次的审查产物作为本次修复输入，记为 `{review-artifact}`
+3. 扫描修复产物文件（`refinement.md`、`refinement-r{N}.md`）并确定本轮修复产物：
+   - 如果不存在 `refinement.md` 且不存在 `refinement-r*.md` → 本轮为第 1 轮，产出 `refinement.md`
+   - 如果存在 `refinement.md` 且不存在 `refinement-r*.md` → 本轮为第 2 轮，产出 `refinement-r2.md`
+   - 如果存在 `refinement-r{N}.md` → 本轮为第 N+1 轮，产出 `refinement-r{N+1}.md`
+   - 记录 `{refinement-round}` 和 `{refinement-artifact}`
+4. 扫描实现报告文件（`implementation.md`、`implementation-r{N}.md`），取最高轮次作为修复上下文的 `{implementation-artifact}`
+   - 记录 `{implementation-artifact}`
+5. **一致性校验**：检查 `task.md` 的 `## 活动日志` 中最近一条 Code Review 记录的轮次号和文件名，是否与步骤 2 扫描到的最新审查产物匹配
+
+若 Activity Log 记录与实际文件不匹配，立即停止并提示：
+`Review artifact mismatch: Activity Log references {expected} but file not found. Please verify the review artifact exists.`
+
+### 2. 阅读审查与实现上下文
+
+仔细阅读步骤 1 中确定的最新审查产物 `{review-artifact}` 和实现产物 `{implementation-artifact}` 以理解：
+- 所有阻塞项（必须修复）
+- 所有主要问题（应该修复）
+- 次要问题（可选优化）
+- 审查者的建议和推荐
+- 当前实现和之前修复的上下文
+
+### 3. 规划修复
+
+分类并确定优先级：
+1. **阻塞项优先**：必须解决所有阻塞项
+2. **然后是主要问题**：处理所有主要问题
+3. **最后是次要问题**：如有时间则处理（可选）
+
+对于每个问题，确定：
+- 需要修改哪些文件
+- 具体要做哪些修改
+- 如何验证修复
+
+### 4. 执行代码修复
+
+按优先级顺序修复问题：
+
+**对于每个修复**：
+1. 读取受影响的文件
+2. 应用修复
+3. 验证修复是否解决了审查意见
+4. 运行相关测试
+
+**修复原则**：
+- 仅修复标记的问题 —— 不要添加无关变更
+- 不要添加超出要求的额外"改进"
+- 保持变更最小化和聚焦
+
+### 5. 运行测试验证
+
+执行项目的测试命令。参考 `test` 技能获取项目特定的测试命令。
+
+确保修复后所有测试仍然通过。
+
+### 6. 创建修复报告
+
+创建 `.agent-workspace/active/{task-id}/{refinement-artifact}`。
+
+### 7. 更新任务状态
+
+获取当前时间：
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+更新 `.agent-workspace/active/{task-id}/task.md`：
+- `current_step`：refinement
+- `assigned_to`：{当前 AI 代理}
+- `updated_at`：{当前时间}
+- 记录本轮修复产物：`{refinement-artifact}`（Round `{refinement-round}`）
+- **追加**到 `## Activity Log`（不要覆盖之前的记录）：
+  ```
+  - {yyyy-MM-dd HH:mm:ss} — **Refinement (Round {N}, for {review-artifact})** by {agent} — Fixed {n} blockers, {n} major, {n} minor issues → {refinement-artifact}
+  ```
+
+### 8. 告知用户
+
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+
+输出格式：
+```
+任务 {task-id} 修复完成。
+
+修复情况：
+- 阻塞项修复：{数量}/{总数}
+- 主要问题修复：{数量}/{总数}
+- 次要问题修复：{数量}/{总数}
+- 所有测试通过：{是/否}
+- 审查输入：{review-artifact}
+- 修复产物：{refinement-artifact}
+
+下一步 - 重新审查或提交：
+- 重新审查：
+  - Claude Code / OpenCode：/review-task {task-id}
+  - Gemini CLI：/agent-infra:review-task {task-id}
+  - Codex CLI：$review-task {task-id}
+- 直接提交：
+  - Claude Code / OpenCode：/commit
+  - Gemini CLI：/agent-infra:commit
+  - Codex CLI：$commit
+```
+
+## 输出模板
+
+```markdown
+# 修复报告
+
+- **修复轮次**：Round {refinement-round}
+- **产物文件**：`{refinement-artifact}`
+- **审查输入**：`{review-artifact}`
+- **实现上下文**：`{implementation-artifact}`
+
+### 审查反馈处理
+
+#### 阻塞项修复
+1. **{问题标题}**（来自 {review-artifact}）
+   - **修复**：{做了什么修改}
+   - **文件**：`{file-path}:{line-number}`
+   - **验证**：{如何验证}
+
+#### 主要问题修复
+1. **{问题标题}**（来自 {review-artifact}）
+   - **修复**：{做了什么修改}
+   - **文件**：`{file-path}:{line-number}`
+
+#### 次要问题处理
+1. **{问题标题}**（来自 {review-artifact}）
+   - **修复**：{做了什么修改}
+
+#### 未处理的问题
+- {问题}：{未处理的原因，例如不同意审查建议}
+
+### 修复后的测试结果
+- 所有测试通过：{是/否}
+- 测试输出：{摘要}
+```
+
+## 完成检查清单
+
+- [ ] 阅读并理解了所有审查发现
+- [ ] 修复了所有阻塞项
+- [ ] 修复了所有主要问题
+- [ ] 在适当情况下处理了次要问题
+- [ ] 修复后所有测试通过
+- [ ] 创建了 `{refinement-artifact}` 修复报告
+- [ ] 更新了 task.md 中的任务状态
+- [ ] 追加了 Activity Log 条目到 task.md
+- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+
+## 注意事项
+
+1. **前置条件**：必须有审查报告（`review.md` 或 `review-r{N}.md` 存在）
+2. **禁止自动提交**：不要自动执行 `git commit`。提醒用户手动提交
+3. **范围纪律**：仅修复审查中标记的问题 —— 不添加额外变更
+4. **不同意见**：如果不同意某个审查意见，在"未处理的问题"部分记录你的理由
+5. **重新审查**：修复阻塞项后，建议重新运行 review-task 技能进行验证
+6. **一致性要求**：最新审查产物、Activity Log 记录和修复报告标题必须引用同一轮次文件
+7. **版本化规则**：首轮修复使用 `refinement.md`；后续轮次使用 `refinement-r{N}.md`
+
+## 停止
+
+完成检查清单后，**立即停止**。等待用户审查修复结果并决定重新审查还是提交。
+
+## 错误处理
+
+- 任务未找到：提示 "Task {task-id} not found"
+- 缺少审查报告：提示 "Review report not found, please run the review-task skill first"
+- 审查产物不一致：提示 "Review artifact mismatch: Activity Log references {expected} but file not found. Please verify the review artifact exists."
+- 修复后测试失败：输出测试错误，询问用户如何处理

package/templates/.agents/skills/refine-task/SKILL.zh-CN.md

@@ -0,0 +1,200 @@
+---
+name: refine-task
+description: >
+  处理代码审查反馈并修复审查中发现的问题。按优先级（Blocker -> Major -> Minor）修复。
+  仅处理审查中标记的问题，不添加额外变更。当用户要求修复审查问题时触发。参数：task-id。
+---
+
+# 修复审查问题
+
+## 行为边界 / 关键规则
+
+- 仅修复审查中标记的问题 —— 不要添加无关变更或额外的"改进"
+- 不要自动提交。绝不自动执行 `git commit` 或 `git add`
+- 执行本技能后，你**必须**立即更新 task.md 中的任务状态
+
+## 执行步骤
+
+### 1. 验证前置条件
+
+检查必要文件：
+- `.agent-workspace/active/{task-id}/task.md` - 任务文件
+- 至少一个审查产物：`review.md` 或 `review-r{N}.md`
+
+注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
+
+如果缺少 `task.md` 或没有任何审查产物，提示用户先完成前置步骤。
+
+随后执行以下发现与校验：
+1. 扫描任务目录中的审查产物文件（`review.md`、`review-r{N}.md`）
+2. 取最高轮次的审查产物作为本次修复输入，记为 `{review-artifact}`
+3. 扫描修复产物文件（`refinement.md`、`refinement-r{N}.md`）并确定本轮修复产物：
+   - 如果不存在 `refinement.md` 且不存在 `refinement-r*.md` → 本轮为第 1 轮，产出 `refinement.md`
+   - 如果存在 `refinement.md` 且不存在 `refinement-r*.md` → 本轮为第 2 轮，产出 `refinement-r2.md`
+   - 如果存在 `refinement-r{N}.md` → 本轮为第 N+1 轮，产出 `refinement-r{N+1}.md`
+   - 记录 `{refinement-round}` 和 `{refinement-artifact}`
+4. 扫描实现报告文件（`implementation.md`、`implementation-r{N}.md`），取最高轮次作为修复上下文的 `{implementation-artifact}`
+   - 记录 `{implementation-artifact}`
+5. **一致性校验**：检查 `task.md` 的 `## 活动日志` 中最近一条 Code Review 记录的轮次号和文件名，是否与步骤 2 扫描到的最新审查产物匹配
+
+若 Activity Log 记录与实际文件不匹配，立即停止并提示：
+`Review artifact mismatch: Activity Log references {expected} but file not found. Please verify the review artifact exists.`
+
+### 2. 阅读审查与实现上下文
+
+仔细阅读步骤 1 中确定的最新审查产物 `{review-artifact}` 和实现产物 `{implementation-artifact}` 以理解：
+- 所有阻塞项（必须修复）
+- 所有主要问题（应该修复）
+- 次要问题（可选优化）
+- 审查者的建议和推荐
+- 当前实现和之前修复的上下文
+
+### 3. 规划修复
+
+分类并确定优先级：
+1. **阻塞项优先**：必须解决所有阻塞项
+2. **然后是主要问题**：处理所有主要问题
+3. **最后是次要问题**：如有时间则处理（可选）
+
+对于每个问题，确定：
+- 需要修改哪些文件
+- 具体要做哪些修改
+- 如何验证修复
+
+### 4. 执行代码修复
+
+按优先级顺序修复问题：
+
+**对于每个修复**：
+1. 读取受影响的文件
+2. 应用修复
+3. 验证修复是否解决了审查意见
+4. 运行相关测试
+
+**修复原则**：
+- 仅修复标记的问题 —— 不要添加无关变更
+- 不要添加超出要求的额外"改进"
+- 保持变更最小化和聚焦
+
+### 5. 运行测试验证
+
+执行项目的测试命令。参考 `test` 技能获取项目特定的测试命令。
+
+确保修复后所有测试仍然通过。
+
+### 6. 创建修复报告
+
+创建 `.agent-workspace/active/{task-id}/{refinement-artifact}`。
+
+### 7. 更新任务状态
+
+获取当前时间：
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+更新 `.agent-workspace/active/{task-id}/task.md`：
+- `current_step`：refinement
+- `assigned_to`：{当前 AI 代理}
+- `updated_at`：{当前时间}
+- 记录本轮修复产物：`{refinement-artifact}`（Round `{refinement-round}`）
+- **追加**到 `## Activity Log`（不要覆盖之前的记录）：
+  ```
+  - {yyyy-MM-dd HH:mm:ss} — **Refinement (Round {N}, for {review-artifact})** by {agent} — Fixed {n} blockers, {n} major, {n} minor issues → {refinement-artifact}
+  ```
+
+### 8. 告知用户
+
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+
+输出格式：
+```
+任务 {task-id} 修复完成。
+
+修复情况：
+- 阻塞项修复：{数量}/{总数}
+- 主要问题修复：{数量}/{总数}
+- 次要问题修复：{数量}/{总数}
+- 所有测试通过：{是/否}
+- 审查输入：{review-artifact}
+- 修复产物：{refinement-artifact}
+
+下一步 - 重新审查或提交：
+- 重新审查：
+  - Claude Code / OpenCode：/review-task {task-id}
+  - Gemini CLI：/agent-infra:review-task {task-id}
+  - Codex CLI：$review-task {task-id}
+- 直接提交：
+  - Claude Code / OpenCode：/commit
+  - Gemini CLI：/agent-infra:commit
+  - Codex CLI：$commit
+```
+
+## 输出模板
+
+```markdown
+# 修复报告
+
+- **修复轮次**：Round {refinement-round}
+- **产物文件**：`{refinement-artifact}`
+- **审查输入**：`{review-artifact}`
+- **实现上下文**：`{implementation-artifact}`
+
+### 审查反馈处理
+
+#### 阻塞项修复
+1. **{问题标题}**（来自 {review-artifact}）
+   - **修复**：{做了什么修改}
+   - **文件**：`{file-path}:{line-number}`
+   - **验证**：{如何验证}
+
+#### 主要问题修复
+1. **{问题标题}**（来自 {review-artifact}）
+   - **修复**：{做了什么修改}
+   - **文件**：`{file-path}:{line-number}`
+
+#### 次要问题处理
+1. **{问题标题}**（来自 {review-artifact}）
+   - **修复**：{做了什么修改}
+
+#### 未处理的问题
+- {问题}：{未处理的原因，例如不同意审查建议}
+
+### 修复后的测试结果
+- 所有测试通过：{是/否}
+- 测试输出：{摘要}
+```
+
+## 完成检查清单
+
+- [ ] 阅读并理解了所有审查发现
+- [ ] 修复了所有阻塞项
+- [ ] 修复了所有主要问题
+- [ ] 在适当情况下处理了次要问题
+- [ ] 修复后所有测试通过
+- [ ] 创建了 `{refinement-artifact}` 修复报告
+- [ ] 更新了 task.md 中的任务状态
+- [ ] 追加了 Activity Log 条目到 task.md
+- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+
+## 注意事项
+
+1. **前置条件**：必须有审查报告（`review.md` 或 `review-r{N}.md` 存在）
+2. **禁止自动提交**：不要自动执行 `git commit`。提醒用户手动提交
+3. **范围纪律**：仅修复审查中标记的问题 —— 不添加额外变更
+4. **不同意见**：如果不同意某个审查意见，在"未处理的问题"部分记录你的理由
+5. **重新审查**：修复阻塞项后，建议重新运行 review-task 技能进行验证
+6. **一致性要求**：最新审查产物、Activity Log 记录和修复报告标题必须引用同一轮次文件
+7. **版本化规则**：首轮修复使用 `refinement.md`；后续轮次使用 `refinement-r{N}.md`
+
+## 停止
+
+完成检查清单后，**立即停止**。等待用户审查修复结果并决定重新审查还是提交。
+
+## 错误处理
+
+- 任务未找到：提示 "Task {task-id} not found"
+- 缺少审查报告：提示 "Review report not found, please run the review-task skill first"
+- 审查产物不一致：提示 "Review artifact mismatch: Activity Log references {expected} but file not found. Please verify the review artifact exists."
+- 修复后测试失败：输出测试错误，询问用户如何处理

package/templates/.agents/skills/refine-title/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: refine-title
+description: >
+  Deeply analyze Issue or PR content and reformat the title to
+  Conventional Commits format. Triggered when the user requests
+  title optimization. Argument: issue or PR number.
+---
+
+# Refine Title
+
+Reformat the title of the specified Issue or PR to Conventional Commits format based on deep content analysis.
+
+## Execution Flow
+
+### 1. Identify Target and Fetch Information
+
+Try to determine if the ID is an Issue or PR:
+
+```bash
+# Try Issue first
+gh issue view <id> --json number,title,body,labels,state
+
+# If not found or is a PR
+gh pr view <id> --json number,title,body,labels,state,files
+```
+
+### 2. Analyze Content
+
+Based on the fetched data:
+
+**Determine Type**:
+- Read body for change type indicators
+- Check labels (e.g. `type: bug` -> `fix`, `type: feature` -> `feat`)
+- If PR, analyze files (only docs changed -> `docs`, only tests -> `test`)
+
+**Determine Scope**:
+- Read body for module mentions
+- Check labels for module indicators
+- If PR, analyze file paths to infer affected module
+
+**Generate Subject**:
+- **Ignore the original title** (avoid bias) - extract core intent from body
+- Keep concise (under 50 characters), English imperative mood, no trailing period
+
+### 3. Present Suggestion
+
+```
+Analysis for Issue/PR #{id}:
+
+Current title: {original title}
+--------------------------------------------------
+Analysis:
+- Intent: {one-line summary from body}
+- Type: {type} (basis: {evidence})
+- Scope: {scope} (basis: {evidence})
+--------------------------------------------------
+Suggested title: {type}({scope}): {subject}
+```
+
+Ask user: "Apply this title? (y/n)"
+
+### 4. Apply Change
+
+If user confirms:
+
+```bash
+# For Issue
+gh issue edit <id> --title "<new-title>"
+
+# For PR
+gh pr edit <id> --title "<new-title>"
+```
+
+## Advantages
+
+This skill:
+1. **Fixes misleading titles**: Even if the original title is "Help me", it reads the body and generates a proper title like `fix(core): resolve startup error`
+2. **Accurate scope**: By analyzing PR file changes, it can automatically infer the correct scope without manual specification
+
+## Notes
+
+- The subject should be extracted from the body content, not reformatted from the original title
+- If the body is empty or insufficient, ask the user for clarification
+- Follow project conventions for scope naming

package/templates/.agents/skills/refine-title/SKILL.zh-CN.md

@@ -0,0 +1,83 @@
+---
+name: refine-title
+description: >
+  深度分析 Issue 或 PR 内容，并将其标题重构为 Conventional Commits 格式。
+  当用户要求优化标题时触发。参数：issue 或 PR 编号。
+---
+
+# 重构标题
+
+基于深度内容分析，将指定 Issue 或 PR 的标题重构为 Conventional Commits 格式。
+
+## 执行流程
+
+### 1. 识别目标并获取信息
+
+尝试判断 ID 是 Issue 还是 PR：
+
+```bash
+# 先尝试 Issue
+gh issue view <id> --json number,title,body,labels,state
+
+# 如果未找到或是 PR
+gh pr view <id> --json number,title,body,labels,state,files
+```
+
+### 2. 分析内容
+
+基于获取的数据：
+
+**确定 Type**：
+- 阅读 body 以寻找变更类型指示
+- 检查标签（例如 `type: bug` -> `fix`，`type: feature` -> `feat`）
+- 如果是 PR，分析文件（仅文档变更 -> `docs`，仅测试 -> `test`）
+
+**确定 Scope**：
+- 阅读 body 以寻找模块提及
+- 检查标签中的模块指示
+- 如果是 PR，分析文件路径以推断受影响的模块
+
+**生成 Subject**：
+- **忽略原始标题**（避免偏见）- 从 body 中提取核心意图
+- 保持简洁（不超过 50 字符），英文祈使语气，末尾无句号
+
+### 3. 展示建议
+
+```
+Issue/PR #{id} 分析结果：
+
+当前标题：{原始标题}
+--------------------------------------------------
+分析：
+- 意图：{从 body 提取的一行摘要}
+- 类型：{type}（依据：{依据}）
+- 范围：{scope}（依据：{依据}）
+--------------------------------------------------
+建议标题：{type}({scope}): {subject}
+```
+
+询问用户："是否应用此标题？(y/n)"
+
+### 4. 应用修改
+
+如果用户确认：
+
+```bash
+# 对于 Issue
+gh issue edit <id> --title "<new-title>"
+
+# 对于 PR
+gh pr edit <id> --title "<new-title>"
+```
+
+## 优势
+
+本技能的优势：
+1. **修复误导性标题**：即使原始标题是"Help me"，也能读取 body 并生成合适的标题，如 `fix(core): resolve startup error`
+2. **精确 scope**：通过分析 PR 文件变更，可以自动推断正确的 scope，无需手动指定
+
+## 注意事项
+
+- subject 应从 body 内容提取，而不是从原始标题重新格式化
+- 如果 body 为空或信息不足，向用户询问澄清
+- 遵循项目对 scope 命名的约定

package/templates/.agents/skills/release/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: release
+description: >
+  Execute the version release workflow. Triggered when the user
+  requests a version release. Argument: version number (X.Y.Z).
+---
+
+# Version Release
+
+Execute the version release workflow for the specified version.
+
+<!-- TODO: Adapt the steps below to your project's release process -->
+
+## Execution Flow
+
+### Step 1: Parse and Validate Version
+
+Extract version from arguments. Must match `X.Y.Z` format.
+
+Parse components:
+- MAJOR = X, MINOR = Y, PATCH = Z
+- Release version = `X.Y.Z`
+
+If format is invalid, error: "Version format incorrect, expected X.Y.Z (e.g. 1.2.3)"
+
+### Step 2: Verify Clean Workspace
+
+```bash
+git status --short
+```
+
+If there are uncommitted changes, error: "Workspace has uncommitted changes. Please commit or stash first."
+
+### Step 3: Update Version References
+
+<!-- TODO: Replace with your project's version update steps -->
+
+Search for version references in project files and update them:
+
+```bash
+# Find files with version references
+# Search for current version pattern
+# Update version strings
+```
+
+**Common files to update**:
+- `package.json` (Node.js)
+- `pom.xml` (Maven)
+- `setup.py` / `pyproject.toml` (Python)
+- `version.go` (Go)
+- `README.md` (documentation)
+- `SECURITY.md` / `SECURITY.zh-CN.md` (supported version table)
+
+**Exclude from version replacement**:
+- `.agents/`, `.agent-workspace/`, `.claude/`, `.codex/`, `.gemini/`, `.opencode/` (AI tool configs)
+
+### Step 4: Create Release Commit
+
+```bash
+git add -A
+git commit -m "chore: release v{version}"
+```
+
+### Step 5: Create Git Tag
+
+```bash
+git tag v{version}
+```
+
+### Step 6: Manage Milestones
+
+Close the milestone for the released version when it exists, and create the missing planning milestones for the next cycle.
+
+Run:
+
+```bash
+bash .agents/skills/release/scripts/manage-milestones.sh "$MAJOR" "$MINOR" "$PATCH"
+```
+
+The script is responsible for:
+- Loading the current milestone list with `gh api "repos/$repo/milestones"`
+- Closing `{MAJOR}.{MINOR}.{PATCH}` when it exists and is still open
+- Ensuring `{MAJOR}.{MINOR}.{PATCH+1}` and `{MAJOR}.{MINOR}.x` exist
+- When `PATCH=0`, also ensuring `{MAJOR}.{MINOR+1}.0` and `{MAJOR}.{MINOR+1}.x`
+- Printing a milestone summary with the released milestone action and new milestone count
+
+### Step 7: Output Summary
+
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+
+```
+Release v{version} prepared.
+
+Release info:
+- Version: {version}
+- Release commit: {commit-hash}
+- Tag: v{version}
+
+Files updated: {count}
+
+Next steps (manual):
+
+1. Push tag:
+   git push origin v{version}
+
+2. Push branch:
+   git push origin {current-branch}
+
+3. (Optional) Generate release notes:
+   - Claude Code / OpenCode: /create-release-note {version}
+   - Gemini CLI: /{{project}}:create-release-note {version}
+   - Codex CLI: $create-release-note {version}
+```
+
+### Rollback Instructions
+
+If something went wrong:
+```bash
+# Delete tag
+git tag -d v{version}
+
+# Reset commit
+git reset --soft HEAD~1
+
+# Restore files
+git checkout -- .
+```
+
+## Notes
+
+1. **Clean workspace required**: Must have no uncommitted changes
+2. **No auto-push**: All operations are local only; user pushes manually
+3. **No build verification**: Run the test skill before releasing to verify
+4. **Version replacement scope**: Search determines which files to update; exclude AI tool directories
+5. **Adapt to your project**: The version update steps above are generic; customize for your project's versioning scheme
+6. **Milestone coordination**: Releases should create the next planning milestones automatically; initialize the taxonomy first with `init-milestones` when needed
+
+## Error Handling
+
+- Invalid version format: Prompt correct format and exit
+- Dirty workspace: Prompt to commit or stash
+- Git operation failure: Display error and provide rollback instructions