Project Clinic 用户手册
当前状态：Early Access / 参与体验。已有真实规划型项目、问答会话、判断题、候选需求、Prompt Case、候选任务包和 Project Space 转交记录；它不会自动创建正式研发任务或执行代码。
Project Clinic 是 MAWflow 的 AI 项目问诊入口。它适合在“还没有形成项目说明”之前使用，通过追问把一句想法变成候选项目说明、风险清单和下一步路径。
Project Clinic 的价值是先问清楚，再进入 Prompt Hub、Seed 或 Project Space。它不直接替你启动代码任务。
适用对象
- 只有一个产品想法，还不知道第一版怎么落地的人。
- 需要把客户口述需求整理成项目输入的交付人员。
- 希望先判断范围、风险、预算和验收方式的一人公司或小团队。
- 企业验证项目开始前，需要先确认项目边界的负责人。
你可以用 Project Clinic 做什么
| 目标 | 输出 |
|---|---|
| 澄清想法 | 目标用户、核心问题、第一版范围。 |
| 识别风险 | 范围过大、资料缺失、验收不清、安全边界不明。 |
| 生成项目说明 | 候选目标、用户故事、范围、非目标、验收标准。 |
| 决定下一步 | 进入 Prompt Hub、Seed、Project Space、Lite、Studio 或 Enterprise 验证。 |
快速开始路径
- 先在 MAWflow Account 登录；未登录可以阅读本手册，但不能保存项目问诊。
- 进入项目工作台“新建项目”，选择“先做规划辅助”；这会创建不绑定 Git 仓库的规划型项目，并进入
/projects/{project_key}/clinic。 - 用一句话写清你的想法，开始问诊并至少回答 3 个问题。页面逐题自动保存，网络中断时保留当前浏览器草稿。
- 生成需求报告、判断题和候选需求；逐项确认、打叉并修正，未决项会阻止候选资产生成。
- 确认候选需求，再生成 Prompt Case 和仅供确认的候选任务包。重复点击或网络重试会复用原资产，不重复生成。
- 打开 Project Space 查看转交记录。规划辅助模式只保存候选资产；已有仓库模式仍需人工审批才能申请正式任务。
最小输入示例：
我的想法：
给谁使用：
现在最不确定的地方：
第一版想解决什么：
第一版不做什么：
时间、预算或安全限制：问诊结构
| 阶段 | 关键问题 |
|---|---|
| 目标 | 你希望项目完成后发生什么变化？ |
| 用户 | 谁会使用，谁会验收，谁会维护？ |
| 场景 | 用户现在怎样解决这个问题，卡在哪里？ |
| 范围 | 第一版必须完成什么，明确不做什么？ |
| 资料 | 是否已有代码、文档、截图、接口或客户反馈？ |
| 验收 | 怎样判断第一版可以交付？ |
| 风险 | 数据、密钥、合规、成本或时间有什么限制？ |
结果怎么使用
进入 Prompt Hub
当问诊结果已经比较清楚，但还需要写成可执行说明时，进入 Prompt Hub，把项目说明整理成 Prompt Spec、模板或候选任务说明。
进入 Seed
当你要开始一个代码仓库或开源项目时，把问诊结果写入项目 README、需求文档和任务说明，再使用 MAWflow Seed 建立仓库结构。
进入 Studio
当你要持续推进真实项目时，把问诊结果作为 Studio 的项目目标、需求调研和任务拆解输入。
进入 Project Space
当问诊结果已经确认，且项目需要持续跟踪需求、任务、审批、验收和证据时，生成动作会幂等创建或更新 Project Space 关联并留下 action/trace。规划辅助项目只写候选关联；已有仓库项目生成的是待审批任务请求，不会直接派发执行。Project Space 是后续 Lite、Studio 或 Enterprise 共同使用的项目空间中轴。
进入 Enterprise
当项目涉及团队权限、审批、审计、私有化或高敏感资料时，先把问诊结果作为低风险验证项目的评估材料。
检查清单
| 检查项 | 通过标准 |
|---|---|
| 用户明确 | 能说出谁使用、谁验收。 |
| 范围明确 | 第一版要做和不做都写清楚。 |
| 验收明确 | 能判断通过或失败。 |
| 风险明确 | 数据、密钥、成本、时间和合规限制被列出。 |
| 下一步明确 | 知道应该进入 Prompt Hub、Seed、Project Space、Studio 还是 Enterprise。 |
| 确认门通过 | 判断题无未决/未修正打叉，候选已由项目成员确认。 |
| 转交可追踪 | Prompt Case、候选任务包、追踪编号和 Project Space 转交记录可在刷新后恢复。 |
失败与恢复
| 情况 | 页面反馈 | 恢复方式 |
|---|---|---|
| 未登录 | 提示先登录，不保存匿名内容 | 登录后回到原项目路径 |
| 不是项目成员 | 不展示项目内容细节并拒绝写入 | 从项目设置申请成员权限 |
| 网络中断 | 服务端未保存，但当前回答保留在浏览器草稿 | 恢复网络后重试同一道题 |
| AI Provider 不可用 | 明确显示“规则辅助”降级 | 继续完成问诊或稍后重试 AI |
| 判断题未完成 | 禁止确认候选和生成资产 | 处理未决项；打叉后确认修正项 |
| 页面版本冲突 | 提示内容已被其它页面更新 | 刷新、复核差异后重新提交 |
| 重复提交 | 返回同一会话、报告、Prompt Case 和任务包 | 继续使用原结果 |
| 规划项目无仓库 | 只显示 export-only 和 Project Space 候选关联 | 绑定仓库后另走人工审批任务链 |
数据与权限边界
- 项目工作台写操作使用当前登录身份和服务端签名，浏览器传入的操作者字段不作为权限来源。
- 项目成员才可回答、确认和生成；管理员/系统运维仍有审计身份，匿名请求默认拒绝。
- 不要输入真实密钥、完整源码、生产日志、客户隐私或未脱敏资料；页面和事件不返回原始提示词日志或密钥。
- 候选需求、Prompt Case、候选任务包和 Project Space 转交记录都是候选/待审批状态，不代表代码已执行或项目已交付。
公开边界
Project Clinic 不是医疗问诊，不是法律或财务建议，不自动执行代码，不替代项目负责人做最终决策。它输出的是候选说明和建议，重要范围、预算、安全和合规判断仍需人工确认。Early Access 表示真实闭环已可体验，但开放规模、运营支持和外部环境仍在持续验证。
下一步阅读
- Prompt Hub 用户手册：把问诊结果整理成可执行说明。
- MAWflow 项目空间说明：理解确认后的项目如何进入 Project Space。
- 快速开始：从一句想法开始。
- 产品功能：查看 Project Clinic 在产品矩阵中的位置。