安装与第一次使用
先选择安装范围，再确认当前项目实际使用哪一份 Build。
认识产品的四个部分
#分清标准、管理工具、表单和独立模块各自负责什么。
能帮你完成什么
Core 是产品、工程和协作标准及任务路由；Manager 管理安装、规则接入、校验、更新和回退；Brief 生成本地需求决策表单；独立能力模块补充特定工作方法。Codex Plugin 把前三者打包为一个入口，joint-delivery 等模块另行安装。标准帮助 Agent 做判断，不能保证模型每次正确，也不会替你购买服务、创建账号或自动部署。
使用前
你已经有可以读写项目文件的编程 Agent。使用它的模型、权限和工具仍由原宿主提供。
怎么使用
- 先选安装范围：多个 Codex 项目共享插件，或只在一个项目保存完整组件。
- 安装后明确当前项目是否启用，检查安装来源和版本。
- 在任务中说出目标、限制和验收方式；需要专门功能时，直接提出本手册中的请求。
试着这样对 Agent 说
请解释当前项目使用的 Motux Build 来源和版本，并告诉我产品澄清、开发实现、模块管理分别该怎样开始。先只读检查。如何判断完成
- 得到明确的安装来源、可用组件及下一步入口。
- 知道“开发指导流程”由 Agent 执行，“管理操作”需要对应的 Manager 能力。
适用边界
- Build 不是托管开发平台，也不是自带业务系统的脚手架。
- 本手册中的示例是演示任务，不是已经完成的客户案例。
安装到 Codex 用户范围
#一份插件供多个 Codex 项目按需使用。
能帮你完成什么
适合主要使用 Codex、希望统一维护 Build 的用户。插件中保留只读运行文件，每个项目保留自己的选择、文档和任务记录。以后更新这份插件，全局启用的项目在新任务中使用新版。
使用前
本机已安装支持 Plugin 的 Codex，并允许安装插件。下载需要网络；安装先校验公开清单中的版本、大小和 SHA-256。
怎么使用
- 在 Codex 中提交下面的请求，明确选择用户级范围。
- Agent 核验来源，使用固定的 motux marketplace 安装 motux-build@motux。
- 首次安装时查看启动 Hook 的准确内容，在 Codex 中决定是否信任；随后新开任务并为项目选择使用方式。
试着这样对 Agent 说
请按 https://motux.app/motux-build/instructions/install-motux-build.md 安装 Motux Build。我选择 Codex 用户级范围。校验正式包后安装 motux-build@motux，并说明启动 Hook 和验证结果。如何判断完成
- Codex 插件列表中出现一份已安装、已启用的 motux-build@motux。
- Agent 报告实际版本；新任务能发现 motux-build Skill。
适用边界
- 插件安装不会自动把所有项目设为启用。
- 未信任 Hook 时仍可显式调用 motux-build，但不会自动询问新项目。
- 用户级插件仅面向 Codex；多种 Agent 共用同一项目时选择项目内安装。
为项目启用或停用插件
#决定当前项目使用用户级 Build，或暂时停用。
能帮你完成什么
首次打开尚未选择的项目时，你可以使用已安装插件、安装完整项目副本，或禁用 Build。选择使用插件只记录项目的最小配置；选择禁用会停止自动加载，并保留已有项目资料。
使用前
已安装 Codex 用户级插件；当前项目没有优先级更高的项目内 Build 安装或配置冲突。
怎么使用
- 打开目标项目，明确说“在这个项目使用已安装的 Motux Build 插件”。
- 让 Agent 确认分类为 user；之后在新任务中通过同一插件使用规则。
- 如需暂停，明确请求只停用当前项目；恢复时再选择使用插件。
试着这样对 Agent 说
在当前项目使用已安装的 Motux Build 用户级插件。请先检查是否存在项目内安装或冲突，确认可用后记录这个项目的选择。如何判断完成
- 当前项目记录 user 选择；不会复制整套 Core、Manager 或 Brief。
- 停用后项目选择为 disabled，已有文档继续保留。
适用边界
- 已有项目内安装始终优先，不能用一个启用请求自动迁移或覆盖。
- conflict 状态需要先体检；不要手动改配置假装已完成迁移。
只在当前项目安装
#获得完整、可锁定版本的项目内 Build。
能帮你完成什么
适合需要逐项目控制版本、保留自包含组件，或让多个编程 Agent 使用共同规则的项目。组件保存在项目的 .motux 中，由清单锁定文件和版本。确定为空的新项目可走快速接入；已有代码的项目会先进行只读盘点和接入计划。
使用前
已确认项目根目录和当前使用的 Agent。安装时需要取得并校验完整发行包。
怎么使用
- 在目标项目发出只安装到项目的请求。
- 空项目由固定 Runner 安装组件及当前 Agent 的一个入口；已有项目先看接入计划。
- 确认需要写入的入口与规则处理后执行；新开任务，再检查当前 Agent 是否真正加载。
试着这样对 Agent 说
开始在当前项目使用 Motux Build。我选择完整项目内安装。请按 https://motux.app/motux-build/instructions/install-motux-build.md 先判断项目状态，只配置我当前使用的 Agent。如何判断完成
- 项目具有受管理的 Manager、Core、Brief 和精确版本锁。
- 安装结果说明已配置的 Agent、延期的 Agent，以及是否需要重新打开任务。
适用边界
- 快速安装不会自动完成产品设计、工程业务代码或所有 Agent 的配置。
- 自包含规则不等于模型、依赖下载和外部服务都可以离线。
检查安装与加载状态
#区分已经放入文件和实际开始使用。
能帮你完成什么
状态检查可以解释当前使用用户插件还是项目安装、组件版本是否完整、入口是否可达，以及为什么安装后行为没有变化。项目内安装还会区分待激活、已激活、陈旧和阻断。
使用前
在你想使用 Build 的那个项目中检查，而不是在另一个目录里推测结果。
怎么使用
- 请求只读检查安装来源、版本与加载状态。
- 若为 installed-pending-activation，按提示重开任务或工作区，再核验入口。
- 若为 stale 或 blocked，先阅读原因和修复计划，不反复重装。
试着这样对 Agent 说
请只读检查 Motux Build 的安装来源、组件完整性和当前 Agent 的加载状态。若尚未生效，说明具体原因和最小下一步。如何判断完成
- user/local/disabled/undecided/conflict 等来源判断有明确说明。
- 项目桥接状态为 active，或明确指出 pending、stale、blocked 的原因。
适用边界
- 用户插件的发现结果与项目内 adapter doctor 是不同检查。
- 新安装或更新不代表当前已打开的任务自动刷新。
单独使用 Motux Brief
#只需要需求表单时，不必接入完整 Build。
能帮你完成什么
Brief 可以作为独立 Skill 使用，帮助你在一个本地表单中回答产品问题。它不负责完整的工程标准、项目桥接或 Build 组件更新；已经使用完整 Build 的用户通常无需再安装一份。
使用前
编程 Agent 能使用 Skill；环境可运行 Brief 随包提供的 Python 生成脚本，并有浏览器可打开表单。
怎么使用
- 使用官网安装工作台的“Motux Brief”入口，取得当前正式包的准确校验信息。
- 要求只安装 Brief，并明确目标项目及已有规则。
- 安装后发出产品澄清请求，填写并保存生成的表单。
试着这样对 Agent 说
我只需要 Motux Brief。请使用官网 https://motux.app/motux-build/ 的 Brief 独立安装说明，校验当前包后安装，不接入完整 Motux Build。如何判断完成
- Agent 可以生成本地 Brief 问卷和可填写表单。
- 项目不会因此获得完整 Build 接入或工程初始化。
适用边界
- 具体安装位置遵循 Agent 的 Skill 机制；不要把示例路径当作跨工具通用入口。