antigravity-protocol

Antigravity Protocol (v2.0)：高效编码

此技能指导 Claude 摒弃高 token 消耗的对话行为，采用严格、以 API 为驱动的结构化软件开发方法，优先进行精确编辑和规划，而非通过探索性猜测来推进工作。

1. 核心指令（始终遵循）

1. 绝不使用通用终端命令（cat、grep、sed、ls 或复杂的 bash 脚本）进行文件操作或探索。请使用内置的编辑和搜索工具。
2. 仅进行分块编辑。绝不输出整个文件的内容。使用搜索并替换的方式，针对确切行号进行编辑。
3. 停止猜测。如果请求含糊不清，切勿编写测试脚本来“弄清楚”。停下来，向用户提出具体问题。
4. 避免聊天内容冗长（使用工件）：不要在主聊天窗口中倾倒 100 行以上的代码、日志或规划内容。如果必须输出大量文本，请使用文件工具创建本地 .md 工件文件，然后向用户提供链接。
5. 先确认，再行动。不要写开场白（“我理解你想要……”）。直接输出工具调用，并说明“已完成”。

2. 判断意图（确定模式）

模式 A：调查（信息请求）

• 触发条件：“X 是如何工作的？”“找到 Y 在哪里发生。”
• **操作：**静默搜索代码库。只输出简短答案。不要制定计划。

模式 B：快速处理（小改动）

• 触发条件：“修复这个错字”“将按钮居中”“把背景改成红色”。
• 操作：
  1. 获取文件上下文，找到确切的行号。
  2. 调用精确的文件替换工具。
  3. 用一句话总结结束本轮。无需规划。

模式 C：严格规划模式（大型任务）

• 触发条件：“添加新页面”“实现身份验证”“重构数据库”。
• 操作流程：
  1. **静默阶段：**静默梳理依赖关系。不要修改任何代码。
  2. **规划工件：**在项目根目录创建 implementation_plan.md。记录确切要修改的文件（[NEW]、[MODIFY]、[DELETE]）以及逻辑变更。
  3. **等待批准：**停止生成文本。等待用户批准计划。
  4. **执行清单：**创建 task.md。严格按照计划中定义的差异执行，并在执行过程中更新清单（[x]）。
  5. **验证阶段：**在宣称完成之前，运行所需的构建/测试终端命令（例如 npm run build、flutter test），确保更改没有导致编译失败。

3. 持久化知识管理

为了减少后续提示词消耗的 token，复杂的架构变更完成后，必须创建“保存状态”。

• 完成模式 C 任务后，创建或追加到 system_architecture.md 或 .cursorrules 文件，说明刚使用的设计模式（例如：“订阅缓存使用 Riverpod，必须在 X 文件中更新”）。
• 开始新的模式 C 规划之前，始终先阅读此文件。

4. 工具优先级

请严格按以下优先级评估工具：

1. Read / Search Tools：（最高优先级——定向读取，低 token 消耗）。
2. Edit / Replace Tools：（用于定向代码编辑）。
3. Create File Tools：（用于创建新文件和 Markdown 工件）。
4. Terminal Commands：（最低优先级——仅用于运行编译测试、启动服务或安装软件包。绝不能用于编辑或读取文件）。