Skip to main content
Comet Native 可以直接接收文件、附件、PRD 链接或本地文档，并把其中的需求转换成可执行、可验收的完整目标 Spec。文档已经回答了目标、范围、行为和失败路径时，Native 无需再重复逐题澄清。你确认最终需求摘要后，它会进入 Build，继续完成实现、检查、独立验收和归档。 这条路径让你自由选择需求如何形成。你可以使用 Native 自带的 Sequential 或 Batch 澄清，也可以先用 Grill me with docs 等方式完成深度讨论，再把产出的文档交给 Comet。Native 负责把已有结论接入稳定的长程执行流程。

​
一份文档可以直接成为 Native 的需求入口

你可以通过多种形式提供需求： 启动时直接说明文档的用途：
提供链接时也可以直接表达目标：

​
Native 会把原文转换成正式需求

Native 不会只保留一段摘要。它会按标题、段落、列表、表格、代码块、示例、约束和链接拆分来源，并将每个单元记录为：
  • complete：内容已完整读取并完成归类；
  • partial：只读取了一部分，仍可能遗漏有效要求；
  • unavailable：当前平台或权限无法读取。
随后，Native 会生成并同步三类正式内容： 需要实现的来源单元必须进入完整目标 Spec，并关联至少一个验收项。背景信息和非目标仍会保留分类与原因，但不会被误写成实现任务。新文档修正旧要求时，Native 会把旧单元标记为 superseded，并指向新的有效结论。

​
文档充分时跳过逐题澄清

Native 会先调查仓库、工具和运行环境中可以确定的事实。完成来源映射后，如果同时满足以下条件，它不会开启 Sequential 或 Batch 问答：
  • 所有可访问内容已经完整读取；
  • 每项有效要求都已经进入 Spec 和验收范围；
  • 文档对目标、范围、默认行为和失败结果给出了唯一可执行解释；
  • 文档内部没有互相冲突的要求；
  • 仓库事实和项目规则没有暴露新的用户选择；
  • 没有 partial、unavailable、未映射或待确认的阻塞项。
此时，Native 已经完成需求理解和 Spec 生成，可以跳过逐题澄清，直接展示最终需求摘要。摘要包含目标、范围、关键决定、验收项和非目标。你明确确认后，Runtime 才允许 Change 进入 Build。
“跳过澄清”指跳过没有必要的提问轮次。最终需求确认仍然保留，它确保 Native 生成的 Spec 与你投递的文档一致，再把长程执行交给 Runtime。

​
文档有缺口时只追问缺口

文档很长不代表需求已经完整。以下情况会形成 [blocking]：
  • 链接需要登录，当前 Agent 无法读取；
  • 文件损坏、格式无法解析或只读取到部分内容；
  • 两个章节对同一行为给出不同结论；
  • “支持失败重试”等表述缺少会改变用户结果的具体语义；
  • 有效要求尚未映射到 Spec 或验收项；
  • 材料可能只是调试证据、评审参考或实现资料，需求用途不明确。
Native 只围绕这些缺口提问。它不会重新询问文档中已经明确的内容。问题解决后，答案会立即写入 brief.md、完整目标 Spec 和验收项，再进入最终确认。 如果链接无法访问，最直接的处理方式是把原文导出为文件并投递给当前会话。摘要无法代替完整来源，因为被省略的表格、示例或限制条件仍可能改变最终行为。

​
使用 Grill me with docs 完成你偏好的澄清

Native 的澄清协议适合从一个目标逐步形成需求。如果你更喜欢 Grill me with docs 的高强度追问，可以先在它的对话中讨论产品决定、失败路径、隐含假设和非目标，并生成一份完整文档。 随后把文档交给 Comet：
Comet Native 不依赖 Grill me with docs，也不会要求外部文档采用 Comet 专有模板。它把文件内容视为需求来源，检查覆盖、歧义和验收完整性，再接管后续流程。因此，你可以替换前置澄清方法，同时继续使用 Native 的 Runtime、状态恢复和验证门禁。

​
把 Native 作为长程任务执行器

文档确认后，你可以把注意力从“如何推进流程”转回最终结果。Native 会继续处理：
  • 创建或绑定分支、worktree 和 Change 工作区；
  • 根据 Spec 自主选择实现方法，并持续维护任务进度；
  • 运行必要检查，提交可验证的 Builder 候选；
  • 启动新的只读 Verifier，对照验收项检查真实结果；
  • 验收失败时返回 Build 修复，并重新验证受影响范围；
  • 在会话中断、上下文压缩或设备切换后，从项目中的稳定状态恢复；
  • Verify 通过后完成 Archive 和已确认的交付动作。
你仍会在新的用户选择、无法访问的需求来源、执行阻塞或最终交付决定上收到提示。普通实现选择、状态推进和恢复工作由 Agent 与 Runtime 处理。

​
根据需求成熟度选择入口

Native 提供澄清能力，也接受你已经形成的需求。你可以让 Comet 从一句目标开始，也可以让它从一份成熟文档开始；两条路径最终都进入同一套可恢复、可验收的长程执行流程。 继续阅读：哪些决定需要你确认、Sequential 与 Batch 澄清、Native Loop 和 连续推进与稳定恢复点。
最后修改于 2026年8月31日