MAWflow 码流 AI

Appearance

进入工作台

创建一个新项目 ​

本页是历史兼容地址。创建新项目的主入口已合并到 Seed 安装，请优先按“总览 -> 安装 -> 快速开始”的顺序阅读。

新项目初始化统一从安装 MAWflow Host Base 开始。Host Base 提供 mawflow 命令行、项目初始化入口和本机运行状态；Seed 提供项目里的协作结构、任务说明、检查脚本和公开边界。

本页适合你准备创建一个全新的项目目录。如果你已经有一个正在开发的项目，不要把 Seed 整包覆盖进去，请阅读 现有项目改造成 MAW 项目。

你会得到什么 ​

完成后，你会有一个新的项目目录，里面已经包含 Seed 的基础结构：

内容用途
.maw/记录项目身份、组件、模块、环境、发布和协作边界。
docs/保存项目长期事实、模块档案、验收和交付资料。
prompts/放置人工选择后交给 AI 执行的一次性任务说明。
ops/放置本地检查、导出、任务包和协作脚本。
code/放置真实业务源码；默认按新项目事实继续调整。

1. 安装 Host Base ​

先按 MAWflow Host Base 用户手册 安装 @mawflow/cli。它会准备专用 Python 虚拟环境并安装 Host Base 核心包：

bash
npm install -g @mawflow/cli --registry=https://mawflow.com/npm/
mawflow
mawflow --help
mawflow host status

如果你后续需要本机增强、项目空间或团队治理能力，可以按实际需要选择 Lite、Studio 或 Enterprise。

2. 创建项目目录 ​

在你希望放置项目的父目录中执行：

bash
mawflow project init my-project --profile web-api
cd my-project
mawflow project doctor --root .

默认会从官网 Python 包源获取官方 mawflow-seed-kit。它包含 Contract、Catalog、编译器和模板，不是只读 data package。普通新项目不需要手工 clone Seed 仓库再改名；公开仓库仍用于查看源码和贡献。外部使用前请确认分发状态已从候选切换为已发布。

如果你需要指定来源，可以阅读 Project Init 用户手册。第一次使用时建议先走默认来源，确认项目能创建、能检查，再调整来源或版本。

3. 检查本机底座状态 ​

进入项目目录后检查本机底座状态：

bash
mawflow host status

如果你只是使用 Seed，到这里就可以继续写项目事实和第一条任务。需要 Lite 或 Studio 时，再按对应手册进入增强路径。

4. 写入最小项目事实 ​

创建完成后，先把项目事实改成你自己的项目，而不是继续保留模板描述。

文件最小要求
README.md项目是什么、怎么启动、当前状态、谁维护。
.maw/project.yaml项目 key、名称、负责人、协作边界。
.maw/components.yaml真实组件，例如 server、client 或你的实际 app_key。
.maw/modules.yaml当前业务模块树；不确定的模块先保守记录。
.maw/app-runtime.yaml本地启动、测试入口和必要环境引用。

不要提交 .local/ 真实内容、.maw/*.local.yaml、私钥、账号密码、生产连接串、供应商密钥或未脱敏日志。

5. 做第一条 AI 任务 ​

项目能创建、命令能检查后，再进入第一次 AI Coding 闭环：

  1. 阅读 Seed 快速开始，确认如何写项目事实、Prompt Spec、执行中引导和完成后审计。
  2. 阅读 写第一条 Prompt Spec，用“博客搜索”案例跑一次 10 分钟闭环。
  3. 任务变复杂后，再阅读 创建 Task Pack。

什么时候需要 Lite ​

Seed 项目创建完成后，可以一直只使用开源 Seed。如果你需要完整个人开发环境，例如本地产品工作台、本地项目上下文、Local MCP 或 AI Credits 入口，可以继续了解 Lite；如果需要跨电脑、项目空间、交付证据和团队协作，再进入云端产品工作台与 Studio。

完成标准 ​

完成本页后，你至少应该能确认：

  • mawflow --help 可用。
  • mawflow project init my-project 已创建项目目录。
  • mawflow host status 能返回本机底座状态，或明确提示尚未启动。
  • 项目里的 README.md 和 .maw/project.yaml 已改成当前项目事实。
  • 第一条任务可以按 Seed 快速开始 写成 Prompt Spec。