本页内容

日常开发流程

把目标、约束和完成标准交给 Mica,在同一条会话中持续推进。任务变长后,用笔记保留决策,按需要分出探索、审阅或独立子会话。

想先跟着完整例子操作,可以从实战演示开始:创建隔离项目,逐步审查、修改并验证。

完成一次开发任务

从项目目录开始,让 Mica 能读到相关代码与 AGENT.md、AGENTS.md。 一个可执行的请求应说明要解决的问题、需要保留的约束,以及怎样判断已经完成:

TEXT
修复登录失败后页面一直显示加载中的问题。
先阅读项目约定,定位请求与状态更新的调用链,再做修改。
保留现有工作区改动,优先沿用已有组件与测试方式。
完成后验证成功、失败和重复提交三种情况,汇报改动与验证结果。

探索:先确定问题发生在哪里

给出报错、复现步骤、相关文件或期望行为。让 Mica 先阅读项目约定、搜索调用点,再说明问题原因与修改范围。 需要查证框架或 API 的当前行为时,可要求查阅官方资料;联网搜索的配置见 Web Search。

目标仍不明确时,可以先限定“只分析并给出方案”。确认方向后继续在同一会话要求实现,已经找到的代码与约束能作为后续工作的背景。

修改:明确范围与取舍

说明哪些行为必须保留、是否允许改接口,以及哪些文件已有其他工作。涉及多处修改时,让 Mica 按依赖推进,及时报告遇到的新约束。 项目长期遵循的规范适合写入项目指令,重复使用的专项流程适合做成 Skill。

验证:检查实际行为

要求运行与改动相匹配的检查,并报告真实结果,例如相关测试、类型检查或构建。 界面改动还应在实际页面检查交互、窄屏布局与错误状态。验证受环境或凭证限制时,让 Mica 说明尚未覆盖的部分。

开发服务器、监听任务与长构建需要单独管理生命周期。可以让 Mica 启动后台任务、读取输出并等待就绪,完成验证后收尾。

审阅:把交付物与证据对上

查看最终 diff,确认修改范围、行为变化与验证结论一致。需要独立视角时,让审阅子代理检查正确性和回归风险,再由主会话处理发现。 收尾时要求列出改动、验证结果和剩余问题,方便继续工作或准备提交。

Git Commit 插件会实际暂存并提交整个仓库的变化,还可按设置推送。使用前先核对工作区与插件设置,操作入口见 插件与能力管理。

运行中补充、撤回与停止

Mica 工作时仍可以补充条件,例如“还要覆盖空输入”或“沿用现有错误提示”。运行中的输入会排队,在后续迭代边界交给模型;是否已经被接收,以界面状态为准。

目的操作生效边界
补充要求输入后按 Enter、Tab 或 Shift+Tab。运行中进入队列;若本轮正常结束且未再迭代,会接着启动下一轮。
改写尚未发送的补充输入框为空时按 Shift+← 撤回;桌面端也可双击排队消息。只对仍在队列中的内容有效,已经交给模型的消息无法撤回。
停止当前执行桌面端使用停止按钮;终端运行中按 Ctrl+C。中断当前轮次,已经执行的文件修改或外部操作仍然存在。

桌面端停止时会尝试把排队内容放回输入框。本轮失败或被中止后,尚未消费的输入会保留,仍可撤回检查。 如果要改变正在执行的方向,可以先停止,再给出新的要求。

恢复历史、尝试分支与回退

需要做什么入口得到什么
继续已有任务桌面端打开历史会话;终端执行 /resume。恢复保存的上下文与会话状态。终端也会切到会话原来的工作目录,目录缺失时会提示。
保留原思路,试另一条路线桌面对话菜单中的 Fork;终端执行 /fork。新会话继承已有上下文,后续对话独立推进。
回到某一轮结束时终端执行 /rewind,选择回退点与范围。保留所选输入及该轮回复,移除之后的对话;文件能否恢复取决于该点是否有可用快照。

终端还支持 /fork 任务描述,从分叉上下文后台执行指定任务。源会话正在运行时,终端分叉取本轮开始前的历史。 分叉不会创建 Git 分支或独立工作区;两个会话仍可能修改同一批文件,需要另行划分范围或使用独立工作区。

回退前先阅读文件影响预览。由旧对话恢复的回退点可能只有对话,没有历史文件状态;也可以主动选择只回退对话、保留当前文件。 回退无法撤销已经发生的推送、数据库变更等外部操作,长期版本管理仍应使用 Git。

