MAWflow PM 用户手册
获得方式：随云端项目或 Workspace 直接使用。团队正式使用前仍应在目标环境完成权限、数据规模和回滚演练。
MAWflow PM 是 MAWflow 的原生项目主账本，用来记录需求、工作项、AI 授权、人工确认、验收结论和交付证据。它让项目推进不只停留在一次 AI 会话里。
MAWflow PM 是 Project Space 中的需求和工作项账本，不等于 Project Space 本身。Project Space 负责把项目手册、任务、审批、审计和证据放到同一空间体验里；PM 负责保存其中最关键的需求、授权和验收事实。
MAWflow PM 不强制替换用户既有项目管理系统。它关注的是 AI 项目执行中最容易丢失的事实：谁确认了需求、谁授权 AI 辅助、怎样验收、证据在哪里。
适用对象
- 需要把需求、任务、确认和验收放到同一条链路的人。
- 需要知道 AI 协作是否经过授权、是否有检查证据的小团队。
- 使用 Studio 或 Enterprise 时，需要保留项目主账本的负责人。
- 需要把外部项目管理系统中的关键事项转成 AI 可执行工作项的人。
你可以用 MAWflow PM 做什么
| 目标 | 用法 |
|---|---|
| 管理需求 | 保存目标、范围、非目标、验收标准和风险。 |
| 管理工作项 | 把需求拆成可跟进任务。 |
| 记录 AI 授权 | 标明哪些事项允许 AI 辅助，哪些必须人工确认。 |
| 记录人工确认 | 保存关键决策、审批、验收和回修请求。 |
| 关联证据 | 关联检查结果、交付物、审计 finding 和复盘摘要。 |
快速开始路径
- 登录 MAWflow 项目工作台，打开项目
/projects/{key}/pm，先确认首页 provider 和就绪态。 - 新项目可显式选择
maw_native；已接入外部系统的项目继续使用原主账本，先进入迁移向导做 dry-run。 - 在“需求中心”创建 Requirement，写清目标、描述、验收标准、负责人和里程碑。
- 打开需求详情，人工确认后生成 WorkItem 草稿；生成草稿不会自动创建 AI Task。
- 在“工作项”补负责人和 AI policy，填写操作理由，再按页面给出的允许动作推进状态。
- 点击“预览 AI 授权”，检查 scope、context refs、blocked paths、required tests 和 blocker；无 blocker 后再人工批准。
- 批准授权仍不会自动执行；再次点击“按批准授权创建 Task”才创建唯一关联 MAW Task。
- 从任务与 Evidence Timeline 回写 Artifact、TestRun 或 Verification；缺少验证证据时不能把工作项标为已验收。
- 人工验收后把工作项推进到 done/closed，并在 Activity 中复核 actor、来源、理由和版本。
第一次成功定义：一个 Requirement 被拆为至少一个 WorkItem，经人工预览和批准 AI 授权创建唯一 Task，回写验证证据后由用户完成验收；刷新页面后对象、版本、Activity 和关联关系仍可恢复。
开通与准备
| 检查 | 通过标准 |
|---|---|
| Provider | 当前项目明确显示 maw_native；外部 provider 项目只读或进入迁移向导。 |
| 项目权限 | 用户是 active 项目成员；迁移、切换和回滚需要治理角色。 |
| Objective | 创建 AI Task 前，项目至少有一个可关联 Objective。 |
| 负责人 | 进入执行或验收前，WorkItem 已设置负责人。 |
| 验收标准 | Requirement 确认前已有可判断的 acceptance criteria。 |
主账本对象
| 对象 | 记录什么 |
|---|---|
| Requirement | 项目需求、范围、非目标、验收标准。 |
| Work Item | 可执行任务、负责人、状态、验收方式。 |
| AI Authorization | AI 可以辅助的范围、输入资料和限制。 |
| Human Confirmation | 人工确认、拒绝、补充输入或回修请求。 |
| Evidence Link | 检查结果、交付物、审计 finding 和复盘。 |
常见用法
从需求到工作项
需求不能直接等同于任务。先确认目标和验收标准，再拆成工作项。每个工作项都应能回答：
- 为什么做。
- 修改或处理范围是什么。
- 哪些内容不能碰。
- 怎样验收。
- 谁负责确认结果。
管理 AI 授权
AI 授权不是“一键放开”。建议按工作项标记：
| 授权类型 | 适用场景 |
|---|---|
| 可辅助分析 | 让 AI 阅读公开或项目允许资料，输出建议。 |
| 可辅助撰写 | 让 AI 草拟文档、测试说明或任务说明。 |
| 可辅助修改 | 在限定范围内辅助代码或文档修改。 |
| 必须人工处理 | 涉及敏感资料、发布、财务、法律或高风险动作。 |
页面中的 AI 授权固定分三步：
- 预览：保存版本化 authorization，展示范围、上下文、禁止路径、测试要求、有效期和 blocker。
- 批准：由当前可信用户填写理由并确认；浏览器自报 actor 不作为身份来源。
- 创建 Task：只接受未过期的 approved authorization；重复请求返回同一 Task，不重复创建。
授权不包含发布、回滚、外部同步、敏感配置变更或 Host 重启。这些动作继续进入各自的审批和运维链路。
状态、并发与证据门
- Requirement 和 WorkItem 都返回
object_version；编辑、状态流转和授权决策必须提交页面当前版本。 - 两个页面并发修改时，旧版本会收到冲突，不会静默覆盖新数据。
- WorkItem 只能沿页面返回的
allowed_transitions推进；普通字段编辑不能绕过状态机。 - 进入执行或验收需要负责人；进入 done/completed/closed 需要 Verification 或 TestRun 引用。
- 每个关键写入带
client_request_id，网络重试返回原结果；同一 id 携带不同内容会被拒绝。
搜索、看板与 Activity
- 工作项支持标题/摘要/描述、状态、负责人、里程碑、AI 关联、blocker 和排序过滤。
- 看板按钮只展示当前状态允许的下一步，不使用无审计拖拽。
- Requirement 支持关键词、状态、负责人、里程碑、来源和排序过滤。
- PM 首页展示 Requirement、WorkItem、blocked、AI linked、done 计数和首次成功下一步。
- Activity 记录可信 actor、事件、前后状态、安全摘要、理由和 evidence refs；普通页面不展示敏感信息、原始日志或绝对路径。
从既有项目管理系统迁移与回滚
- 在
/projects/{key}/pm/migration填写操作理由并生成 dry-run。 - 检查 requirement/work item/release scope 数量、unmapped、conflict 和 rollback plan。
- 没有 blocker 后确认导入；导入只新增 native 对象与 ImportRef，不删除或改写原系统数据。
- 输入
CONFIRM_SWITCH_TO_MAW_NATIVE才能切换 provider。 - 如需回滚，输入
CONFIRM_ROLLBACK_TO_ZENTAO；回滚只切主账本路由，保留 native 历史。
页面加载、空状态和预览都不会自动导入、切换或回滚。同一时刻项目只有一个正式 PM provider。
记录验收
验收结论应包含：
- 做了什么。
- 用什么方式验证。
- 是否通过。
- 未覆盖风险是什么。
- 是否需要回修。
和其它产品协作
| 产品 | 协作方式 |
|---|---|
| MAWflow Project Space | 提供项目空间和协作界面，引用 PM 的需求和工作项账本。 |
| Studio | 提供 Project Space 的云端协作形态。 |
| MAWflow Mobile | 处理低风险确认、审批、验收和回修。 |
| Evidence | 保存检查结果、交付物和复盘摘要。 |
| Audit Center | 对 PM 关联证据做独立复核。 |
| Enterprise | 管理组织级权限、审批和审计策略。 |
检查清单
| 检查项 | 通过标准 |
|---|---|
| 需求可追踪 | 每个工作项能追溯到需求。 |
| 授权可解释 | AI 可做和不可做的范围清楚。 |
| 人工确认可见 | 关键决策不是散在聊天记录里。 |
| 验收可判断 | 有通过、失败或回修结论。 |
| 证据可关联 | 检查结果和交付物能找到。 |
失败与恢复
| 场景 | 页面反馈 | 恢复方式 |
|---|---|---|
当前不是 maw_native | 写操作关闭并显示 provider | 留在原系统，或先做迁移 dry-run |
| 版本冲突 | 返回当前 object version | 刷新后合并，再用新版本提交 |
| 状态跳转非法 | 显示当前允许动作 | 按状态机补前置步骤 |
| 缺负责人 | 阻止进入执行/验收 | 指定负责人后重试 |
| 缺 Verification/TestRun | 阻止 done/closed | 回写验证或测试引用 |
| AI 授权 blocker | 预览列出具体 blocker | 修复 policy、状态、Objective 或负责人后重新预览 |
| 授权过期/撤销 | 不创建 Task | 重新预览并人工批准 |
| 重复提交 | 返回原对象或 Task | 继续查看，不重复创建 |
| 迁移冲突/源版本变化 | 导入或切换被拒绝 | 重新 dry-run、处理冲突后再确认 |
公开边界
MAWflow PM 不直接执行本机任务，不替代测试系统、审计中心或发布检查，也不强制替换用户既有项目管理系统。公开手册只说明使用路径和协作边界，具体团队集成方式以产品开通和企业沟通为准。
按官网自行测试
- 打开 PM 首页，确认 provider、onboarding、readiness、计数和下一步可理解。
- 创建带验收标准的 Requirement，刷新后确认 version、负责人和里程碑保留。
- 生成 WorkItem 草稿，确认没有自动创建 Task。
- 用两个页面编辑同一对象，确认旧版本冲突。
- 尝试跳过状态或在无负责人时进入执行，确认被阻止。
- 完成 AI 授权预览、人工批准和创建 Task 三步，重复最后一步确认只得到一个 Task。
- 在缺验证证据时尝试 done，确认被阻止；补充 Verification 后再验收。
- 检查 Activity 中的 actor、理由、before/after 与 evidence refs。
- 对已接入外部系统的项目只做 dry-run，确认页面不会自动导入或切换；有条件时演练切换和回滚并确认两侧历史保留。
- 在窄屏完成查看、评论和低风险状态动作；迁移和复杂授权使用桌面。
下一步阅读
- MAWflow 项目空间说明：理解 PM 在项目空间中的位置。
- MAWflow Studio 用户手册：进入云端项目空间。
- MAWflow Mobile 用户手册：处理人在回路事项。
- Audit Center 用户手册：对证据做独立复核。