@fitlab-ai/agent-infra 0.3.0

package/templates/.agents/skills/release/SKILL.zh-CN.md

@@ -0,0 +1,141 @@
+---
+name: release
+description: >
+  执行版本发布流程。当用户要求发布版本时触发。参数：版本号（X.Y.Z）。
+---
+
+# 版本发布
+
+执行指定版本的版本发布流程。
+
+<!-- TODO: 根据你的项目发布流程调整以下步骤 -->
+
+## 执行流程
+
+### 步骤 1：解析并验证版本号
+
+从参数中提取版本。必须匹配 `X.Y.Z` 格式。
+
+解析组件：
+- MAJOR = X，MINOR = Y，PATCH = Z
+- 发布版本 = `X.Y.Z`
+
+如果格式无效，报错："Version format incorrect, expected X.Y.Z (e.g. 1.2.3)"
+
+### 步骤 2：验证工作区干净
+
+```bash
+git status --short
+```
+
+如果有未提交的变更，报错："Workspace has uncommitted changes. Please commit or stash first."
+
+### 步骤 3：更新版本引用
+
+<!-- TODO: 替换为你的项目版本更新步骤 -->
+
+搜索项目文件中的版本引用并更新：
+
+```bash
+# 查找包含版本引用的文件
+# 搜索当前版本模式
+# 更新版本字符串
+```
+
+**常见需要更新的文件**：
+- `package.json`（Node.js）
+- `pom.xml`（Maven）
+- `setup.py` / `pyproject.toml`（Python）
+- `version.go`（Go）
+- `README.md`（文档）
+- `SECURITY.md` / `SECURITY.zh-CN.md`（支持版本表格）
+
+**排除以下目录的版本替换**：
+- `.agents/`、`.agent-workspace/`、`.claude/`、`.codex/`、`.gemini/`、`.opencode/`（AI 工具配置）
+
+### 步骤 4：创建发布提交
+
+```bash
+git add -A
+git commit -m "chore: release v{version}"
+```
+
+### 步骤 5：创建 Git 标签
+
+```bash
+git tag v{version}
+```
+
+### 步骤 6：管理里程碑
+
+为已发布版本关闭对应版本里程碑，并为下一轮创建缺失的规划里程碑。
+
+执行：
+
+```bash
+bash .agents/skills/release/scripts/manage-milestones.sh "$MAJOR" "$MINOR" "$PATCH"
+```
+
+脚本负责：
+- 使用 `gh api "repos/$repo/milestones"` 读取当前里程碑
+- 在 `{MAJOR}.{MINOR}.{PATCH}` 存在且仍为开启状态时将其关闭
+- 确保 `{MAJOR}.{MINOR}.{PATCH+1}` 与 `{MAJOR}.{MINOR}.x` 存在
+- 当 `PATCH=0` 时，同时确保 `{MAJOR}.{MINOR+1}.0` 与 `{MAJOR}.{MINOR+1}.x`
+- 输出包含已发布里程碑动作和新建数量的汇总
+
+### 步骤 7：输出摘要
+
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+
+```
+版本 v{version} 已准备好发布。
+
+发布信息：
+- 版本：{version}
+- 发布提交：{commit-hash}
+- 标签：v{version}
+
+已更新文件数：{数量}
+
+下一步（手动执行）：
+
+1. 推送标签：
+   git push origin v{version}
+
+2. 推送分支：
+   git push origin {current-branch}
+
+3.（可选）生成发布说明：
+   - Claude Code / OpenCode：/create-release-note {version}
+   - Gemini CLI：/{{project}}:create-release-note {version}
+   - Codex CLI：$create-release-note {version}
+```
+
+### 回滚说明
+
+如果出了问题：
+```bash
+# 删除标签
+git tag -d v{version}
+
+# 重置提交
+git reset --soft HEAD~1
+
+# 恢复文件
+git checkout -- .
+```
+
+## 注意事项
+
+1. **需要干净的工作区**：必须没有未提交的变更
+2. **不自动推送**：所有操作仅在本地执行；用户手动推送
+3. **不验证构建**：发布前执行 test 技能进行验证
+4. **版本替换范围**：通过搜索确定需要更新哪些文件；排除 AI 工具目录
+5. **适配你的项目**：以上版本更新步骤是通用的；请根据你的项目版本方案进行定制
+6. **里程碑联动**：发布时自动创建下一轮里程碑；如果里程碑体系未初始化，建议先运行 `init-milestones`
+
+## 错误处理
+
+- 版本格式无效：提示正确格式并退出
+- 工作区不干净：提示提交或暂存
+- Git 操作失败：显示错误并提供回滚说明

