AI 工作流：grill-with-me → comet

工作流概述

这是一条从上下文整理到技术方案执行的 AI 工作流：

1. 使用 grill-with-me 汇总并审视项目上下文。
2. 将整理后的上下文转化为 技术方案提示词.md。
3. 将 技术方案提示词.md 交给 comet 执行。
4. 总结本轮执行结果，并将稳定信息落地到 docs/context/。
5. 在下一轮工作中复用已经沉淀的 Context，形成迭代闭环。

输入上下文

grill-with-me 的输入可以包括：

• rules：项目约束、编码规范和协作规则。
• PRD：产品目标、用户需求和验收标准。
• 原型 HTML：页面结构、交互方式和视觉参考。
• 其他必要资料：现有代码、接口文档、数据结构、错误信息等。

Mermaid 流程图

flowchart TD
    A[收集项目 Context] --> A1[Rules]
    A --> A2[PRD]
    A --> A3[原型 HTML]
    A --> A4[其他资料：代码、接口、数据、错误信息]

    A1 --> B
    A2 --> B
    A3 --> B
    A4 --> B

    B[grill-with-me<br/>澄清目标、识别约束、追问风险] --> C[整理为技术方案提示词.md]
    C --> D[comet<br/>读取并执行技术方案]
    D --> E[实现结果：代码、配置、测试与验证]
    E --> F{是否符合预期？}
    F -->|是| G[总结本轮结果]
    F -->|否| H[记录问题与新增 Context]
    G --> I[沉淀 docs/context/]
    H --> I
    I --> J[下一轮 grill-with-me]
    J --> B

两个阶段的职责

grill-with-me：整理与推演

grill-with-me 负责把分散的上下文变成可执行的技术方案提示词，重点包括：

• 明确目标、范围和成功标准。
• 找出需求中的歧义、遗漏和潜在风险。
• 结合 rules、PRD 和原型 HTML，补齐实现约束。
• 拆分任务、定义实现顺序和验证方式。
• 输出结构清晰、可直接交给执行型 Agent 的 技术方案提示词.md。

comet：执行与验证

comet 负责根据技术方案提示词推进实际工作，重点包括：

• 理解方案中的目标、边界和验收标准。
• 修改代码、配置或文档等项目文件。
• 执行测试、构建和必要的验证。
• 汇报实现结果、未解决问题和需要补充的上下文。

关键产物

技术方案提示词.md 是两个阶段之间的接口。它至少应包含：

• 背景与目标
• 输入上下文及其来源
• 范围与非目标
• 技术方案和关键设计决策
• 任务拆解与执行顺序
• 验收标准
• 测试与验证方式
• 风险、假设和待确认事项

完成后的总结与 Context 落地

每轮 comet 执行完成后，都需要先总结本轮结果，再决定哪些信息应沉淀到 docs/context/。Context 是供后续工作复用的稳定事实和决策，不是一次性执行日志。

总结内容

本轮总结至少包括：

• 本轮目标与实际完成情况。
• 关键代码、配置、文档或原型变更。
• 测试、构建和其他验证结果。
• 已确认的技术决策、约束和实现模式。
• 未解决问题、风险和下一步行动。

落地规则

1. 将已经验证、后续仍会复用的信息写入 docs/context/。
2. 为 Context 文件使用清晰、稳定的主题命名，例如 docs/context/ai-workflow-grill-comet.md。
3. 记录结论的来源或关联产物，避免只保留脱离背景的结论。
4. 将临时日志、一次性尝试和未验证假设留在本轮方案或执行记录中，不直接升级为稳定 Context。
5. 如果新结果推翻旧结论，应更新原 Context，并明确变更原因和影响范围。

Context 的复用方式

下一轮 grill-with-me 开始前，先读取相关 docs/context/ 文件，将其中的稳定约束、历史决策和已知问题作为输入；comet 执行时则以最新的 Context 和新的 技术方案提示词.md 为准。

使用原则

• grill-with-me 关注“想清楚并说明白”。
• comet 关注“按方案实现并验证”。
• 每轮完成后先总结，再把稳定结论落地到 docs/context/。
• 方案提示词应保持可执行，避免只描述愿景而缺少验收标准。
• 执行中发现的新问题应回写到 Context，再进入下一轮推演。