Antigravity 工作流的实践记录

一个拥有标准工作流的赛博研发团队。

通过输入不同的 / (Slash Command) 命令，你可以像项目经理一样指挥它完成不同阶段的工作。以下是你现在可以通过 / 调用的核心工作流地图：

🏁 1. 需求与架构阶段 (开始写代码前必做)

/grill-me [你的原始需求]
- 作用：需求拷问与设计对齐。你丢给它一个粗糙的想法（如："帮我做一个订单导出"），它绝对不会立刻写代码，而是连续反问你核心逻辑（导出格式？权限控制？超大数量怎么异步？），直到你们达成共识。
- 产出：在 ./docs 目录生成标准架构设计文档（ADR）。
/grill-with-docs [领域词汇/需求]
- 作用：领域驱动设计对齐。如果需求涉及复杂的公司业务黑话（如："物料打散逻辑"），用这个命令可以帮 AI 和你统一名词术语，防止后续代码命名混乱。

🧩 2. 任务规划与拆解阶段

/triage [把刚才聊好的需求分派下去]
- 作用：任务拆解与看板管理 。AI 会像敏捷开发里的 Scrum Master，把你交代的大需求，自动拆解成极其细粒度的子任务，打上我们设定的 frontend、backend、database 标签，并填入你项目根目录的 TODO.md 里。

🚀 3. 长时间自主执行阶段 (Antigravity 原生神技)

/goal 请按照 TODO.md 里的第一个后端任务开始执行
- 作用：开启"死磕"模式 (无人值守) 。这是一个极其强大的命令。AI 会进入深度执行状态，它会先写测试，跑 mvn clean test，如果报错了（被我们设定的 Hook 拦截），它会自动查错、改代码、再跑测试，不达目的决不罢休，直到整个子任务彻底变绿跑通为止。非常适合你在下班前让它自己重构代码。
/boost [某个极难的 Bug / 复杂的重构]
- 作用：召唤架构师级算力。当遇到非常棘手、毫无头绪的代码问题时使用。AI 会开启深度思考，从多个角度分析你的代码依赖，甚至模拟多种方案来彻底解决顽疾。

⚙️ 4. 环境与规则配置 (项目初次初始化)

/setup-matt-pocock-skills
- 作用：项目级上下文初始化。以后当你用 Qoder/Antigravity 打开一个新的 Java 仓库时，第一件事就是运行它。告诉 AI 这个新项目的任务大纲在哪里，文档存哪里。
/learn [我刚才纠正了你某个接口的写法，请记住]
- 作用：动态沉淀专属开发经验 。如果你发现 AI 总是犯同一个框架版本不兼容的错误，或者你亲自帮它改对了一次写法，立刻对它使用 /learn。AI 会把这次经验"刻进 DNA"，下次再写类似代码时绝不再犯，真正实现越用越顺手。

💡 核心工作流实战循环 (Workflow Loop)

掌握了上面这些命令后，你以后开发一个新功能的最佳姿势是：

沟通对齐 ：敲入 /grill-me 讨论方案细节。
生成看板 ：敲入 /triage 把讨论结果落地为 TODO.md 中的打卡清单。
点火起飞 ：敲入 /goal 让 AI 开始执行第一条 TODO（它会严格遵守 TDD 测试驱动和你的开发纪律）。
循环验收 ：AI 做完一条，你验收一条，再用 /goal 执行下一条。

这就是完全由顶级架构师思路驱动的 Agentic 编程范式，它能保证大模型为你写出的代码不仅能跑，而且极其严谨、可读、可维护！

插件概况

🌟插件位置和组成

（2026年9月1日09:46:29）

Hayter Agentic Workflow （今天 09:33 安装），位于 C:\Users\郑\.qoder\plugins\Hayter-agentic-workflow，是一个为 Java 开发定制的全局工作流插件，包含 4 个部分：

文件	作用
`rules/AGENTS.md`	Java 开发铁律：TDD 测试先行（JUnit 5 + Mockito）、禁止魔法数字、禁止空 catch、MCP 操作 MySQL 仅限 `SELECT`/`SHOW`
`hooks.json`	pre-commit 钩子：提交前强制执行 `mvn clean test`，测试失败则打回任务
`mcp_config.json`	本地 MySQL MCP 服务器连接配置
`skills/`	brainstorming 三路径工作流（Spike/Bounded/Architectural）+ 规格文档审查模板 + 可视化伴侣脚本

⚠️需要注意的 3 个问题

MCP 凭据是占位符，尚未填写 。mcp_config.json 中当前为：

这样 MySQL MCP 无法连接。可执行文件 mcp-server-mysql.exe 本身是存在的（Python 3.14 已安装）。

复制代码

- `MYSQL_USER`: `"你的用户名"`
- `MYSQL_PASSWORD`: `"你的密码"`
- `MYSQL_DATABASE`: `"你的数据库名"`

与项目已有 MCP 配置并存 ：项目 .agents/mcp_config.json 中已有一个 local-mysql 配置（指向 192.168.10.142:2308/fsp-agent-no-xjar），插件又新增了一个 local-mysql-hayter（指向 127.0.0.1:3306）。两者目标不同，注意别用混。
pre-commit 钩子对重型项目偏重 ：mvn clean test 是全量构建+全量测试，如果存在项目有几十个 Maven 模块，每次提交前执行可能需要很长时间。如果实际使用中觉得太慢，可以考虑改为 -pl <变更模块> -am 的单模块测试。