package/templates/.agents/skills/release/scripts/manage-milestones.sh

@@ -0,0 +1,80 @@
+#!/bin/sh
+
+set -e
+
+if [ "$#" -ne 3 ]; then
+  echo "Usage: manage-milestones.sh <major> <minor> <patch>"
+  exit 1
+fi
+
+if ! command -v gh >/dev/null 2>&1; then
+  echo "GitHub CLI (\`gh\`) is not installed"
+  exit 1
+fi
+
+if ! gh auth token >/dev/null 2>&1; then
+  echo "GitHub CLI is not authenticated"
+  exit 1
+fi
+
+major="$1"
+minor="$2"
+patch="$3"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT HUP INT TERM
+
+repo="$(gh repo view --json nameWithOwner --jq '.nameWithOwner')"
+released_version="${major}.${minor}.${patch}"
+line_milestone="${major}.${minor}.x"
+next_patch_version="${major}.${minor}.$((patch + 1))"
+next_minor_version="${major}.$((minor + 1)).0"
+next_minor_line="${major}.$((minor + 1)).x"
+
+gh api "repos/$repo/milestones?state=all" --paginate \
+  --jq '.[] | [.number, .title, .state] | @tsv' > "$tmpdir/milestones.tsv"
+
+created_count=0
+
+ensure_milestone() {
+  title="$1"
+  description="$2"
+
+  if awk -F '\t' -v target="$title" '$2 == target { found = 1 } END { exit found ? 0 : 1 }' "$tmpdir/milestones.tsv"; then
+    echo "Milestone already exists: $title"
+    return 0
+  fi
+
+  gh api "repos/$repo/milestones" \
+    -f title="$title" \
+    -f description="$description" \
+    -f state="open" >/dev/null
+
+  printf '0\t%s\topen\n' "$title" >> "$tmpdir/milestones.tsv"
+  created_count=$((created_count + 1))
+  echo "Created milestone: $title"
+}
+
+released_number="$(awk -F '\t' -v target="$released_version" '$2 == target { print $1; exit }' "$tmpdir/milestones.tsv")"
+released_state="$(awk -F '\t' -v target="$released_version" '$2 == target { print $3; exit }' "$tmpdir/milestones.tsv")"
+
+if [ -n "$released_number" ] && [ "$released_state" = "open" ]; then
+  gh api "repos/$repo/milestones/$released_number" -X PATCH -f state="closed" >/dev/null
+  released_action="closed"
+elif [ -n "$released_number" ]; then
+  released_action="already-closed"
+else
+  released_action="missing"
+fi
+
+ensure_milestone "$next_patch_version" "Issues that we want to release in v$next_patch_version."
+ensure_milestone "$line_milestone" "Issues that we want to resolve in $major.$minor line."
+
+if [ "$patch" -eq 0 ]; then
+  ensure_milestone "$next_minor_version" "Issues that we want to release in v$next_minor_version."
+  ensure_milestone "$next_minor_line" "Issues that we want to resolve in $major.$((minor + 1)) line."
+fi
+
+echo "Milestone summary:"
+echo "- Released milestone: $released_version ($released_action)"
+echo "- New milestones created: $created_count"

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

