MAWflow 码流 AI

Appearance

进入工作台

创建一个新项目 ​

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

新项目初始化统一从安装 MAWflow Host Base 开始。Host Base 提供 mawflow 命令行和项目初始化入口；Seed 提供项目里的协作协议、项目事实和 AI 工作目录入口。

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

你会得到什么 ​

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

内容用途
.maw/*.yaml记录项目身份、组件、模块、环境、运行入口和协作边界。
AI_START_HERE.mdAI 进入项目后的通用启动页。
MAWFLOW_CLI.md终端命令和组件流程。
PROJECT_COMMANDS.md面向 AI 对话的意图指令。
CHATGPT_TO_AI.md跨 AI 工具的通用任务交接格式。
code/README.md空组件目录说明。
docs/handbooks/**需求、技术、质量、任务审计和发布运维的基础手册目录。
.gitignore排除 .local 等本机私有内容。

默认 blank profile 不声明任何组件、应用、端口或技术栈，也不会自动创建 prompts/、ops/、docs/modules/ 或业务源码。

1. 安装 Host Base ​

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

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

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

2. 创建项目目录 ​

先创建项目目录并进入，再执行最短命令：

bash
mkdir my-project
cd my-project
git init
mawflow project init .
mawflow project doctor --root .

空目录默认使用 blank profile。父目录中的 mawflow project init my-project --profile blank 形式继续兼容。

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

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

3. 检查初始化结果 ​

进入项目目录后检查 Seed 和 Git 状态：

bash
mawflow project doctor --root .
git status --short

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

4. 写入最小项目事实 ​

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

文件最小要求
README.md项目是什么、怎么启动、当前状态、谁维护。
.maw/project.yaml项目 key、名称、负责人、协作边界。
.maw/components.yaml初始为空；由组件 CLI 写入真实 app_key。
.maw/modules.yaml当前业务模块树；不确定的模块先保守记录。
.maw/app-runtime.yaml初始应用为空；项目确认运行事实后再登记。

创建或采纳第一个组件：

bash
mawflow component init api --type backend
# 或：mawflow component adopt code/legacy --key legacy --type custom
mawflow component doctor api
mawflow component enable api

不要提交 .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 已在当前目录完成 Git 与 Seed 初始化。
  • mawflow project doctor --root . 返回 ready/editable。
  • 项目里的 README.md 和 .maw/project.yaml 已改成当前项目事实。
  • 第一条任务可以按 Seed 快速开始 写成 Prompt Spec。