插件本身的规则（TDD、代码规范、DB 只读纪律）与项目现有的 sdd-gates.md、code-style.md 规范是兼容互补的，我会在后续任务中一并遵循。

🚀 实战剧本：Hayter Agentic Workflow 的一天

背景设定 ：你（Hayter）正在开发一个现有的 Java Spring Boot 线上商城项目。

今日任务 ：产品经理要求开发一个 "用户充值升级为 VIP" 的核心业务接口。

你的助手 ：加载了完全版 Hayter-agentic-workflow 的 AI 大模型。

🎬 阶段一：需求拷问与架构对齐 (`/grill-me`)

你：/grill-me 我想在系统中加一个充值成为 VIP 的接口。

AI (启动架构师模式) ：

"好的 Hayter，收到需求。但在写代码之前，我们需要敲定几个关键细节：

状态存储 ：VIP 状态是直接在 users 表加个 is_vip 字段，还是需要一张独立的 vip_subscriptions 表来记录到期时间？
幂等性：如果一个已经是 VIP 的用户再次调用这个接口，系统应该抛出异常，还是自动为他延长 VIP 时间？
金额类型：本次充值扣款，金额打算用什么数据类型来处理？"

你：

"1. 加独立表记录到期时间。

抛出 BusinessException。
用 Double。"

你：/learn 记住，在我们这个电商系统里，所有涉及到钱的字段，绝对不能用 Double，必须全部统一使用 BigDecimal。

AI (触发规则进化) ：

"收到！我已经将『金额必须使用 BigDecimal』写入了 .agents/rules/AGENTS.md。

既然细节已经对齐，我正在为你生成架构决策文档......"

👉 自动产出 ：docs/ADR-001-VIP-Upgrade.md 写入成功。

📋 阶段二：任务拆解 (`/triage`)

你：/triage 根据刚才的 ADR，帮我把活儿拆了。

AI (启动项目经理模式) ：

"正在扫描项目架构......任务已拆解并写入根目录的 TODO.md："

markdown 复制代码

# 待办清单
- [ ] 1. (database) 利用 MCP 探查当前数据库结构，生成 `vip_subscriptions` 建表 SQL。
- [ ] 2. (backend) [TDD] 编写 `VipServiceTest` 单元测试。
- [ ] 3. (backend) 实现 `VipService` 业务逻辑。
- [ ] 4. (backend) 实现 `VipController` 暴露接口。

⚔️ 阶段三：自动化开发与护栏拦截 (`/goal`)

你：/goal 请开始执行 TODO 里的第 1 项和第 2 项任务。

AI (启动无情干活机器模式) ：

(后台静默运行中...)

数据库探查 (触发 MCP) ：AI 尝试通过 mcp-server-mysql 执行 SHOW TABLES; 和 DESC users;。MCP 成功返回了现有表结构。
防爆破拦截 (触发 Rule) ：AI 准备执行建表 SQL，但触碰到了 AGENTS.md 里的数据库安全红线 。
AI 中断操作并提示 ："Hayter，SQL 脚本 V1.1__Create_VIP_Table.sql 已生成。受限于纪律，我无权直接修改数据库，请你手动执行它。"
测试驱动开发 (TDD) ：你确认 SQL 没问题后，AI 开始写 VipServiceTest.java（严格使用了 JUnit 5 和 Mockito）。

🛡️ 阶段四：生命周期拦截与自我修复 (Hooks)

你：/goal 继续完成第 3 项任务（实现业务逻辑）。

AI ：

(编写完 VipService 后，准备标记任务完成并提交)

💥 触发底层 Hook ( hooks.json) ：系统在 AI 提交前，强制在终端里执行了 mvn clean test。

终端输出 ：BUILD FAILURE! Cannot resolve symbol 'MagicNumber 100'

(原来是 AI 偷懒，在代码里写了一个魔法数字 if (amount.compareTo(new BigDecimal(100)) > 0)，导致代码规范检查/测试没过！)

AI (触发自我修复) ：

"Hook 拦截到错误！违反了 AGENTS 纪律中的『拒绝魔法数字』规则。正在自我修正......"

(AI 默默撤回代码，新建了一个 Constants.java ，定义了 VIP_PRICE = 100 ，修改逻辑后再次跑 mvn clean test)

终端输出 ：BUILD SUCCESS

🏆 阶段五：验收收工

AI： "Hayter，VIP 升级模块已全部开发完毕！

架构文档存放在 ./docs
单元测试覆盖率 100% 且 Maven 校验通过。
TODO.md 的任务已全部勾选完成 [x]。
请检查最终代码！"

💡 核心价值总结

在这个剧本里，你不需要看一行 AI 生成的垃圾代码 ，也不需要一次次手动去 Run Test 帮它纠错。你只负责做决策 (Grill) 、定规矩 (Learn) 、以及发号施令 (Goal)，剩下的苦活累活和质量把控，全被你的工作流接管了！

（目前skill为私有工具，存入自己的github的私有仓库中。）