Codex 与 Antigravity 工作流
这套配置的目标很简单：让能力最强的 agent 处理跨仓库任务，让编辑器保持灵活， 并且每条长期规则只维护一份。
工具分工
| 工具 | 最适合的任务 |
|---|---|
| Codex | 跨文件实现、测试、审查、重构，以及正确性比延迟更重要的任务 |
| Antigravity CLI | 在终端中使用的第二个 agent 入口 |
| Antigravity IDE | 贴近代码的编辑、导航、补全、浏览器操作和可视化产物 |
Codex 当前默认使用 gpt-5.6-sol 和 high reasoning。这是有意选择的正确性优先
配置；只有在出错成本确实很低时，才值得切到更快的模式。
日常命令
cx # 在当前仓库启动 Codex
agy # 保留原来的 Antigravity CLI
agy-ide # 在当前目录打开 Antigravity IDE
agy-ide /path/to/repo # 打开指定仓库
agent-init # 预览共享 agent 脚手架
agent-init --apply # 审阅计划后再应用
ws # 使用工作区跳转助手
agy 保持原样。单独提供 agy-ide，可以避免含义模糊，也能明确指定打开的目录。
共享规则只有一个源头
个人默认规则位于：
$HOME/.config/agent-guidance/AGENTS.md
Codex 的全局 AGENTS.md 与 Antigravity 的全局 GEMINI.md 都是指向它的符号链接。
只需修改这一份规范，两个工具会同时得到更新。可复用的项目初始化工具也采用同样
的结构：
$HOME/Projects/agent-toolkit
├── 由 $HOME/.codex/skills/agent-toolkit 链接
└── 由 $HOME/.gemini/config/skills/agent-toolkit 链接
不要把共享说明复制进两套配置目录。某个工具独有的行为留在自己的配置中，真正 共享的行为才进入规范文件。
每个仓库一份契约
在 Git 仓库中运行 agent-init，先审阅 dry run，再决定是否应用。工具可以补齐：
- 作为项目规范唯一来源的
AGENTS.md； - 让 Antigravity 引用
AGENTS.md的.agents/rules/project-guidance.md； arch.md、.editorconfig和.gitattributes；- 针对 agent 状态、secrets、缓存与生成文件的安全忽略规则；
- 可选的 VS Code WSL zsh 配置。
项目命令、架构边界和完成标准应写在项目自身的 AGENTS.md。全局规范保持简短且
可移植。
便利与安全边界
这套 WSL 是私人、单用户环境，并且有意使用 root。在用户指定的仓库内，日常且
可逆的编辑、测试、构建和本地 Git 检查可以直接进行。
递归破坏性修改、force push、对外发布、改动无关仓库、暴露 secrets 或被忽略的 私人数据、修改 Windows 挂载盘或大范围系统目录，仍然需要明确确认。活跃工作区内 默认追求便利，但范围边界不会因此消失。
多 Agent 并行
不要让两个 agent 同时编辑同一个 checkout。独立任务应使用独立 worktree 和分支：
git worktree add ../project-codex -b agent/codex-task
git worktree add ../project-agy -b agent/agy-task
之后照常审阅并整合分支。Worktree 会让文件归属变得可见，也能避免 agent 悄悄覆盖 彼此的改动。
下次把内容放到这个网站
“把这个放到我的个人网站”会触发同一个网站管理 skill，它的唯一源文件仍保存在 网站仓库内。Codex 与 Antigravity 通过符号链接发现同一个源目录：
$HOME/my-website/.agents/skills/docusaurus-site-management
├── 由 $HOME/.codex/skills/docusaurus-site-management 链接
└── 由 $HOME/.gemini/config/skills/docusaurus-site-management 链接
无论 agent 当前在哪个目录，都应当：
- 打开
$HOME/my-website，检查 Git 状态与架构规则； - 新建文章前先搜索已有笔记；
- 在更新旧文、追加 Build Log 与新建聚焦指南之间选择；
- 去掉私人或只适用于单台机器的细节，并优先使用
$HOME路径； - 发布路径一致的中文、英文和法文版本；
- 检查多语言新鲜度，再按风险决定验证强度：普通 Markdown 可以到此结束，UI 或 结构变化再运行构建与浏览器检查。
这句话授权 agent 修改并验证本地网站内容，但 push 或部署仍然是另一项需要明确提出 的操作。
恢复方式
环境快照包含共享规范的唯一源文件，以及 agent toolkit 的 Git bundle；它会刻意 排除私钥、Shell secrets 和项目内容。恢复时先还原源文件，再重新建立链接，不必 备份重复副本。
周边环境的变更记录见构建日志。