使用手册
附录与问题排查
需要时再查术语、目录和故障处理。
3 项说明
自然语言与命令名称
#把示例交给 Agent，不必安装一个 motux 全局 CLI。
能帮你完成什么
本手册的大多数“命令”是 Manager 工作流名称，由 Agent 从当前安装的 Skill 中执行。onboard、doctor、adapter plan、skill install 并不意味着终端存在同名全局可执行程序。少数确定性工具，例如模块管理器，才有明确的 Node 入口。
使用前
在目标项目中操作，并让 Agent 解析当前有效安装来源。
怎么使用
- 日常使用优先复制对应功能的自然语言示例。
- 让 Agent 根据 user/local 分类解析 family root，不手写某个旧缓存版本。
- 需要终端细节时，要求给出当前机器核验过的完整路径及参数。
试着这样对 Agent 说
请将“只读检查当前模块”转换为这台机器可执行的准确命令，先确认 family root、Node 和项目范围，不要猜测插件缓存路径。如何判断完成
- 项目模式的模块工具位于 .motux/manager/runtime/capability-manager.mjs；用户模式由已安装 Plugin/runtime/manager 提供。
- 模块操作包括 inspect、check、install、update、enable、disable、rollback、resolve、recover、locks、recover-locks。
适用边界
- 示例中的文件位置和模块来源需要核实，不能把工作流名称直接当 shell 命令运行。
文件归属与术语
#知道资料存在哪里，什么不该直接改。
能帮你完成什么
用户模式：只读规则在 Codex 插件，项目的 .motux/motux.json 保存选择；独立模块用户存储在用户主目录的 .motux/capabilities。项目模式：Manager、锁及 Core/Brief managed 内容在项目 .motux；项目例外在 overrides。Brief 与产品、交接文档仍属于当前项目。
使用前
先确认 user/local 分类。family root 表示当前有效的组件根，不能固定为所有机器上的某个路径。
怎么使用
- 用状态检查获得当前来源和实际位置。
- 项目偏好写入项目规则，通用经验以源代码变更或独立模块维护。
- 遇到错误先检查锁和证据，不直接编辑 managed、不可变模块包或 Plugin 缓存。
试着这样对 Agent 说
请说明当前项目的产品文档、项目覆盖规则、Build 组件、模块包分别保存在哪里，只列归属和用途，不读取私有资料。如何判断完成
- Core：通用标准；Manager：生命周期管理；Brief：本地决策表单。
- Profile：任务类型；Hook：宿主启动事件处理；SHA-256：精确文件内容校验值。
- 安装：文件已取得；启用：项目已选择；激活/发现：当前宿主可以实际加载。
适用边界
- 校验值证明内容是否相同，不单独证明来源可信；来源信任与内容校验都要处理。
常见问题的最短处理路径
#从现象出发，避免反复重装。
能帮你完成什么
安装后没生效：先检查来源和发现，再新开任务。更新提示 blocked：看修改、兼容性或未确认决定。模块“装了没反应”：检查项目启用和当前阶段请求。Brief 保存不了：用下载方式并放到页面指定路径。目录不可用：保留任务继续用已有能力，不跳过认证。
使用前
保留错误类别、涉及操作与非敏感版本信息。不要发送密钥或完整私有配置。
怎么使用
- 明确刚执行的是安装、启用、更新还是只读检查。
- 先检查与该操作直接相关的状态，避免扫描整机项目。
- 按结果选择重新打开任务、补全选择、预览修复或停止并人工处理。
试着这样对 Agent 说
我已经安装 joint-delivery，但本项目没有使用它。请只检查项目是否启用、版本是否兼容、当前任务是否选择了正确阶段，不重新安装底座。如何判断完成
- 问题被定位到来源、状态、兼容性、授权或宿主发现中的具体一项。
- 下一步有明确目标和停止条件。
适用边界
- 没有通用“删除所有锁/缓存再试”的恢复方法。
- 功能自动生效仍受宿主能力、权限和当前项目规则约束。