TraceStudio-dev/docs/ai/ai.md

🧬 TraceStudio AI 协作开发流程

这是一套 AI 方法论。我需要你对这套开发流程进行验证。

本手册旨在指导创作者如何驱动 Gemini (架构师) 与 Copilot (工程师) 协同完成 TraceStudio 的功能开发。

---

🛠️ 第一部分：通用协作规则

1. 分权原则：Gemini 负责“为什么做”和“逻辑协议”；Copilot 负责“怎么做”和“代码落地”。
2. 文档驱动：所有开发动作必须始于文档输入，终于逻辑资产。
3. 闭环反馈：当工程遇到阻碍，由 Copilot 输出报告，Gemini 提供方案，创作者做最终决策。

🎨 第二部分：TraceStudio 标准创作流程

阶段 A：初始化与基调设定

1. 开启一个 Gemini 会话，输入 gemini.md。
2. 此时 Gemini 进入“TraceStudio 专家模式”，等待你的功能构思。

阶段 B：功能设计与协议讨论

1. 构思输入：向 Gemini 描述你的分析需求或逻辑痛点。
2. 深度讨论：Gemini 会依据“原子化算子”和“ComfyUI 风格”与你博弈，最终达成一致。
3. 输出物：Gemini 会产出一份 《Copilot 开发指导手册》。

阶段 C：工程实现与落地

1. 开启一个 Copilot 会话，确保其已阅读 copilot.md（了解项目结构与规范）。
2. 输入指令：将 Gemini 产出的《指导手册》发送给 Copilot。
3. 代码生成：Copilot 根据手册中的契约和路径进行代码编写。

阶段 D：异常处理（可选）

1. 若 Copilot 在开发中遇到技术瓶颈或架构冲突，要求其按 copilot.md 规范输出 《问题诊断报告》。
2. 将该报告反馈给 Gemini，进入问题讨论环节。

---

💡 核心信条：不要让 Gemini 写工程，不要让 Copilot 定架构。