桌面端编辑并重新发送历史用户消息,会从该输入之前重新组织模型历史。重新提问前应检查当前文件,因为重跑对话本身不会还原工作区。

让长会话保留有效上下文

上下文占用会随对话、工具输出与附件增长。压缩用于清理或概括发给模型的历史,界面中可见的对话记录仍会保留;模型后续能直接使用的细节则可能减少。

  • 快速压缩:终端 /compact 或桌面端的快速压缩。本地清理工具结果、较长参数正文和媒体内容,不调用模型。
  • 模型压缩:终端 /compact llm 或桌面端的模型压缩。请求模型生成摘要,再据此继续任务,会产生模型请求。
  • 自动压缩:Auto Compact 插件在请求之间检查占用,按阈值先尝试本地清理,必要时生成模型摘要。

自动压缩的阈值、次数、同一轮内的最小间隔及摘要模型都可配置,也可按会话覆盖。 桌面端还支持空闲一段时间后重新输入时先做快速压缩;压缩期间发送的内容会显示为等待状态,并可撤回。 自动压缩策略用于常驻会话,在 mica exec 的一次性运行中跳过。

会话笔记与跨会话记忆

保存方式适合记录生命周期
Session Notes 会话笔记本任务目标、已确认方案、验证进展和待办事项。随会话保存,恢复与分叉时沿用,回退时随回退点恢复;压缩不会改写它。
Memory 跨会话记忆沟通偏好、长期环境事实和当前项目中可复用的经验。存为独立 Markdown 文件,供其他会话读取;压缩、分叉与回退不会撤销已经写入的记忆。

启用 Session Notes 后,可以在桌面笔记面板编辑,也可以要求 Mica 更新会话笔记。Memory 将用户档案、通用经验与项目记忆分开保存,项目记忆跟随工作目录。 可让 Mica 读取或修订记忆,终端的 /memory path 可以查看文件位置。

Memory 的提示词内容在会话内保持快照,新写入的记忆通常供下一会话使用;终端执行 /memory refresh 可让当前会话重新读取。 自动整理会产生额外模型请求,可在插件设置关闭或调整。需要团队共享的正式约定,仍应写进仓库中的项目指令或 Skill。

选择合适的协作方式

方式适合的工作需要交代什么
Subagent 子代理主任务中的并行探索、独立审阅、明确范围的实现或测试。目标、必要背景、输出要求;可写任务还要分配文件范围。结果由主代理验收并汇总。
Sidecar 子会话需要独立上下文、单独保存历史,并可能连续追问的完整任务。子会话看不到主对话,需明确工作目录、约束和验收方式;它会出现在会话列表中。
By The Way 旁问主任务继续时,解释术语、确认一个细节或探索旁支问题。基于主对话背景提问;回答留在旁问中,需要用于主任务的结论应再明确补充给主会话。
TEXT
把这次检查拆成两个只读任务:
一个检查 API 的错误返回,一个检查前端的加载状态。
分别给出文件位置、触发条件和影响,再由主会话汇总结论。

终端用 /task 查看子代理任务,桌面端可打开子代理任务详情。Sidecar 可以由主代理继续发消息、查看进度、停止当前轮或关闭进程;关闭进程后已保存的会话历史仍保留。 子代理任务跟随发起轮次收尾,Sidecar 进程随父会话退出而关闭。两者都可能操作同一工作区,应避免并发改同一文件。

桌面端从 By The Way 抽屉旁问;终端使用 /btw 问题,以 /btw -continue 追问 延续话题,/btw -stop 停止旁问。 旁问隔离的是对话上下文,涉及文件或命令时仍应说明操作范围。协作能力的启停与委派倾向见 插件设置。

安排定时任务

适合定期检查构建、日志或其他持续变化的结果。桌面端从会话设置的“定时任务”填写间隔与任务内容;终端使用:

TEXT
/loop 30m 检查构建结果,只汇报新增失败和需要处理的变化
/loop status
/loop stop

首轮会立即执行,省略间隔时默认每 30 分钟一次。任务应写清检查范围、汇报条件和允许的操作;每次触发都可能产生模型与工具调用。 当前会话忙时会跳过该次触发,避免不断堆积。

终端循环随 TUI 进程结束;桌面端由运行时调度并保存循环状态,运行时需要保持在线,重启后只补一次到期任务。 停止当前回答后,如需取消后续触发,还要在面板停止循环或执行 /loop stop。

查阅 命令与快捷键 了解操作入口,或继续阅读 自动化与协议,把一次性任务接入脚本。

文档随项目持续更新编辑此页