Motir 的工作方式

[01] AI 规划

从一句提示到一份计划

从一句话、一个代码仓库，或从 Jira、Linear 或 Plane 导入开始。规划器会读取已有的一切，包括你代码仓库的代码图谱，并在需求含糊的地方追问。

它会起草篇章、故事、任务和子任务，每一项都有类型、执行者、规模以及它的 blocked_by 依赖关系。在你看到之前，validate_plan 会先检查整棵树。

[02] 你 · 计划关口

计划由你批准

在有人批准计划之前，什么都不会进入面板。用平常的话提出修改；每一轮都是新的一次对话，计划的历史会保留每一个版本以及修改的原因。

[03] 工作项

面板

批准后的计划会变成工作项，配有 Sprint、待办列表和路线图。每个工作项的执行者是 agent 或 human。

手动任务（一个账户、一个密钥、一条 DNS 记录、一次发布签核）由 motir guide 一步一步地引导完成。

[04] 智能体运行

智能体负责构建

智能体领取下一个就绪的工作项（motir next 或 motir run <KEY>），认领它，在自己的分支上构建，并为每个代码仓库开一个拉取请求，关联到该工作项。

它在自身工作项之外发现的缺陷不会让运行停下：智能体会找出根本原因，用 motir log bug 把它作为一个独立的工作项登记到缺陷文件夹，然后继续工作。

每次运行都会记录智能体的运行框架、模型、每一个步骤和结果。智能体通过 MCP 连接，可以在你的机器上，也可以是 Motir 的托管智能体。

[05] 你 · 合并关口

由你审阅并合并

工作项进入 Implemented，智能体发布测试方法。故事会附带一段在 CI 中录制的验收视频。由你审阅、批准并合并；合并即关闭该工作项。没有人的参与，任何东西都不会进入 Done。

[06] 修复

当运行出错时

变红或存在冲突的拉取请求会用 motir fix 在它自己的分支上修复，最多尝试五次。中断的运行（笔记本合上了、沙箱丢失了）会用 motir continue 在它留下的分支上继续。

途中登记的缺陷会在缺陷文件夹中等待；motir fix bugs 会从最早的开始逐一处理。

[07] 学习循环

规划器在学习

无法构建某个工作项的智能体，会先确认它是否仍是已批准的计划所批准的内容（get_approved_shape_verdict），这样后来的修改就不会被归咎于规划器。如果是计划有误，它会被重新规划，变更连同原因一起被记录下来。

这次失误会成为一条经验，或强化已有的经验；如果没有规则可以覆盖，就登记一个规划缺陷。下一份计划会先读取这些经验。90 天内没有再出现的经验会退役。

[08] 记忆

项目会记住一切

设计、决策页面、文档、经验、计划修订以及每次运行的历史，都与工作项放在一起。你、新加入的队友或下一个智能体，即使几个月后接手项目，也无需任何人再解释一遍。