开始使用03 / 16
完成第一次工作流
本页内容
这篇教程以“连续打卡奖励”为例，带你写下第一条意图、检查或实现它，再把新的决定写回文档。你会学习如何根据项目中的实际代码和验证结果，判断这条要求是否得到满足。
准备一个 Agent 已就绪的 Noea，以及一个你愿意继续开发的本地项目。如果项目与打卡无关，可以把示例替换为其中一条同样具体的规则。
打开代码项目
点击工作台中的“打开文件夹…”，或选择“文件 → 打开实现文件夹…”，选中代码所在的文件夹。
第一次打开该代码目录时，Noea 会创建关联的项目。已有项目时直接打开，存在多个关联项目时先选择一个。其他打开方式见打开与管理项目。
留下第一条意图
点击侧栏“新建意图”，命名为“连续打卡”。应用会补上 .noea.md 后缀并打开文档。写下：
# 连续打卡
用户每天可以完成一次打卡。连续打卡满 7 天，给用户一个奖励。
按 macOS 的 ⌘S，或 Windows / Linux 的 Ctrl+S 保存。不要急着列出所有边界条件，先保留你已经决定的内容。
选择调查或实现
“解释”用于检查项目中需要更新说明的内容；段落旁的“调查”只检查选中的一段。它们都会查看实现并生成或更新说明，不负责修改代码。
如果项目已经有打卡功能，点击侧栏“解释”。你也可以把鼠标移到这段文字上，在左侧点击“调查”，只检查这一段。
如果这条规则还没有实现，新建对话，在输入框中使用 @ 选择刚才的意图文档，再发送：
请根据引用的意图，在当前项目里实现连续打卡奖励。先检查现有代码，沿用项目的结构，并验证连续 7 天和中断打卡这两种情况。
侧栏提供“实现”按钮时，也可以用它开始工作，具体见让 Agent 推进实现。运行时，对话会显示回复、工具调用和文件变更。
实现结束后，如果没有自动开始解释，请手动点击“解释”。普通对话中的代码修改并不都会触发自动解释。
阅读一段实现说明
回到意图文档，点击段落内文字之外的空白，打开旁注。依次阅读：
- 实现：当前代码怎样累计连续天数、怎样发放奖励。
- 依据：说明引用了哪些代码、命令输出或测试材料。
- 关注：有没有缺口，以及需要你判断的实现选择、风险或建议。
例如，你可能发现实现按设备时区划分自然日。这里要确认的是项目实际采用了什么口径，以及这个口径是否符合你的要求。打开相关引用，检查证据支持到了哪一步。
解释完成不代表重新运行过测试。阅读“依据”时，注意区分测试代码、历史结果和本次验证；详细方法见阅读实现说明与证据。如果实现不符合原要求，应先修复实现，而不是为了迁就代码改变规则。
追问并写回一个决定
悬停该段落，在左侧选择“就此提问”。Noea 会把段落引用放进对话输入框，等你补充问题后再发送：
现在的实现如何处理跨时区旅行？如果用户在两地打卡，会不会影响连续天数？请结合代码说明。
理解结果后，如果你决定约束计算方式，再发送：
将“一天按用户当前所在地的自然日计算”写入这条意图。请先提出意图变更，供我审阅。
Agent 提交提议后，点击“查看更改”，阅读新增与替换的文字。需要调整时，直接编辑提议中的新文字，再点击“接受我的编辑”；无需修改则点击“接受”。
如果提议仍需实现，接受后会在原对话中继续推进；如果现有实现已经满足它，则不需要再安排一次实现。随后检查解释任务的结果，必要时手动调查。
检查这次工作的结果
结束前，保存文档，确认说明对应的是当前文字，再试着用自己的话回答四个问题：
- 这条要求目前怎样实现，哪些依据支持这个结论？
- 哪个重要选择原先没有写在意图里，而是由 Agent 作出的？
- 我是否理解并接受这个选择，是否需要把它变成长期约束？
- 下次想改变这项行为，我应该修改哪句话？
例如，你能说明目前怎样划分一天，找到相应依据，并指出“满 7 天”决定了奖励条件。某个回答还不清楚时，就从对应段落继续提问。
你不需要在第一次使用时写完所有规则。下一次发现值得保留的决定，再沿着相同流程补充即可。