给主流编程 Agent 的产品开发执行标准

Motux Build 是 AI Agent 的产品开发标准库。

它把产品澄清、界面确认、技术选型、质量检查、Git 追踪和多 Agent 交接沉淀成一套可复用流程, 让每次开新项目或接手旧项目时,Agent 都能先按你的经验做事,并在需要时安全升级这些经验。

它是什么

一套让 Agent 开工前先对齐产品、工程和协作方式的标准。

Motux Build 不是一个具体业务模板,也不是某个框架脚手架。它更像一份给 Codex、Claude、Cursor、CodeBuddy 和其它 Agent 读取的项目工作协议,让它们知道什么时候该问、怎么问、什么时候该做、怎么记录、怎么验证。

给人看

让用户知道开发前要想清楚什么,哪些决策需要自己拍板,哪些技术细节可以交给 AI。

给 Agent 执行

让 Agent 按任务类型读取相关标准,避免每次都从零解释同一套偏好和踩坑经验。

每个阶段,都有可以查阅的使用方法。

42 项功能与使用说明,按你的任务整理。展开一个主题,查看每项功能的用途;手册里有步骤、示例和完成标准。

打开完整使用手册
安装与第一次使用6 项说明

先选择安装范围,再确认当前项目实际使用哪一份 Build。 阅读本章

已有项目与多个工具4 项说明

把现有规则接入同一套工作方式,并保留项目自己的决定。 阅读本章

需求梳理与产品决策4 项说明

从想法到明确的第一版,使用 Brief 一次处理相关问题。 阅读本章

开发、测试与交付7 项说明

把标准用在真实任务上,知道 Agent 应当产出什么证据。 阅读本章

任务推进与经验复用4 项说明

在多阶段工作中保留决定、分配职责,并按需读取标准。 阅读本章

独立能力模块5 项说明

按需安装工作方法,在兼容范围内单独更新。 阅读本章

第三方 Skill 管理3 项说明

在明确能力缺口时推荐工具,并按选择安装和维护。 阅读本章

更新、体检与恢复6 项说明

根据安装范围更新正确的一份 Build。 阅读本章

附录与问题排查3 项说明

需要时再查术语、目录和故障处理。 阅读本章

解决哪些问题

它解决的是 AI 开发里最消耗时间的重复纠错。

很多项目不是做不出来,而是每次都在同样的地方返工:需求没问清、界面不自然、上下文丢失、 多个 Agent 互相覆盖、测试和提交不稳定。

需求还没想透就开始写代码

要求 Agent 先追问产品目标、核心假设、用户故事和最小验证路径。

Agent 只会反问,用户还是不知道怎么选

要求 Agent 先给判断、选项和推荐理由,让用户直接选择或补充自己的想法。

界面看起来能用,但不够像人用的产品

把 storyboard、视觉确认、分步交互、按钮反馈和移动端检查前置。

同一个项目里 Codex 和 Claude 信息不同步

把关键进展、决定、风险和下一步写入项目记忆,而不是只留在聊天记录里。

每次开新项目都要重新解释偏好

把你的工作方式、质量标准和安全边界沉淀成可复制文件。

标准更新后,旧项目不敢直接覆盖

先查看版本差异和影响范围,再只更新 Motux 管理的内容,保留项目自己的规则。

运行中项目接入 AI 时容易误改

先读取现有规则,遇到冲突不覆盖,接入阶段只梳理、不乱动业务代码。

开发过程不可回溯

要求小步验证、更新交接、必要时提交 Git,让每次修改都有上下文。

适合什么用户

尤其适合用 AI 做产品开发,但不想反复教同一件事的人。

01

产品出身的独立开发者

你擅长判断用户、场景和价值,但不想在工程细节上被反复拖住。

02

同时使用多个编程 Agent 的用户

你需要不同 Agent 共享项目记忆,避免每换一个工具就丢掉上下文。

03

经常从 0 做原型的人

你需要新项目快速进入需求澄清、界面确认和最小可验证版本。

04

想把 AI 接入旧项目的人

你需要先保护已有代码和规则,再逐步把更好的协作标准合并进去。

为什么使用

让用户做自己最强的事,让 AI 补用户最弱的地方。

它的价值不是让流程变重,而是减少反复纠错。用户把产品判断、审美偏好和业务目标讲清楚, AI 则负责把这些判断转化成工程执行、验证和记录。

01

先把产品想清楚

Agent 先给判断和可选方向,再帮助用户明确为什么要做、谁会使用、哪些需求先验证。

02

再把界面看清楚

用 storyboard、页面清单和视觉确认减少理解偏差,避免把所有功能堆在一页。

03

最后小步可回溯

功能拆小、做完验证、记录决策、更新交接,让不同 Agent 接手也不丢上下文。

如何使用

先选安装范围,再把同一套标准用在正确的位置。

多项目用户推荐安装到 Codex;需要项目自包含和精确锁定时,只安装到当前项目。

