Agent 会话

会话是你和 Agent 协作的主界面。你描述目标，Agent 读取代码、运行命令、编辑文件并汇报结果。

写清楚任务

一条有效任务通常包含四类信息：

如果任务较大，可以让 Agent 先调研并给出分阶段结果，再继续实现。

任务执行中

Agent 工作时会持续更新进度。你可以：

• 补充新的要求。
• 指出当前方向的问题。
• 要求暂停、继续或改目标。
• 要求先提交当前改动。

如果新消息和旧任务冲突，最新消息会优先生效。对于长任务，建议在关键节点确认目标是否仍然正确。

模型和 Agent 配置

North Coder 支持按会话或配置选择不同 Agent 能力。常见调整包括：

• 模型。
• 推理强度。
• 上下文预算。
• Agent profile。
• 子 Agent 或技能能力。

日常代码改动通常使用默认配置即可。复杂调研、大规模重构或高风险改动，可以提高推理强度或使用更适合的 Agent profile。

RFC Mode

RFC Mode 是面向“先设计后实现”的 Agent profile。它会先澄清需求、阅读代码、整理设计决策，再生成正式 RFC 文档和可执行子任务。

适合使用 RFC Mode 的任务：

• 新功能或跨模块改动。
• API、数据模型、权限或安全相关变化。
• 需要拆成多个实现阶段的工作。
• 需求还不够明确，需要先把取舍写清楚。

RFC Mode 生成的 RFC 可以在 RFC View 中查看元信息、依赖和子任务状态，也可以直接从子任务表启动实现会话。完整流程见 RFC Mode。

Plan Mode

Plan Mode 是面向“先探索再执行”的 Agent profile。它不会直接修改项目文件，而是先只读理解代码库，然后生成一份可审阅的实现计划。

适合使用 Plan Mode 的任务：

• 需求已经基本明确，但实现路径不确定。
• 想在执行前先看到改哪些文件、按什么步骤做、如何验证。
• 想把探索和执行拆成两个上下文，减少长任务里的上下文干扰。
• 不需要正式 RFC，只需要一次性的实施计划。

Plan Mode 提出计划后，界面会显示 Hand Off 和 Approve。Hand Off 会在新会话中执行计划；Approve 会在当前会话中继续执行。完整流程见 Plan Mode。

上下文与压缩

长会话会累积大量上下文。上下文过长时，系统可能进行压缩，以便继续保留关键任务信息。

为了降低误解风险，可以在长任务中周期性补充：

• 当前目标。
• 不要修改的范围。
• 已经确认的决策。
• 下一步希望 Agent 做什么。

处理验证结果

Agent 通常会在完成改动后运行相关检查。你可以要求它明确说明：

• 运行了哪些命令。
• 哪些命令通过了。
• 哪些命令失败以及原因。
• 是否存在未验证的风险。

如果测试失败，优先让 Agent 根据失败日志修复，而不是直接合并当前改动。

什么时候拆分任务

建议拆分的情况：

• 一个任务横跨多个不相关模块。
• 改动需要多人 review。
• 需要先调研再设计。
• 当前工作区已经有大量未提交改动。
• 验证路径很长，需要分阶段落地。

拆分后，每个工作区和 PR 都会更容易审阅和回滚。