Prompt Hub 用户手册
历史兼容说明：Prompt Hub 已并入 MAWflow Resource Center。本页保留 Prompt Spec 与提示词案例的操作说明，不再作为平行产品入口。
Prompt Hub 是 MAWflow 的需求表达与提示词资产中心。它帮助用户把原始想法整理成目标、范围、约束、任务说明和验收标准，再交给 MAWflow Seed、Project Space、Studio 或团队成员执行。
该页面为历史兼容说明。公共目录允许匿名浏览已审核的脱敏内容；创建、复制、版本保存、项目绑定和公开申请需要登录并拥有目标项目权限。新资源统一从 MAWflow Resource Center 进入。
它解决的不是“写一句更像 prompt 的话”，而是让 AI 和人都能判断：要做什么、为什么做、能改哪里、怎样验收、哪些资料不能进入上下文。
适用对象
- 只有想法，但不知道怎样写成清楚需求的人。
- 使用 AI 编程工具，但经常因为提示词不清导致返工的人。
- 希望沉淀需求模板、案例和表达规范的个人开发者、小团队或交付团队。
- 需要把 Project Clinic 的问诊结果整理成正式项目输入的人。
你可以用 Prompt Hub 做什么
| 目标 | 推荐功能 |
|---|---|
| 把一句想法写清楚 | Prompt Spec、Prompt Builder |
| 判断需求是否可执行 | Prompt Review、质量检查清单 |
| 复用常见场景 | Prompt Library、项目模板 |
| 从案例学习写法 | Prompt Cases |
| 进入代码项目 | 转给 MAWflow Seed 或 Studio |
| 沉淀团队经验 | 私有案例、脱敏后公开案例 |
快速开始路径
从公开案例开始
- 打开产品内
/prompt-hub/cases，按关键词、类别、可信级别和排序查找案例；筛选条件保留在 URL 中。 - 在详情确认版本、授权方式、质量分、完成度、脱敏步骤和证据摘要。
- 登录后填写你有权限访问的项目 Key，选择“复制到我的项目”。
- 系统创建归目标项目所有的私有派生副本，记录来源案例和锁定版本；原公开案例不会被修改。
- 在私有详情保存不可变版本，运行公开前检查，或把指定版本绑定到 Project Space。
从一句想法开始
- 打开产品内
/projects/<project-key>/prompt-builder，写下原始想法。 - 回答目标用户、输入输出、第一版边界、验收证据和风险上下文问题；刷新后可恢复服务端会话，未提交草稿保留在当前浏览器。
- 保存回答后生成候选最终提示词、质量评分卡和任务包草案。
- AI 服务或额度不可用时，页面会明确标注规则模板降级；不会把降级结果冒充模型生成。
- 选择“保存为私有 Case”，再到
/projects/<project-key>/prompt-cases查看版本、来源和公开状态。
最小 Prompt Spec 可以这样写：
目标：
背景：
输入资料：
允许修改：
不要修改：
验收标准：
验证方式：
安全边界：功能用法
写 Prompt Spec
Prompt Spec 是 Prompt Hub 的核心结构。它不要求你写很长，但必须让执行者知道边界。
| 字段 | 写法 |
|---|---|
| 目标 | 用一句话说明完成后的状态。 |
| 背景 | 说明为什么要做、当前问题是什么。 |
| 输入资料 | 列出需求、截图、接口说明、已有代码或参考链接。 |
| 允许修改 | 指定模块、页面、文档或配置范围。 |
| 不要修改 | 明确排除真实密钥、客户数据、生产配置或无关模块。 |
| 验收标准 | 说明怎样判断做完。 |
| 验证方式 | 写出命令、人工检查项或交付物。 |
使用模板库
模板库适合处理重复场景。使用模板时不要只替换标题，还要确认：
- 范围是否适合当前项目。
- 验收标准是否能被执行。
- 是否引用了不该公开的资料。
- 是否需要人工确认高风险动作。
使用案例
案例用于学习和派生，不是直接复制到你的项目里执行。公共详情只展示 approved 版本的 allowlist 字段；复制会生成新的私有所有权和版本链。已绑定项目的版本使用 locked 策略，不会静默跟随后续修改。
保存版本并绑定项目
- 私有 Case 可保存 public-safe 摘要和变更说明，生成只增不改的版本记录。
- 评审中或已公开版本被锁定，不能原地改写；需要先形成新的私有修订。
- “绑定当前版本到 Project Space”会保存 Case、版本、内容校验值、用途和锁策略；重复点击返回同一 binding。
- 绑定只建立可追踪引用，不代表任务包已经执行，也不会自动创建正式需求。
做质量检查
提交给 AI 或团队前，至少检查：
- 目标是否只有一个主方向。
- 输入资料是否足够。
- 修改边界是否清楚。
- 验收标准是否能判断通过或失败。
- 是否包含真实密钥、本机路径、客户数据或未脱敏日志。
与其它产品协作
| 下一步 | 连接方式 |
|---|---|
| Project Clinic | 当需求仍然模糊时，先回到问诊继续追问。 |
| MAWflow Seed | 把 Prompt Spec 放进仓库任务说明，交给 AI 执行会话。 |
| MAWflow Project Space | 把需求放进项目空间，继续拆成任务、验收和交付证据。 |
| MAWflow Studio | 以云端协作形态持续推进项目空间里的需求和工作项。 |
| MAWflow PM | 人工确认后保存为需求或工作项。 |
| AI Credits | 使用平台 AI 能力生成、改写或评估提示词时计入用量。 |
公开案例规则
Prompt Case 默认私有。公开案例必须满足：
- 用户主动授权。
- 删除真实姓名、客户名、内部路径、密钥、账号、日志和未公开业务资料。
- 保留必要上下文，但把业务细节转写成可公开示例。
- 用户二次确认。
- 官方审核通过后再发布。
实际状态流为：私有版本 → 提交公开评审 → 独立运营审核 → 公开；退修、驳回、撤回和下架均保留事件记录。创建人不能审核自己提交的案例，审核人也不能在批准时静默改写提交投影；内容变化必须退回并重新提交。
公开详情提供举报入口。举报只进入治理队列，不会因为一次点击自动删除内容；运营人员复核后才能下架。下架后公共目录不再展示该版本，已经复制或绑定到项目的私有锁定版本仍保留来源和风险提示。
失败与恢复
| 场景 | 恢复方式 |
|---|---|
| 搜索无结果 | 逐项清除筛选，保留其它条件。 |
| 没有项目权限 | 返回项目设置申请成员权限。 |
| Builder 刷新或网络中断 | 从历史会话继续；检查浏览器草稿是否已同步。 |
| 回答重复提交 | 相同内容复用原记录；不同内容提示版本冲突并要求刷新。 |
| AI 服务或额度不可用 | 查看明确降级状态，使用规则模板或稍后重试。 |
| 版本冲突 | 刷新当前 Case，比较最新版本后重新保存。 |
| 脱敏检查不通过 | 修改私有源内容；系统不会自动公开。 |
| 审核时源版本变化 | 撤回、保存新版本并重新提交。 |
| 重复复制或绑定 | 使用同一请求标识恢复原派生副本或 binding。 |
任务包校验会拒绝绝对路径、.. 路径穿越和异常文件数量。Prompt Hub 不接受任意远程 URL 让服务端代为下载任务包。
检查清单
| 检查项 | 通过标准 |
|---|---|
| 可执行 | 读完后知道第一步该做什么。 |
| 可验证 | 有命令、人工检查或交付物。 |
| 有边界 | 知道哪些内容不能读、不能改、不能公开。 |
| 可复用 | 通用表达和项目事实分开。 |
| 可交付 | 输出可以进入 Seed、Studio 或 PM。 |
| 版本锁定 | Project Space 引用明确的 Case version，不跟随源内容静默变化。 |
| 公开可信 | 有授权、脱敏、独立审核和事件记录，创建人不能自审。 |
公开边界
Prompt Hub 不替代项目执行、代码提交、发布上线或企业治理。它不默认公开用户案例，不托管真实密钥，不要求上传完整源码，也不会绕过人工确认执行高风险动作。
公共接口不会返回项目 Key、原始想法、私有回答、完整任务包或内部元数据。项目私有接口需要可信登录身份和项目成员权限；网页提交的操作者名称不作为可信身份。
按官网步骤自测
- 在公共目录组合关键词和可信级别筛选，切换质量排序，再清除单项筛选。
- 打开详情，确认只有脱敏摘要、版本、授权、质量和证据字段。
- 登录后复制到有权限的项目，确认形成私有派生版本且原案例不变。
- 在 Prompt Builder 创建会话、回答问题、刷新并继续。
- 重复保存相同回答和重复生成，确认不会产生重复资产或重复计费。
- 保存私有 Case 和新版本，确认版本号、内容校验值与来源关系可见。
- 绑定当前版本到 Project Space，重复点击确认只生成一个锁定 binding。
- 未勾选公开授权确认时，确认提交按钮不可用。
- 提交后用创建人尝试审核，确认被拒绝；用运营账号退修或批准。
- 批准后只在公共目录看到获批版本；修改源内容时必须重新提交。
- 举报公开案例并由运营下架，确认公共详情不可见、项目私有锁定副本仍在。
- 校验含绝对路径或
..的任务包文件清单，确认安全失败且不给出远程抓取入口。 - 在窄屏和键盘操作下检查搜索、复制、保存、绑定、撤回和审核摘要。
下一步阅读
- Project Clinic 用户手册：需求还不清楚时先问诊。
- MAWflow Seed 手册：把 Prompt Spec 放进代码仓库。
- MAWflow 项目空间说明：理解需求如何进入 Project Space。
- MAWflow Studio 用户手册：把需求推进到项目闭环。