MAWflow 码流 AI

Appearance

进入工作台

MAWflow Agent Skills 使用手册 ​

MAWflow Agent Skills 是 MAWflow 面向主流本地 AI Agent 的可选能力扩展。它帮助支持 Skill 的本地 AI 编程工具自动发现 MAWflow 项目结构，把自然语言请求适配到 mawflow CLI 或 Local MCP，并在执行前遵守项目已有的计划、确认和安全边界。

安装 Skill 让 MAWflow 更容易被 Agent 使用；不安装 Skill 也能完整使用 MAWflow Seed。

它解决什么 ​

没有 Skill 时安装 Skill 后
用户或 Agent 从 AI_START_HERE.md 进入项目Agent 可先发现 MAWflow，再自动定位项目入口
用户需要说明要调用哪个 CLI/MCP 入口Skill 可把自然语言意图适配到现有入口
项目规则始终保存在仓库里项目规则仍保存在仓库里，Skill 不复制、不覆盖
高风险动作按项目规则确认高风险动作继续按项目规则确认，Skill 不扩大权限

Skill 不是项目规则存储层、Seed 替代品、项目运行依赖或第二套指令系统。

权威顺序 ​

text
你的当前明确要求
-> 当前项目 Seed 规范（AGENTS.md / .maw / PROJECT_COMMANDS.md）
-> MAWflow Agent Skill
-> Agent 默认行为

当 Skill 与项目规则不同，以项目事实为准，并同时保留双方安全限制。Skill 只能提示兼容问题，不能为了“修复兼容”自动修改项目。

当前开放状态 ​

Agent Skill 集成协议、Seed 声明、主仓兼容检查和本手册已经完成。统一用户级 Skill 分发包及 mawflow skills ... CLI 安装器当前为预约开通，尚无公开分发地址；在官网公布正式地址前，不要从未知 URL、聊天附件或未经确认的本机目录复制 Skill。

推荐安装提示词 ​

把下面这段话交给你正在使用的 Agent：

text
请阅读 https://mawflow.com/manuals/agent-skills.html，按照步骤为我安装并配置 MAWflow Agent Skill。

要求：
1. 检查当前 Agent 类型。
2. 检查是否已有 MAWflow CLI。
3. 检查该 Agent 的用户级 Skill 安装目录。
4. 生成安装计划，不立即执行。
5. 只有官网已给出可信分发地址且我确认后才执行安装。
6. 安装完成后验证项目发现、CLI/MCP 适配和无 Skill 降级。
7. 不修改当前项目文件，不复制项目规则、客户信息、token 或密钥。

如果统一分发包尚未发布，Agent 应停止在计划阶段并返回 distribution_pending，而不是猜测下载地址。

安装后如何工作 ​

Agent 进入目录时按以下顺序处理：

  1. 发现 AI_START_HERE.md 与 .maw/agent-entry.yaml。
  2. 确认 external_agent_skills.mawflow.required 为 false。
  3. 按项目 startup.recommended_order 读取必要上下文。
  4. 将你的请求适配到已有 mawflow CLI、Local MCP 或项目指令。
  5. 先给计划；低风险动作按项目规则执行，高风险动作等待你的确认。

建议能力分为四组：

  • mawflow-host：本机状态、doctor、preflight、登录和插件状态。
  • mawflow-project：项目识别、Seed 检测、Project Init 和项目入口。
  • mawflow-workflow：项目健康、问诊、审计、交接任务和任务包。
  • mawflow-delivery：发布、镜像和客户仓同步；默认关闭，必须确认。

计划中的 CLI 入口 ​

所有安装和更新动作都遵循 plan -> confirm -> execute，不会因为 Agent 已发现 MAWflow 就跳过人工确认。

bash
mawflow skills list
mawflow skills install --plan
mawflow skills install --execute
mawflow skills doctor
mawflow skills update

这些命令当前是兼容路线，不代表你本机安装的 CLI 已提供。执行前先运行 mawflow --help；命令不存在时等待正式版本，不能把“文档已规划”当成“安装已成功”。

验证四种场景 ​

场景预期结果
没有安装 SkillAgent 继续读取 Seed 项目入口，开发和检查正常
已安装兼容 Skill更少的用户输入即可识别项目并找到 CLI/MCP 入口
卸载 Skill项目文件零变化，项目继续运行
Skill 版本过旧显示 skill_compatibility_warning，回退项目规则，不自动修改项目

常见问题 ​

Skill 会上传源码吗？ ​

不会。Skill 是发现与适配层，不拥有上传源码的权限。实际数据边界由当前项目、CLI、Local MCP 和产品权益共同决定。

Skill 能替我直接发布吗？ ​

不能默认执行。mawflow-delivery 属于高风险能力，必须先给出发布或同步计划，并按当前项目规则取得确认。

为什么推荐用户级安装？ ​

用户级安装可以服务多个项目，同时避免把 Agent 工具实现复制进业务仓。项目仓只保存自己的事实和协作规则。

卸载后项目会坏吗？ ​

不会。Seed 的 AI 入口、项目地图、模块地图、检查和任务协议都保存在项目内，Skill 从未是运行依赖。

相关入口 ​