feat: add Antigravity agent configuration (#383)

Add .agent directory containing workflows and configuration for Antigravity agent.
This includes workflows for PR creation, updates, commits, dependency upgrades, reviews, and permission fixes.

🤖 Generated with Antigravity

Co-authored-by: Antigravity <noreply@google.com>

Author: CodeCasterX

.agent/README.md

@@ -0,0 +1,57 @@
+# FIT Framework - Agent 配置
+
+本目录包含 AI Agent 的配置文件和工作流，旨在帮助 Agent 更高效地参与 FIT Framework 项目的开发。
+
+## 📁 目录结构
+
+```
+.agent/
+├── README.md              # 本文件
+└── workflows/             # Agent 工作流 (对应 Slash Commands)
+    ├── pr.md              # 创建 Pull Request
+    ├── pr-update.md       # 更新 Pull Request 描述
+    ├── commit.md          # 提交变更
+    ├── upgrade-dep.md     # 升级依赖
+    ├── review.md          # 审查 Pull Request
+    └── fix-permissions.md # 修复文件权限
+```
+
+## 🤖 工作流 (Workflows)
+
+当您要求 Agent 执行特定任务时，它会触发这些工作流。这些工作流确保了操作的一致性，并严格遵守项目规则。
+
+### 创建 Pull Request (`pr.md`)
+按照项目模板和规范创建一个新的 Pull Request。
+- **触发方式**: "创建 PR", "提交这个变更"
+- **执行动作**: 检查状态, 推送分支, 读取模板, 创建 PR。
+
+### 更新 PR (`pr-update.md`)
+更新现有 Pull Request 的描述信息。
+- **触发方式**: "更新 PR 描述", "修复 PR 格式"
+- **执行动作**: 读取模板, 更新 PR 内容。
+
+### 提交变更 (`commit.md`)
+将变更提交到本地仓库。
+- **触发方式**: "提交这些变更"
+- **执行动作**: 检查状态, 添加文件, 使用签名提交。
+
+### 升级依赖 (`upgrade-dep.md`)
+自动化依赖升级流程。
+- **触发方式**: "升级 [包名] 到 [版本]"
+- **执行动作**: 创建分支, 更新文件, 验证构建, 提交, 创建 PR。
+
+### 审查 PR (`review.md`)
+审查 Pull Request 的质量和合规性。
+- **触发方式**: "审查 PR #123"
+- **执行动作**: 分析 diff, 检查模板合规性, 生成报告。
+
+### 修复权限 (`fix-permissions.md`)
+修复文件所有权问题。
+- **触发方式**: "修复权限", "修复文件所有者"
+- **执行动作**: 识别 root 拥有的文件, 将所有者修改为与 README.md 一致。
+
+## 📋 项目规则
+
+Agent 会隐式遵守 `.claude/project-rules.md` 中定义的规则，特别是：
+1. **文件权限**: 创建或修改文件后，必须修复权限。
+2. **PR 模板**: 必须严格遵循 `.github/PULL_REQUEST_TEMPLATE.md`。

.agent/workflows/commit.md

@@ -0,0 +1,29 @@
+---
+description: 使用标准消息格式提交变更到 git
+---
+
+1. 检查仓库当前状态。
+   - `run_command("git status")`
+   - `run_command("git diff --stat")`
+
+2. 识别未追踪的文件。
+   - 如果有未追踪的文件（排除 `.agent/` 或 `.claude/` 如果它们被忽略），询问用户是否应该添加它们。
+
+3. 将文件添加到暂存区。
+   - `run_command("git add <files>")`
+
+4. 提交变更。
+   - 根据变更生成清晰、简洁的提交消息。
+   - 确保消息遵循 conventional commits 规范（例如：`feat:`, `fix:`, `docs:`）。
+   - 添加 Co-Authored-By 签名。
+   - 运行命令：
+     ```bash
+     git commit -m "$(cat <<'EOF'
+     <COMMIT_MESSAGE>
+
+     🤖 Generated with Antigravity
+
+     Co-Authored-By: Antigravity <noreply@google.com>
+     EOF
+     )"
+     ```

.agent/workflows/fix-permissions.md

@@ -0,0 +1,20 @@
+---
+description: 检查并修复项目中的文件权限
+---
+
+1. 确定正确的所有者/组。
+   - 检查 `README.md` 的所有者作为参考。
+   - `run_command("ls -l README.md")`
+   - 提取用户和组。
+
+2. 识别权限不正确的文件。
+   - 查找由 `root` 拥有的文件。
+   - `run_command("find . -user root")`
+
+3. 修复权限。
+   - 如果发现 root 拥有的文件，将其所有权更改为参考用户/组。
+   - `run_command("sudo chown -R <user>:<group> <path-to-root-owned-files>")`
+   - **注意**: 如果在项目外部运行，请小心不要更改系统文件。确保路径在项目内。
+
+4. 验证修复结果。
+   - 再次运行 find 命令，确保不再有 root 拥有的文件。

.agent/workflows/pr-update.md

@@ -0,0 +1,24 @@
+---
+description: 更新现有的 Pull Request 描述以符合项目标准
+---
+
+1. 从输入中解析 PR 编号。
+   - 示例输入："Update PR #123", "Fix description for 123"
+
+2. 读取 PR 模板。
+   - `Read(".github/PULL_REQUEST_TEMPLATE.md")`
+
+3. 查看当前 PR 信息。
+   - `run_command("gh pr view <pr-number>")`
+
+4. 更新 PR 描述。
+   - 重新编写描述以完全符合 `.github/PULL_REQUEST_TEMPLATE.md`。
+   - 保留原始描述中有价值的信息。
+   - 添加签名：`🤖 Generated with Antigravity`
+   - 运行命令：
+     ```bash
+     gh pr edit <pr-number> --body "$(cat <<'EOF'
+     <FULL_PR_BODY>
+     EOF
+     )"
+     ```

.agent/workflows/pr.md

@@ -0,0 +1,34 @@
+---
+description: 按照项目标准创建 Pull Request
+---
+
+1. 解析输入中的目标分支。
+   - 如果提供了分支名称（例如 "to main", "for 3.5.x"），则使用该分支。
+   - 如果未指定分支，默认使用 `3.6.x`。
+
+2. 读取 PR 模板以了解所需格式。
+   - `Read(".github/PULL_REQUEST_TEMPLATE.md")`
+
+3. 查看最近合并的 PR 以了解项目风格。
+   - `run_command("gh pr list --limit 3 --state merged --json number,title,body")`
+
+4. 分析当前分支的状态和变更。
+   - `run_command("git status")`
+   - `run_command("git log <target-branch>..HEAD --oneline")`
+   - `run_command("git diff <target-branch>...HEAD --stat")`
+
+5. 检查当前分支是否需要推送。
+   - `run_command("git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>&1 || echo 'No upstream branch'")`
+   - 如果没有上游分支或领先于远程分支，则推送：`run_command("git push -u origin <current-branch>")`
+
+6. 创建 Pull Request。
+   - 严格按照 `.github/PULL_REQUEST_TEMPLATE.md` 构建 PR 内容。
+   - 确保所有复选框都已正确填写。
+   - 添加签名：`🤖 Generated with Antigravity`
+   - 运行命令：
+     ```bash
+     gh pr create --base <target-branch> --title "<title>" --body "$(cat <<'EOF'
+     <FULL_PR_BODY>
+     EOF
+     )"
+     ```

.agent/workflows/review.md

@@ -0,0 +1,21 @@
+---
+description: 审查 Pull Request 的质量和合规性
+---
+
+1. 解析 PR 编号。
+   - 示例输入："Review PR #123"
+
+2. 收集 PR 信息。
+   - `run_command("gh pr view <pr-number>")`
+   - `run_command("gh pr diff <pr-number>")`
+   - `run_command("gh pr checks <pr-number>")`
+
+3. 分析 PR。
+   - **合规性**: PR 描述是否符合 `.github/PULL_REQUEST_TEMPLATE.md`？所有复选框是否已填写？
+   - **质量**: 是否有明显的 bug、安全问题或代码风格违规？
+   - **测试**: 是否包含测试？检查是否通过？
+
+4. 生成审查报告。
+   - 创建发现问题的摘要。
+   - 列出具体问题或建议。
+   - 给出结论性建议（批准、请求更改、评论）。

.agent/workflows/upgrade-dep.md

@@ -0,0 +1,34 @@
+---
+description: 升级依赖并创建 Pull Request
+---
+
+1. 解析输入参数。
+   - 包名 (例如 `swagger-ui`)
+   - 原版本 (例如 `5.30.0`)
+   - 新版本 (例如 `5.30.2`)
+
+2. 创建新的功能分支。
+   - `run_command("git checkout -b fit-enhancement-<package>-<to-version>")`
+
+3. 更新依赖文件。
+   - 搜索旧版本字符串：`grep_search(query="<from-version>", path=".")`
+   - 使用 `replace_file_content` 更新 `pom.xml`, `package.json` 或其他相关文件。
+
+4. 验证变更。
+   - `run_command("git diff")`
+   - `run_command("mvn clean package -Dmaven.test.skip=true")` (或适当的构建命令)
+
+5. 提交变更。
+   - `run_command("git add .")`
+   - 提交消息：
+     ```
+     Upgrade <package> from v<from-version> to v<to-version>
+
+     🤖 Generated with Antigravity
+
+     Co-Authored-By: Antigravity <noreply@google.com>
+     ```
+
+6. 推送并创建 Pull Request。
+   - `run_command("git push -u origin HEAD")`
+   - 触发 `pr` 工作流（或按照 `pr.md` 中的逻辑手动运行 `gh pr create`）。