核心定位
把你的产品开发经验,变成 Agent 可执行的 Markdown 标准。
用户级安装由 Codex 插件提供只读标准;项目内安装把完整组件留在项目里。两种方式都将项目资料保存在项目中。
它是什么
Motux Build 不是一个具体业务模板,也不是某个框架脚手架。它更像一份给 Codex、Claude、Cursor、CodeBuddy 和其它 Agent 读取的项目工作协议,让它们知道什么时候该问、怎么问、什么时候该做、怎么记录、怎么验证。
核心定位
用户级安装由 Codex 插件提供只读标准;项目内安装把完整组件留在项目里。两种方式都将项目资料保存在项目中。
让用户知道开发前要想清楚什么,哪些决策需要自己拍板,哪些技术细节可以交给 AI。
让 Agent 按任务类型读取相关标准,避免每次都从零解释同一套偏好和踩坑经验。
先选择安装范围,再确认当前项目实际使用哪一份 Build。 阅读本章
分清标准、管理工具、表单和独立模块各自负责什么。
一份插件供多个 Codex 项目按需使用。
决定当前项目使用用户级 Build,或暂时停用。
获得完整、可锁定版本的项目内 Build。
区分已经放入文件和实际开始使用。
只需要需求表单时,不必接入完整 Build。
把现有规则接入同一套工作方式,并保留项目自己的决定。 阅读本章
先盘点已有代码、约定和入口,再确定接入范围。
保留已有约定,同时让通用标准可以继续升级。
让同一个项目中的不同工具读取同一份标准。
选择何时配置新工具,并检查或移除旧入口。
从想法到明确的第一版,使用 Brief 一次处理相关问题。 阅读本章
决定第一版必须做什么,以及暂时不做什么。
把新产品的大量相关问题整理成分组表单。
只解决当前阶段的一组关键选择。
让表单答案成为项目中可读取的决定记录。
把标准用在真实任务上,知道 Agent 应当产出什么证据。 阅读本章
在确认产品方向后建立可运行的工程起点。
围绕当前需要做取舍,不为假设中的未来堆叠架构。
从用户操作流程到完整状态和真实浏览器验证。
把成功路径与失败、重试和权限一起设计。
用测试证明功能目标,控制无关测试成本。
让已冻结的改动接受另一轮有范围的检查。
让改动可以追溯、审阅和回退。
在多阶段工作中保留决定、分配职责,并按需读取标准。 阅读本章
简单任务保持轻量,复杂工作分阶段推进。
在宿主支持时让多个 Agent 按明确边界合作。
换任务或换 Agent 后仍能继续已确认的工作。
把反复出现的问题整理为可复用规则或模块。
按需安装工作方法,在兼容范围内单独更新。 阅读本章
增加一份经过校验的工作方法。
决定哪个项目实际使用已安装模块。
更新所选内容,保留其他模块和已有任务。
在不猜测原始状态的前提下恢复模块事务。
把多个项目连成一个可联合验收的业务流程。
在明确能力缺口时推荐工具,并按选择安装和维护。 阅读本章
让专用工具在有帮助时出现。
校验固定来源后复制明确的 Skill 内容。
保留修改痕迹,按精确内容管理已安装工具。
根据安装范围更新正确的一份 Build。 阅读本章
先看哪些版本可用,再决定是否应用。
让共享 Codex 插件使用已验证的正式版本。
所有固定条件满足时,用短指令完成更新。
处理需要明确选择和预览的项目更新。
在出现异常时先定位,再选择恢复方式。
按实际历史版本选择专门的迁移路径。
需要时再查术语、目录和故障处理。 阅读本章
把示例交给 Agent,不必安装一个 motux 全局 CLI。
知道资料存在哪里,什么不该直接改。
从现象出发,避免反复重装。
解决哪些问题
很多项目不是做不出来,而是每次都在同样的地方返工:需求没问清、界面不自然、上下文丢失、 多个 Agent 互相覆盖、测试和提交不稳定。
要求 Agent 先追问产品目标、核心假设、用户故事和最小验证路径。
要求 Agent 先给判断、选项和推荐理由,让用户直接选择或补充自己的想法。
把 storyboard、视觉确认、分步交互、按钮反馈和移动端检查前置。
把关键进展、决定、风险和下一步写入项目记忆,而不是只留在聊天记录里。
把你的工作方式、质量标准和安全边界沉淀成可复制文件。
先查看版本差异和影响范围,再只更新 Motux 管理的内容,保留项目自己的规则。
先读取现有规则,遇到冲突不覆盖,接入阶段只梳理、不乱动业务代码。
要求小步验证、更新交接、必要时提交 Git,让每次修改都有上下文。
适合什么用户
你擅长判断用户、场景和价值,但不想在工程细节上被反复拖住。
你需要不同 Agent 共享项目记忆,避免每换一个工具就丢掉上下文。
你需要新项目快速进入需求澄清、界面确认和最小可验证版本。
你需要先保护已有代码和规则,再逐步把更好的协作标准合并进去。
为什么使用
它的价值不是让流程变重,而是减少反复纠错。用户把产品判断、审美偏好和业务目标讲清楚, AI 则负责把这些判断转化成工程执行、验证和记录。
Agent 先给判断和可选方向,再帮助用户明确为什么要做、谁会使用、哪些需求先验证。
用 storyboard、页面清单和视觉确认减少理解偏差,避免把所有功能堆在一页。
功能拆小、做完验证、记录决策、更新交接,让不同 Agent 接手也不丢上下文。
如何使用
多项目用户推荐安装到 Codex;需要项目自包含和精确锁定时,只安装到当前项目。
安装到 Codex
Codex 中只启用一个 Motux Build Plugin。项目只保存最小选择与自己产生的文档;Plugin 更新后,全局启用项目在新会话中共同使用新版本。
提示词
一条主流程
多项目用户安装一个 Codex Plugin;需要完整自包含时只安装到当前项目。
新 Agent 优先读取已有的通用兼容层;需要原生规则时才进行小范围补全。
只把产品发现与决策表单 skill 放入当前项目,不接入完整 Motux Build 标准。
skills/motux-brief/。在固定安全条件满足时一次完成补丁更新;只读检查使用单独的短命令。
支持的 Agent
每个桥接文件只告诉 Agent 去读取项目内的 .motux/AGENT_ENTRY.md;完整标准始终只维护一份。
首次接入可建立最小的 AGENTS.md 桥接。需要原生规则的 Agent 再按固定目标补充,不复制整套标准。
Agent 先选择当前任务的 Profile,只读取最多三份初始规则;遇到界面、架构等明确阶段时,才加载对应补充标准。
会识别现有 .lingma/rules,但不会猜测未公开的规则文件格式。当前版本提供冲突检查与人工配置说明。
存在 .motux/ 不等于已经生效。Manager 会区分待激活、已激活、版本陈旧和被阻断,并给出下一步。
Skill 推荐
当当前 Agent 存在明确能力缺口,Motux Build 可以从受审核目录中找出兼容的 Skill, 说明适用原因、来源和注意事项。用户同意后才会安装。
只有在前端、测试、文档等具体任务确实需要专门能力时才查询,不在每个任务里打扰用户。
Agent 先说明为什么推荐、能解决什么问题和可能代价,用户可以安装、跳过或选择其它方案。
目录记录固定来源、版本和完整性信息;安装不会把未知脚本直接带进项目。
持续更新
用户级更新替换一个 Plugin;项目级更新只处理该项目锁定的 Motux 文件。两条路径都先核验再改动。
更新一次自包含 Plugin;所有全局启用项目在新会话中共同使用新版本,项目配置和文档不变。
按该项目的 schema 2 锁逐项检查与更新,保留项目覆盖层、规则和精确版本边界。
只读检查不写入;Hook 变化重新审查;已有项目内安装不随用户级 Plugin 被替换。
安全边界
已有的 AGENTS.md、CLAUDE.md、项目记忆和业务文档仍归项目所有;Motux Build 的新增规则放在
.motux/products/build/overrides/。
更新前先说明已安装版本、可用更新、受影响内容、验证方式和回退路径;原生桥接更新仍是单独确认项。
不要把账号、密钥、服务器密码或私钥贴进聊天;需要输入密码时,优先让用户在终端中输入。
每次更新记录在 .motux/updates/,并只提交 Motux 自己的变化,方便查看和回退。
早期版本支持
专用支持包会先核验早期版本指纹并生成迁移计划。普通 Motux Build 安装和安全更新不会进入这条流程。
专用提示词