Seed 新手训练路径

这一组指南不按功能分类阅读，而按学习路径走。你只围绕一个案例练习：给博客文章列表增加搜索能力。案例足够小，能在 10 分钟内跑完第一次 AI Coding 闭环；也足够真实，可以继续扩展成任务包、检查、经验沉淀和公开示例。

训练目标是让你学会四件事：

• 通过 Seed 安装创建 v2 新项目，或把 0.2.x 项目一次性迁移成 AI 与本地工作台可管理的状态。
• 写一条可以复制给 AI 编程工具的 Prompt Spec。
• 任务变复杂时，用 Task Pack 保存计划、状态和恢复点。
• 每一步都能验证、收口，并知道什么时候可以公开分享。

每个 guide 都有 Prompt、验证和收口；你不需要先把整套概念背下来，按顺序做完博客搜索即可。

学习路线

阶段	你要完成什么	阅读入口	完成标准
新手路径	先完成 Seed 安装，创建新项目或改造现有项目，明确项目事实、任务边界和收口方式。	Seed 安装	能准备好 Seed 项目，并把第一条任务交给 AI 执行。
第一次成功闭环	复制一条博客搜索 Prompt，让 AI 完成小改动并跑最小检查。	写第一条 Prompt Spec	10 分钟内完成一次 AI Coding 闭环。
复杂任务治理	把博客搜索从单页交互升级为可恢复任务包。	创建 Task Pack	有计划、编号任务、状态文件和分段验证。
高手能力体系	用内置指令、学习模式、检查和公开 Pack 管理长期协作。	内置指令	后续会话能复用规则、经验和检查证据。

10 分钟闭环

第一次练习只做一个用户可见结果：在博客文章列表增加搜索输入框，按标题和摘要过滤文章。

复制这条 Prompt 到 AI 执行会话：

# 给博客文章列表增加搜索

## 背景
当前项目使用 MAWflow Seed 管理 AI Coding 协作。我已经通过 Host Base 创建了项目，现在要做第一条小任务：让博客文章列表支持搜索。

## 目标
- 在博客文章列表增加搜索输入框。
- 支持按文章标题和摘要过滤。
- 空关键词显示全部文章。
- 没有匹配结果时显示空状态。

## 允许修改
- code/client/**
- docs/modules/blog/**

## 禁止修改
- .local/**
- .maw/*.local.yaml
- 后端 API
- 发布配置
- 真实密钥、token、账号密码

## 验收标准
- 输入关键词后只展示匹配文章。
- 清空关键词后恢复全部文章。
- 没有结果时用户能看懂当前状态。
- 收口说明包含变更、验证、风险和下一步。

## 验证命令
- git diff --check
- npm run test:plan

如果你的项目还没有 code/client/** 或 docs/modules/blog/**，先把“允许修改”改成真实路径。不要让 AI 猜目录，也不要让它为了完成案例新建无关端工程。

每一步都要收口

练习时不要只看“AI 回答完成”。一次合格闭环至少包含：

• 变更：改了哪些文件，用户能看到什么变化。
• 验证：运行了哪些命令，结果如何。
• 风险：哪些场景还没覆盖。
• 发布影响：是否需要部署才会生效。
• 下一步：继续小任务，还是升级为 Task Pack。

可复制收口模板：

变更：
- 

验证：
- 

风险：
- 

发布影响：
- 

下一步：
-

什么时候升级为 Task Pack

如果博客搜索只改一个页面，Prompt Spec 足够。如果它开始包含后端搜索接口、索引规则、权限、分页、测试、文档和发布，就升级成 Task Pack。

判断标准：

• 任务超过一个会话。
• 需要先审计再开发。
• 每一步都有不同验收标准。
• 中断后必须能恢复。
• 需要把验证、风险和状态留给下一个会话。

如果你还没有准备好 Seed 项目，先阅读 Seed 安装。如果你需要更多本机增强能力，再阅读 Lite 安装。项目已经准备好后，继续阅读 写第一条 Prompt Spec，跑完最小闭环。