MAWflow 码流 AI

Appearance

进入工作台

MAWflow Agent Skills 使用手册 ​

MAWflow Agent Skills 是 MAWflow 面向 Codex 的可选插件。它帮助 Codex 发现 MAWflow 项目、调用官方 CLI 创建 Seed 规范项目，并按当前项目规则处理诊断、协作与受控交付。

当前公开版本为 v1.0.1。安装 Skill 让 Codex 更容易使用 MAWflow；不安装或卸载 Skill 也不影响任何 Seed 项目。

安装到 Codex ​

在终端执行：

bash
codex plugin marketplace add novelworld/mawflow-skills --ref v1.0.1
codex plugin add mawflow@mawflow --json
codex plugin list --json

列表中出现已启用的 mawflow@mawflow 后，新建一个 Codex 任务。Skill 在新任务上下文中生效，不会被复制进业务项目。

如果已经添加过锁定旧 tag 的 mawflow marketplace，更换版本时先移除该 marketplace，再添加新 tag 并安装插件：

bash
codex plugin marketplace remove mawflow
codex plugin marketplace add novelworld/mawflow-skills --ref v1.0.1
codex plugin add mawflow@mawflow --json

这会更新本机插件来源；项目文件不受影响。安装结果应显示 version: 1.0.1，随后新建任务读取新版 Skill。

创建 Seed 规范项目 ​

在新 Codex 任务中输入：

text
$mawflow:mawflow-project 创建一个名为 demo 的 MAWflow Seed 规范项目，目录为 /path/to/demo。

Skill 会先检查目标目录与官方 CLI 能力，然后：

  1. 运行只读 Project Init 计划。
  2. 校验 Seed Contract v2 manifest、解析版本和模板树摘要。
  3. 固定已解析的 Seed Kit 版本。
  4. 调用官方 mawflow project init 原子创建项目。
  5. 运行 Project Doctor，回报 Seed、Contract、Git 状态和回滚提示。

Skill 不内置 Seed 文件，也不手写 .maw/**。Seed 规范始终由当前官方 CLI 和公开 Seed Kit 决定，因此 Skill 发布与 Seed 模板发布保持独立。

已有仓库会先进入 preview；只有目标内容、文件哈希和精确确认一致时才允许写入。非 Git 内容目录、脏工作树、不可信来源或 Doctor 失败都会停止，不做猜测性修复。

四个 Skill ​

  • $mawflow:mawflow-host：检查 Host Base、CLI 和本机能力。
  • $mawflow:mawflow-project：创建、识别、检查和维护 Seed 项目。
  • $mawflow:mawflow-workflow：按项目入口路由健康、审计、任务包与协作流程。
  • $mawflow:mawflow-delivery：规划发布、镜像和客户交付；执行高风险动作前必须取得明确授权。

权威顺序 ​

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

Skill 只负责发现与适配。项目规则、模块事实、凭据边界和发布策略仍保存在项目内；两者不一致时，以项目事实为准并保留更严格的安全限制。

所有项目写入与交付动作继续遵循 plan -> confirm -> execute。安装 Skill 不代表授权发布、部署、镜像、客户同步或生产变更。

验证与卸载 ​

安装后可先让 Codex 执行只读检查：

text
$mawflow:mawflow-host 检查当前 MAWflow CLI 与 Host 能力，只读，不安装或升级。

卸载：

bash
codex plugin remove mawflow@mawflow

卸载不会修改项目。Codex 仍可从项目内 AI_START_HERE.md 和 .maw/agent-entry.yaml 正常工作。

常见问题 ​

Skill 会上传源码吗？ ​

不会。Skill 不拥有上传源码的能力；实际数据边界由当前项目、官方 CLI、Local MCP 和用户授权共同决定。

为什么没有复制 Seed 模板？ ​

复制模板会形成第二套规范并产生版本漂移。mawflow-project 始终调用官方 mawflow project init，并在写入前固定只读计划解析出的版本。

Skill 能直接替我发布吗？ ​

不能默认执行。mawflow-delivery 必须先展示当前项目的发布或同步计划，并取得对具体目标的明确授权。

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

同一个插件可以服务多个项目，又不会把 Agent 工具实现变成业务仓依赖。项目仓只保存自己的事实与协作规则。

相关入口 ​

Seed 经验反馈 ​

在已升级到 Seed 2.8.1 及以上版本的项目中，对 Agent 说 #Seed反馈（也支持 #Seed复盘 或 #Seed优化报告），即可从当前对话或指定的近期任务生成脱敏建议报告。把报告带到主仓或种子仓，用 #Seed反馈：评审 <报告> 核验后接入既有候选台账。

MAWflow Skill 1.0.1 只负责发现和路由。Codex、Claude Code、Gemini CLI、Cursor、ChatGPT Web 与未知 Agent 均可直接读取项目中的指令和报告模板；没有 Skill、终端或历史检索工具时也可以从可见对话生成报告，并注明覆盖限制。报告不会自动上传对话或执行建议。