@amutix/amux
多AI代理本地文件协调层
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@amutix/amux。 它的用途是：多AI代理本地文件协调层 完整的 Skill 内容见：https://321skill.com/skills/amutix-amux/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用amutix初始化项目上下文，声明当前项目目标是'开发一个电商网站搜索功能'，并给代理A分配任务'实现Elasticsearch索引构建'，代理B负责'编写搜索API接口'，同时在文件reservations中预留'search-service.ts'给代理A'。amutix会创建相应的任务文件、上下文文件和预留记录，之后代理A和B执行时自动读取这些信息，避免冲突。
介绍
这个Skill解决了多个AI编码代理同时工作时缺乏共享上下文、文件冲突、任务归属不清、决策分散的问题。在实际开发中，当你同时使用多个AI代理（如Pi、Claude、Cursor）分别处理不同模块时，每个代理往往各自为政，无法感知彼此的工作进展、文件占用和已做决策，导致重复劳动、编辑冲突甚至项目失控。
使用方式很简单，你只需要在项目中安装amutix，然后让每个AI代理知道它可以通过本地文件系统读写共享状态（项目上下文、待办事项、任务评论、文件预留、审查交接、决策日志等）。你不需要额外服务器，所有状态都存储在项目目录下的文件中，代理之间通过文件变化自然同步。之后就可以通过自然语言指令让代理调用amutix提供的命令来更新任务、预留文件、提交审查等。
它非常适合需要多个AI编码代理协同工作的团队或个人。尤其是那些已经拥有多个AI代理会话，希望它们像一支对齐的工程团队那样运作，但又不想引入复杂的中央调度平台或工作流引擎的场景。项目经理、全栈开发者、智能体开发者都可以从中受益，让多代理协作变得可追溯、可审查。
建议在团队已建立多代理工作流时统一使用此工具，能大幅减少沟通成本和编辑冲突。需要注意的是，它主要作为协调层运行，并不负责管理终端、运行模型或自动规划，你需要配合已有的代理运行时（如Pi、IDE、终端）一起使用。同时，它依赖本地文件系统，确保所有代理能访问同一项目目录。
常见问题
amutix需要单独安装LLM模型吗？
不需要，amutix只负责协调，不运行任何模型，你需要已有的AI代理（如Pi、Claude）来执行实际任务。
amutix支持哪些代理运行时？
目前官方适配了Pi，但核心库是框架无关的，开发者可以轻松为其他运行时（如VS Code扩展、tmux、终端）编写适配器。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/amutix-amux/raw/index.md 读取 @amutix/amux 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/amutix-amux/raw/index.md（查看排版版本）