把 Motux Build
用在你的项目里。
Motux Build 把产品澄清、开发标准、质量检查和协作经验交给编程 Agent 使用。你仍在原来的编程工具里提出任务；这份手册帮助你选对入口、说清需求，并判断每一步是否完成。
读前说明
这份手册以普通使用者为主，共 9 章、42 项功能与使用说明。大多数示例是交给 Agent 的自然语言请求；技术术语和路径集中在附录。开发标准、可执行管理工具和独立模块的前提会分别说明。
Core 1.0.98 · Manager 0.1.29 · Brief 0.1.10 · joint-delivery 0.1.0。底座代码能力自 Plugin 1.0.40 提供；具体安装版本以官网发布清单为准。
安装与第一次使用
先选择安装范围，再确认当前项目实际使用哪一份 Build。
- 认识产品的四个部分分清标准、管理工具、表单和独立模块各自负责什么。
- 安装到 Codex 用户范围一份插件供多个 Codex 项目按需使用。
- 为项目启用或停用插件决定当前项目使用用户级 Build，或暂时停用。
- 只在当前项目安装获得完整、可锁定版本的项目内 Build。
- 检查安装与加载状态区分已经放入文件和实际开始使用。
- 单独使用 Motux Brief只需要需求表单时，不必接入完整 Build。
已有项目与多个工具
把现有规则接入同一套工作方式，并保留项目自己的决定。
- 接入已有项目先盘点已有代码、约定和入口，再确定接入范围。
- 融合规则与项目例外保留已有约定，同时让通用标准可以继续升级。
- 接入其他编程 Agent让同一个项目中的不同工具读取同一份标准。
- 后续 Agent 策略与入口维护选择何时配置新工具，并检查或移除旧入口。
需求梳理与产品决策
从想法到明确的第一版，使用 Brief 一次处理相关问题。
- 澄清目标与收敛 MVP决定第一版必须做什么，以及暂时不做什么。
- 全面产品问卷把新产品的大量相关问题整理成分组表单。
- 聚焦决策表单只解决当前阶段的一组关键选择。
- 保存、继续填写与落地决策让表单答案成为项目中可读取的决定记录。
开发、测试与交付
把标准用在真实任务上，知道 Agent 应当产出什么证据。
- 新产品工程初始化在确认产品方向后建立可运行的工程起点。
- 技术选型与架构边界围绕当前需要做取舍，不为假设中的未来堆叠架构。
- 界面、交互与前端实现从用户操作流程到完整状态和真实浏览器验证。
- API、数据、权限与服务集成把成功路径与失败、重试和权限一起设计。
- 按风险选择测试与回归用测试证明功能目标，控制无关测试成本。
- 代码审查与独立 QA让已冻结的改动接受另一轮有范围的检查。
- Git、版本与交付说明让改动可以追溯、审阅和回退。
任务推进与经验复用
在多阶段工作中保留决定、分配职责，并按需读取标准。
- 按任务读取需要的标准简单任务保持轻量，复杂工作分阶段推进。
- 并行开发与集中验收在宿主支持时让多个 Agent 按明确边界合作。
- 项目记忆、检查点与交接换任务或换 Agent 后仍能继续已确认的工作。
- 复盘与经验回流把反复出现的问题整理为可复用规则或模块。
独立能力模块
按需安装工作方法，在兼容范围内单独更新。
- 检查与安装独立模块增加一份经过校验的工作方法。
- 启用、固定版本与停用决定哪个项目实际使用已安装模块。
- 单独更新与回退模块更新所选内容，保留其他模块和已有任务。
- 处理中断与锁冲突在不猜测原始状态的前提下恢复模块事务。
- 联合开发统筹模块把多个项目连成一个可联合验收的业务流程。
第三方 Skill 管理
在明确能力缺口时推荐工具，并按选择安装和维护。
- 推荐、跳过与抑制推荐让专用工具在有帮助时出现。
- 安装已选择的 Skill校验固定来源后复制明确的 Skill 内容。
- 检查、更新和移除 Skill保留修改痕迹，按精确内容管理已安装工具。
更新、体检与恢复
根据安装范围更新正确的一份 Build。
- 只读检查更新先看哪些版本可用，再决定是否应用。
- 更新或修复本机插件让共享 Codex 插件使用已验证的正式版本。
- 一次完成合格的项目补丁更新所有固定条件满足时，用短指令完成更新。
- 按组件计划更新处理需要明确选择和预览的项目更新。
- 体检、修复判断与项目回退在出现异常时先定位，再选择恢复方式。
- 旧布局与早期 Motux Dev按实际历史版本选择专门的迁移路径。
附录与问题排查
需要时再查术语、目录和故障处理。
- 自然语言与命令名称把示例交给 Agent，不必安装一个 motux 全局 CLI。
- 文件归属与术语知道资料存在哪里，什么不该直接改。
- 常见问题的最短处理路径从现象出发，避免反复重装。