Pack 类型

MAWflow Seed 使用 Pack 把 AI Coding 项目里的可复用资产整理成稳定形态。Pack 的价值是让项目协作从一次对话变成可复制、可检查、可恢复的结构。

类型总览

Pack	用途	典型位置
Seed Pack	项目初始化装备，包含 .maw、docs、prompts、ops 和示例目录。	仓库根目录
Prompt Pack	可复用提示词结构、提示词案例和表达规范。	prompts/ 或 examples/mawflow-packs/prompt-pack/
Task Pack	可恢复、分阶段执行的 AI 任务提示词工程。	项目内标准任务包目录
Check Pack	项目检查脚本、检查说明和 gate 规则。	ops/scripts/、docs/capabilities/
Verification Pack	交付后的验收、证据和风险记录。	docs/acceptance/、docs/delivery/
Case Pack	可公开的 Prompt Case 和执行复盘。	公开前必须授权、脱敏、复核

Seed Pack

Seed Pack 是项目起点。它提供 .maw 协作协议、文档结构、任务说明、检查脚本和示例 Pack，让普通仓库先具备 AI 协作秩序。

适合场景：

• 新建 AI Coding 项目。
• 给已有项目补协作协议和检查结构。
• 建立公开示例项目。

Prompt Pack

Prompt Pack 保存可复用的 Prompt Spec、提示词模板和案例。它帮助开发者把“我要做什么”表达成 AI 可执行任务。

一份 Prompt Pack 至少应说明：

• 适用场景。
• 输入资料。
• 允许修改和禁止修改边界。
• 验收标准。
• 推荐检查命令。

Task Pack

Task Pack 是复杂任务的可恢复执行结构。它通常包含：

• README.md：任务包说明。
• EXECUTE_PROMPT.md：给 AI 执行会话的入口。
• PLAN.md：任务拆解。
• manifest.json：任务包元数据。
• prompts/00-session-runbook.md：会话运行规则。
• 编号任务文件：分阶段执行。
• SESSION_STATE.md：任务状态、验证和恢复记录。

Task Pack 适合较长开发、文档迁移、功能实现、审计整改和发布准备。每个子任务都应能独立验证。

Check Pack

Check Pack 把项目质量要求变成命令和文档。常见检查包括：

• git diff --check。
• 模块档案检查。
• 本机边界检查。
• 公开发布 readiness 检查。
• 脱敏检查。
• 分发包就绪检查。

Check Pack 不只是脚本集合，还要说明失败时如何处理：哪些是阻断项，哪些是需要人工确认的风险。

Verification Pack

Verification Pack 保存交付后的证据。它回答三个问题：

1. 改了什么。
2. 怎么证明完成。
3. 还有什么风险。

典型内容包括测试结果、构建结果、检查输出摘要、验收结论、风险说明、交付记录和后续待办。

Case Pack

Case Pack 用于公开案例、Prompt Case 或执行复盘。它只有在用户授权、内容脱敏、维护者复核之后才适合公开。

不得公开客户名、项目名、账号、URL、token、日志正文、客户源码、客户截图或未公开任务记录。

Pack 元数据建议

每个可复用 Pack 至少说明：

字段	含义
name	稳定名称。
purpose	解决什么问题。
inputs	需要哪些上下文。
outputs	产出什么文件或证据。
safe_to_publish	是否可公开。
sanitization	公开前脱敏要求。
validation	检查命令或人工验收方式。

下一步

阅读 仓库平面与构造，理解 Pack 与项目目录如何配合。