@@ -0,0 +1,276 @@
+---
+name: review-task
+description: >
+  审查任务实现代码并输出代码审查报告，按严重程度分类（Blocker / Major / Minor）。
+  当用户在实现完成后要求代码审查时触发。参数：task-id。
+---
+
+# 代码审查
+
+## 行为边界 / 关键规则
+
+- 本技能仅读取代码并产出审查报告（`review.md` 或 `review-r{N}.md`）—— 不修改业务代码
+- 执行本技能后，你**必须**立即更新 task.md 中的任务状态
+
+## 执行步骤
+
+### 1. 验证前置条件
+
+检查必要文件：
+- `.agent-workspace/active/{task-id}/task.md` - 任务文件
+- 至少一个实现报告：`implementation.md` 或 `implementation-r{N}.md`
+
+注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
+
+如果任一文件缺失，提示用户先完成前置步骤。
+
+### 2. 确定审查轮次
+
+扫描 `.agent-workspace/active/{task-id}/` 目录中的审查产物文件：
+- 如果不存在 `review.md` 且不存在 `review-r*.md` → 本轮为第 1 轮，产出 `review.md`
+- 如果存在 `review.md` 且不存在 `review-r*.md` → 本轮为第 2 轮，产出 `review-r2.md`
+- 如果存在 `review-r{N}.md` → 本轮为第 N+1 轮，产出 `review-r{N+1}.md`
+
+记录：
+- `{review-round}`：本轮审查轮次
+- `{review-artifact}`：本轮审查报告文件名
+
+### 3. 阅读实现与修复报告
+
+扫描任务目录中的实现报告文件（`implementation.md`、`implementation-r{N}.md`），读取最高轮次的文件以理解：
+- 修改的文件列表
+- 实现的关键功能
+- 测试情况
+- 实现者标记的需关注事项
+
+如果存在修复产物（`refinement.md`、`refinement-r{N}.md`），读取最高轮次的文件以理解：
+- 已修复了哪些审查问题
+- 修复对代码和测试的影响
+- 当前代码状态相对上轮审查的变化
+
+### 4. 执行代码审查
+
+遵循 `.agents/workflows/feature-development.yaml` 中的 `code-review` 步骤：
+
+**必要审查领域**：
+- [ ] 代码质量和编码规范（按项目指南）
+- [ ] Bug 和潜在问题检测
+- [ ] 测试覆盖率和测试质量
+- [ ] 错误处理和边界情况
+- [ ] 性能和安全问题
+- [ ] 代码注释和文档
+- [ ] 与技术方案的一致性
+
+**审查原则**：
+1. **严格但公正**：指出问题的同时也肯定做得好的地方
+2. **具体**：提供准确的文件路径和行号
+3. **提供建议**：不仅指出问题，还要提供解决方案
+4. **按严重程度分类**：区分必须修复和可优化项
+
+同时审查 `git diff` 以查看所有变更的上下文。
+
+### 5. 输出审查报告
+
+创建 `.agent-workspace/active/{task-id}/{review-artifact}`。
+
+### 6. 更新任务状态
+
+获取当前时间：
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+更新 `.agent-workspace/active/{task-id}/task.md`：
+- `current_step`：code-review
+- `assigned_to`：{审查者}
+- `updated_at`：{当前时间}
+- 记录本轮审查产物：`{review-artifact}`（Round `{review-round}`）
+- 在工作流进度中标记 code-review 为已完成，并注明实际轮次（如果任务模板支持）
+- **追加**到 `## Activity Log`（不要覆盖之前的记录）：
+  ```
+  - {yyyy-MM-dd HH:mm:ss} — **Code Review (Round {N})** by {agent} — Verdict: {Approved/Changes Requested/Rejected}, blockers: {n}, major: {n}, minor: {n} → {artifact-filename}
+  ```
+
+### 7. 告知用户
+
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+
+根据审查结果输出：
+
+**如果通过且无问题**（Major = 0 且 Minor = 0）：
+```
+任务 {task-id} 代码审查完成。结论：通过。
+- 阻塞项：0 | 主要问题：0 | 次要问题：0
+
+下一步 - 提交代码：
+  - Claude Code / OpenCode：/commit
+  - Gemini CLI：/agent-infra:commit
+  - Codex CLI：$commit
+```
+
+**如果通过但有问题**（Major > 0 或 Minor > 0）：
+```
+任务 {task-id} 代码审查完成。结论：通过。
+- 阻塞项：0 | 主要问题：{n} | 次要问题：{n}
+- 审查报告：.agent-workspace/active/{task-id}/{review-artifact}
+
+下一步 - 修复问题后提交（推荐）：
+  - Claude Code / OpenCode：/refine-task {task-id}
+  - Gemini CLI：/agent-infra:refine-task {task-id}
+  - Codex CLI：$refine-task {task-id}
+
+或直接提交（跳过修复）：
+  - Claude Code / OpenCode：/commit
+  - Gemini CLI：/agent-infra:commit
+  - Codex CLI：$commit
+```
+
+**如果需要修改**：
+```
+任务 {task-id} 代码审查完成。结论：需要修改。
+- 阻塞项：{n} | 主要问题：{n} | 次要问题：{n}
+- 审查报告：.agent-workspace/active/{task-id}/{review-artifact}
+
+下一步 - 修复问题：
+  - Claude Code / OpenCode：/refine-task {task-id}
+  - Gemini CLI：/agent-infra:refine-task {task-id}
+  - Codex CLI：$refine-task {task-id}
+```
+
+**如果拒绝**：
+```
+任务 {task-id} 代码审查完成。结论：拒绝，需要重大返工。
+- 审查报告：.agent-workspace/active/{task-id}/{review-artifact}
+
+下一步 - 重新实现：
+  - Claude Code / OpenCode：/implement-task {task-id}
+  - Gemini CLI：/agent-infra:implement-task {task-id}
+  - Codex CLI：$implement-task {task-id}
+```
+
+## 输出模板
+
+```markdown
+# 代码审查报告
+
+- **审查轮次**：Round {review-round}
+- **产物文件**：`{review-artifact}`
+- **实现输入**：
+  - `{implementation-artifact}`
+  - `{refinement-artifact}`（如存在）
+
+## 审查摘要
+
+- **审查者**：{审查者名称}
+- **审查时间**：{时间戳}
+- **审查范围**：{文件数量和主要模块}
+- **总体结论**：{已批准 / 需要修改 / 拒绝}
+
+## 发现的问题
+
+### 阻塞项（必须修复）
+
+#### 1. {问题标题}
+**文件**：`{file-path}:{line-number}`
+**描述**：{详细描述}
+**建议修复**：{具体建议}
+**严重程度**：高
+
+### 主要问题（应该修复）
+
+#### 1. {问题标题}
+**文件**：`{file-path}:{line-number}`
+**描述**：{详细描述}
+**建议修复**：{具体建议}
+**严重程度**：中
+
+### 次要问题（可选优化）
+
+#### 1. {优化点}
+**文件**：`{file-path}:{line-number}`
+**建议**：{优化建议}
+
+## 亮点
+
+- {做得好的方面 1}
+- {做得好的方面 2}
+
+## 规范符合度
+
+### 编码规范
+- [ ] 命名规范
+- [ ] 代码风格
+- [ ] 注释规范
+- [ ] 测试规范
+
+### 代码质量指标
+- 圈复杂度：{评估}
+- 代码重复：{评估}
+- 测试覆盖率：{百分比或评估}
+
+## 测试审查
+
+### 测试覆盖率
+- 单元测试：{评估}
+- 边界情况：{是否覆盖？}
+- 错误场景：{是否覆盖？}
+
+### 测试质量
+- 测试命名：{评估}
+- 断言充分性：{评估}
+- 测试独立性：{评估}
+
+## 安全审查
+
+- SQL 注入风险：{检查结果}
+- XSS 风险：{检查结果}
+- 访问控制：{检查结果}
+- 敏感数据暴露：{检查结果}
+
+## 性能审查
+
+- 算法复杂度：{评估}
+- 资源管理：{检查结果}
+- 潜在瓶颈：{评估}
+
+## 与方案的一致性
+
+- [ ] 实现与技术方案一致
+- [ ] 没有偏离设计意图
+- [ ] 没有添加计划外的功能
+
+## 结论和建议
+
+### 审批决定
+- [ ] 通过 - 无阻塞问题
+- [ ] 需要修改 - 有需要解决的问题
+- [ ] 拒绝 - 需要重大返工
+
+### 后续步骤
+{基于审查结果的建议}
+```
+
+## 完成检查清单
+
+- [ ] 完成了所有修改文件的代码审查
+- [ ] 创建了审查报告 `.agent-workspace/active/{task-id}/{review-artifact}`
+- [ ] 更新了 task.md 中的 `current_step` 为 code-review
+- [ ] 更新了 task.md 中的 `updated_at` 为当前时间
+- [ ] 更新了 task.md 中的 `assigned_to` 为审查者名称
+- [ ] 追加了 Activity Log 条目到 task.md
+- [ ] 在工作流进度中标记了 code-review 为已完成
+- [ ] 根据审查结果告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+
+## 注意事项
+
+1. **前置条件**：必须已完成至少一轮实现（`implementation.md` 或 `implementation-r{N}.md` 存在）
+2. **客观性**：严格但公正；在指出问题的同时肯定优秀的工作
+3. **具体性**：始终引用准确的文件路径和行号
+4. **严重程度分类**：阻塞项必须修复；主要问题应该修复；次要问题为可选
+5. **版本化规则**：首轮审查使用 `review.md`；后续轮次使用 `review-r{N}.md`
+
+## 错误处理
+
+- 任务未找到：提示 "Task {task-id} not found"
+- 缺少实现报告：提示 "Implementation report not found, please run the implement-task skill first"