选择安装范围

已存在的项目内 Motux 始终优先;本次选择不会迁移、删除或混用旧安装。

安装到 Codex

一次安装,让多个项目各自决定是否启用。

Codex 中只启用一个 Motux Build Plugin。项目只保存最小选择与自己产生的文档;Plugin 更新后,全局启用项目在新会话中共同使用新版本。

提示词

安装 Motux Build 到 Codex

一条主流程

先开始,Agent 再根据项目状态完成正确的分支。

A

先选安装范围

多项目用户安装一个 Codex Plugin;需要完整自包含时只安装到当前项目。

  • 用户级路径只安装一个 Plugin,不把 Manager、Core、Brief 复制进启用项目。
  • 项目级路径保留完整 schema 2 安装与精确文件锁。
  • 两条路径都把项目文档、决定与运行证据留在项目里。
  • 任何已支持的项目内安装继续优先,不自动迁移或混用。
B

后来增加新的 Agent

新 Agent 优先读取已有的通用兼容层;需要原生规则时才进行小范围补全。

  • 默认先生成只读方案,不因为发现工具目录就假定要写入。
  • 可在首次接入时选择“发现后提案”“安全自动补全”或“仅通用兼容层”。
  • 已有规则、根文件、未知格式和 Qoder CN 始终不自动改写。
C

只安装 Motux Brief

只把产品发现与决策表单 skill 放入当前项目,不接入完整 Motux Build 标准。

  • 适合在其它项目里单独测试 Motux Brief。
  • 默认只创建或更新 skills/motux-brief/
  • 安装后由 Agent 生成完整产品发现或聚焦决策的本地表单和 Brief JSON。
D

安全更新

在固定安全条件满足时一次完成补丁更新;只读检查使用单独的短命令。

  • 只检查时不修改项目文件。
  • 安全更新会一起更新所有符合条件的补丁组件,不反复确认。
  • 任一条件不满足就保持零写入,并给出少量下一步选项。

支持的 Agent

一份标准,多种编程 Agent 共用。

每个桥接文件只告诉 Agent 去读取项目内的 .motux/AGENT_ENTRY.md;完整标准始终只维护一份。

先有通用兼容层

首次接入可建立最小的 AGENTS.md 桥接。需要原生规则的 Agent 再按固定目标补充,不复制整套标准。

按任务加载标准

Agent 先选择当前任务的 Profile,只读取最多三份初始规则;遇到界面、架构等明确阶段时,才加载对应补充标准。

Qoder CN

会识别现有 .lingma/rules,但不会猜测未公开的规则文件格式。当前版本提供冲突检查与人工配置说明。

接入后验证状态

存在 .motux/ 不等于已经生效。Manager 会区分待激活、已激活、版本陈旧和被阻断,并给出下一步。

Skill 推荐

遇到专门任务时,先看看有没有更合适的工具。

当当前 Agent 存在明确能力缺口,Motux Build 可以从受审核目录中找出兼容的 Skill, 说明适用原因、来源和注意事项。用户同意后才会安装。

01

按任务触发

只有在前端、测试、文档等具体任务确实需要专门能力时才查询,不在每个任务里打扰用户。

02

先比较再决定

Agent 先说明为什么推荐、能解决什么问题和可能代价,用户可以安装、跳过或选择其它方案。

03

来源可追踪

目录记录固定来源、版本和完整性信息;安装不会把未知脚本直接带进项目。

持续更新

安装范围不同,更新边界也不同。

用户级更新替换一个 Plugin;项目级更新只处理该项目锁定的 Motux 文件。两条路径都先核验再改动。

01

Codex 用户级

更新一次自包含 Plugin;所有全局启用项目在新会话中共同使用新版本,项目配置和文档不变。

02

当前项目内

按该项目的 schema 2 锁逐项检查与更新,保留项目覆盖层、规则和精确版本边界。

03

共同安全线

只读检查不写入;Hook 变化重新审查;已有项目内安装不随用户级 Plugin 被替换。

安全边界

运行中项目的重点是“不覆盖、不乱改、先汇报”。

项目规则不覆盖

已有的 AGENTS.mdCLAUDE.md、项目记忆和业务文档仍归项目所有;Motux Build 的新增规则放在 .motux/products/build/overrides/

先给升级计划

更新前先说明已安装版本、可用更新、受影响内容、验证方式和回退路径;原生桥接更新仍是单独确认项。

不暴露敏感信息

不要把账号、密钥、服务器密码或私钥贴进聊天;需要输入密码时,优先让用户在终端中输入。

更新可回退

每次更新记录在 .motux/updates/,并只提交 Motux 自己的变化,方便查看和回退。

早期版本支持

只在项目已经安装早期 Motux Dev 时使用。

专用支持包会先核验早期版本指纹并生成迁移计划。普通 Motux Build 安装和安全更新不会进入这条流程。

专用提示词

从早期 Motux Dev 迁移