已有项目与多个工具
把现有规则接入同一套工作方式,并保留项目自己的决定。
接入已有项目
#先盘点已有代码、约定和入口,再确定接入范围。
能帮你完成什么
已有项目可能已包含 AGENTS.md、CLAUDE.md、Cursor 规则和成熟工程约定。Manager 先识别这些事实,区分安装组件、建立入口和融合规则,避免把新项目模板直接覆盖到正在运行的项目。
使用前
当前目录是正确项目根;保留已有改动。接入请求不自动授权业务重构、部署或迁移数据。
怎么使用
- 请 Agent 只读检查当前安装状态、规则位置和 Git 改动。
- 阅读接入计划:组件路径、入口改动、规则冲突、验证和恢复方法。
- 集中确认需要的写入与冲突决定,再执行并检查加载结果。
试着这样对 Agent 说
请为这个已有项目接入 Motux Build。先盘点已有 Agent 规则和未提交改动,给出接入与融合计划;保留项目现有业务架构。如何判断完成
- 有可审阅的接入计划,现有规则被明确保留、融合或记录为冲突。
- 完成后入口、组件和项目选择有独立验证结果。
适用边界
- 遇到未知 .motux、外来命名空间或修改过的受管理文件会停止相应写入。
- 安装完成不代表规则冲突已经解决。
融合规则与项目例外
#保留已有约定,同时让通用标准可以继续升级。
能帮你完成什么
Agent 将规则分为兼容、互补、冲突和项目特有内容,集中展示需要决定的部分。项目例外放在 overrides,冲突的处理理由单独记录;之后 Core 更新只复查受到改变影响的决定。
使用前
已有项目使用完整项目内安装,并准备好能公开给当前 Agent 读取的规则资料。
怎么使用
- 要求盘点规则,不复制或读取凭据及私有资料。
- 对实质冲突选择保留项目约定、采用通用标准或做明确例外。
- 确认后保存 PROJECT_RULES、CONFLICT_DECISIONS 和 adoption 状态,再验证入口。
试着这样对 Agent 说
项目规定所有日期存 UTC,界面按用户时区显示。请把它作为项目规则保留,检查与 Motux Build 的冲突,并集中给我需要决定的选项。如何判断完成
- 项目例外与通用组件分开保存。
- 重要冲突有选择、原因和影响范围,后续 Agent 可以继续读取。
适用边界
- 不要直接编辑 managed/core 中的文件来保存项目偏好。
- 历史 adoption 状态格式升级需要单独预览,不能随组件更新静默改写。
接入其他编程 Agent
#让同一个项目中的不同工具读取同一份标准。
能帮你完成什么
完整项目内安装支持为 Codex、Claude、Cursor、VS Code / GitHub Copilot、Trae、CodeBuddy、Qoder、Devin 和 Windsurf 规划对应入口。入口是很小的桥接文件,标准、版本和项目记忆仍只有一份。Qoder CN 只识别既有 .lingma/rules 并提供冲突检查和人工说明,不自动生成未经验证的格式。
使用前
使用完整项目内安装;确认当前实际使用的工具。用户级 Codex Plugin 不承担其他 Agent 的项目桥接。
怎么使用
- 点名要接入的 Agent,先查看 adapter status 和拟写文件。
- 确认该 Agent 的计划与精确入口改动;存在旧规则时先处理冲突。
- 应用后重开目标工具的任务,运行 adapter doctor 验证。
试着这样对 Agent 说
这个项目已有 Motux Build,现在我要使用 Cursor。请只为 Cursor 规划接入,保留其他 Agent 的配置;先展示入口文件及验证方法。如何判断完成
- 只添加或复用被选择工具的入口,没有复制整套 Core。
- 结果说明入口路径、规则优先级和重载要求。
适用边界
- 工具支持是已提供的桥接合同,不是所有工具所有版本都已自动激活。
- 不要为“以后也许会用”一次性写入所有工具目录。
后续 Agent 策略与入口维护
#选择何时配置新工具,并检查或移除旧入口。
能帮你完成什么
完整接入可以选择发现新 Agent 后先出计划、仅保留通用桥接,或在严格条件下自动创建空的独立原生入口。入口体检会发现内容修改和目标不可达;移除只处理完整的 Motux 自有入口或明确批准的标记块。
使用前
已有项目桥接和适配器记录。自动创建策略需要明确选择;新项目快速接入默认只配置当前 Agent。
怎么使用
- 请求展示当前未来 Agent 策略和已登记的入口。
- 一般选择 plan-on-discovery;需要自动空入口时查看适用工具和限制再确认。
- 维护时先体检,移除时点名工具并确认是否有共用入口。
试着这样对 Agent 说
检查项目的 Motux Agent 入口和后续接入策略。新工具先生成计划;如果移除 Cursor 的入口会影响其他工具,请先说明。如何判断完成
- 得到现有、缺失、被修改或共用的入口清单。
- 确认的移除不会删掉其他 Agent 仍在使用的共同桥接。
适用边界
- safe-auto-empty-native 仅适用于受支持的独立空目标,不适用于根文件、Copilot 既有指令或 Qoder CN。
- 发现已修改文件时先保留,不能用“修复”覆盖用户内容。