UNPKG

article-writer-cn

Version:

AI 驱动的智能写作系统 - 专注公众号/自媒体文章创作

652 lines (447 loc) 18.3 kB
# PRD-09: 多模式写作系统 **版本**: v1.0 **创建时间**: 2025-01-26 **状态**: 待审核 **作者**: Claude Code Assistant --- ## 📋 背景与问题 ### 用户反馈 用户反馈 PRD-08 设计的"教练模式"存在以下问题: 1. **不适合所有文章类型**:信息整理型文章(如论文解读、技术总结)不需要深度个人经历 2. **效率太低**:快速产出场景(1-2小时)无法使用当前流程(需要 3-4 小时) 3. **强制性过强**:感觉"道德绑架用户"必须自己写每一段 4. **用户群体不匹配**:实际用户不全是专业博主,很多是效率导向的内容创作者 ### 当前设计的局限 **PRD-08 的设计假设**- ✅ 文章需要深度个人经历(产品测评、使用体验) - ✅ 追求 0% AI 检测率 - ✅ 用户是专业博主,愿意投入 3-4 小时深度创作 - ✅ AI 绝不能生成可用内容 **实际情况**- ❌ 很多文章是信息整理型(论文解读、知识科普) - ❌ 用户可接受 25-40% AI 检测率(换取效率) - ❌ 用户时间有限,希望 1-2 小时完成 - ❌ AI 可以生成初稿,用户负责审校修改 --- ## 🎯 设计目标 ### 核心目标 **在保留 PRD-08 核心价值的同时,支持多种创作场景** 1.**保留教练模式**:适合追求深度原创的文章(产品测评、个人观点) 2.**新增快速模式**:适合信息整理型文章(论文解读、技术总结) 3.**新增混合模式**:适合协作创作(教程、案例分析) 4.**用户自主选择**:不强制使用某种模式,根据需求选择 ### 非目标 - ❌ 不是要否定 PRD-08 的设计理念 - ❌ 不是要让所有文章都变成 AI 生成 - ❌ 不是要降低内容质量标准 --- ## 🎨 方案设计 ### 三种写作模式 #### 模式 1: 🎓 教练模式 (Coach Mode) **定位**:AI 是教练,用户是创作者 **工作原理**- AI 提问 → 用户回答 → AI 引导用户写 → AI 检查 - AI **绝不**生成可直接使用的内容 - 逐段引导,每段都由用户自己写 **适用场景**- ✅ 产品测评、使用体验 - ✅ 深度观点文章 - ✅ 个人成长经历 - ✅ 需要大量真实细节的内容 **输出质量**- **时间投入**:3-4 小时 - **AI 检测率**:< 15% - **质量评级**:⭐⭐⭐⭐⭐ **逻辑**:完全保留 PRD-08 的 `/write` 命令逻辑 --- #### 模式 2: ⚡ 快速模式 (Fast Mode) **定位**:AI 是助手,生成初稿,用户审校 **工作原理**- AI 根据 brief + 调研报告 + specification 生成完整初稿 - 用户审阅,指出需要修改的地方 - AI 修改 → 用户再审阅 → 循环直到满意 **适用场景**- ✅ 论文解读、技术总结 - ✅ 知识科普文章 - ✅ 信息整理型内容 - ✅ 时间紧急的创作 **输出质量**- **时间投入**:1-2 小时 - **AI 检测率**:25-40% - **质量评级**:⭐⭐⭐ **工作流程**``` 1. AI 读取上下文 - brief.md (需求) - specification.md (选题结构) - 调研报告 (数据来源) - materials-found.md (素材,如有) 2. AI 生成初稿 - 按照 specification 的结构生成 - 使用调研报告的数据 - 引用真实素材(如有) - 标注所有数据来源 3. 展示初稿并询问 ❓ 请审阅初稿,需要修改哪些部分? - 回复 "段落X需要..." - AI 修改指定部分 - 回复 "整体不错" - 进入下一步 - 回复 "重新生成" - AI 重新生成 4. 迭代修改 - 用户可以多轮指出需要修改的地方 - AI 逐一修改 - 最多 3 轮迭代 5. 保存 draft.md ``` --- #### 模式 3: 🔄 混合模式 (Hybrid Mode) **定位**:AI 写框架(40%),用户写核心(60%) **工作原理**- AI 生成:文章框架、过渡段落、数据总结(不需要个人经历的部分) - 用户写:核心观点、关键案例、个人经验(需要真实性的部分) - 协作完成一篇文章 **适用场景**- ✅ 教程类文章(AI 写步骤,用户写技巧) - ✅ 案例分析(AI 写背景,用户写分析) - ✅ 技术方案(AI 写对比,用户写选择理由) **输出质量**- **时间投入**:2-3 小时 - **AI 检测率**:18-25% - **质量评级**:⭐⭐⭐⭐ **工作流程**``` 1. AI 分析结构 - 识别哪些部分适合 AI 写(框架、过渡、数据) - 识别哪些部分需要用户写(观点、经验、案例) 2. AI 先写框架部分 - 生成开头、过渡、数据总结 - 标记 [用户补充] 的位置 3. 用户填写核心部分 - AI 提问引导(类似教练模式) - 用户写关键内容 - AI 检查真实性 4. 整合成完整文章 ``` --- ### 模式对比表 | 维度 | 教练模式 | 快速模式 | 混合模式 | |-----|---------|---------|---------| | **AI 角色** | 教练 | 助手 | 协作者 | | **AI 生成内容** | 0%(只提问) | 100%(初稿) | 40%(框架) | | **用户工作** | 100%(自己写) | 20%(审校) | 60%(核心) | | **时间投入** | 3-4 小时 | 1-2 小时 | 2-3 小时 | | **AI 检测率** | < 15% | 25-40% | 18-25% | | **质量评级** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | | **适用文章** | 个人经历型 | 信息整理型 | 混合型 | --- ## 🔄 流程调整 ### 调整点 1: `/specify` 命令 **新增功能:文章类型检测 + 模式推荐** 在生成 brief 时,AI 需要判断文章类型并推荐模式。 **brief 新增字段**```markdown ## 文章类型分析 ⭐ 新增 **内容类型**: - [x] 个人经历型(需要大量真实经历和细节) - [ ] 信息整理型(主要是整理/总结已有信息) - [ ] 混合型(既有信息整理,又需要个人观点) **推荐写作模式**: 🎓 教练模式 **推荐理由**: 这篇文章是产品测评,需要大量真实使用体验和具体数据。 教练模式能引导你挖掘出只有你知道的细节,AI 检测率会更低。 **其他可选模式**: - ⚡ 快速模式:如果时间紧急,可以选择快速模式,但 AI 味会较重(预计 30-35%) - 🔄 混合模式:AI 写对比框架,你写使用体验部分(预计 AI 味 20-25%) ``` **判断逻辑**``` IF 文章主题包含【评测、体验、使用感受、对比实测、我的看法】 THEN 类型 = 个人经历型 推荐 = 教练模式 ELSE IF 文章主题包含【论文解读、技术总结、知识科普、XX介绍】 THEN 类型 = 信息整理型 推荐 = 快速模式 ELSE THEN 类型 = 混合型 推荐 = 混合模式 ``` --- ### 调整点 2: `/write` 命令 ⚠️ 核心改造 **第一步:模式选择界面(新增)** ``` ╔════════════════════════════════════════════════════════╗ ║ 选择写作模式 ║ ╚════════════════════════════════════════════════════════╝ 📋 当前文章: Claude Code vs Cursor 评测 基于你的 brief,检测到文章类型:【个人经历型 - 产品测评】 推荐:🎓 教练模式 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 请选择写作模式: 1. 🎓 教练模式 - AI 引导你自己写每一段 ⭐ 推荐 适合: 产品测评、使用体验、深度观点 时间: 3-4 小时 | AI 检测率: < 15% | 质量: ⭐⭐⭐⭐⭐ 2. ⚡ 快速模式 - AI 生成初稿,你审校修改 适合: 论文解读、技术总结、知识科普 时间: 1-2 小时 | AI 检测率: 25-40% | 质量: ⭐⭐⭐ 3. 🔄 混合模式 - AI 写框架,你填关键细节 适合: 教程类、案例分析、技术方案 时间: 2-3 小时 | AI 检测率: 18-25% | 质量: ⭐⭐⭐⭐ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 💡 提示: - 模式 1 质量最高,但需要你投入更多时间 - 模式 2 最快,但 AI 味较重,需要后续更多审校 - 模式 3 平衡质量和效率 ⚠️ 重要: 选择后无法切换,请谨慎选择 请输入 1 / 2 / 3 选择模式: ``` **第二步:根据选择进入不同工作流** - **选择 1** → 执行当前 write.md 的教练模式逻辑(完全保留 PRD-08) - **选择 2** → 执行快速模式逻辑(新增) - **选择 3** → 执行混合模式逻辑(新增) --- ### 调整点 3: `/collect` 和 `/extract` 命令 **调整为可选步骤,根据模式决定** ``` /specify → /research → /topic → [模式选择] → 进入写作 ↓ ┌────────┼────────┐ ↓ ↓ ↓ 教练模式 快速模式 混合模式 ↓ ↓ ↓ /collect+ 直接 /collect /extract /write (可选) ↓ ↓ /write /write ``` **说明**- **教练模式**:强烈建议先执行 `/collect` + `/extract` 挖掘真实素材 - **快速模式**:跳过 `/collect``/extract`,直接基于调研报告生成 - **混合模式**:可选执行 `/collect`,用于核心部分的素材支持 --- ### 调整点 4: `/authentic` 命令 **调整为条件性执行** ``` - 教练模式: 必须执行 /authentic(检查真实性) - 快速模式: 可选执行(主要检查 AI 味,而非真实性) - 混合模式: 必须执行(检查用户写的部分) ``` --- ## 📊 用户场景对比 ### 场景 1: 产品深度评测(卡兹克类专业博主) **需求**- 需要深度真实体验 - 追求极低 AI 检测率(< 15%) - 愿意投入 3-4 小时 **推荐模式**:🎓 教练模式 **流程**``` /specify → /research → /topic → /collect → /extract ↓ /write (教练模式) → /authentic → /review (3遍) → /publish ``` --- ### 场景 2: 论文快速解读(效率导向用户) **需求**- 主要是信息整理 - 时间有限,1-2 小时完成 - 可接受 30-35% AI 检测率 **推荐模式**:⚡ 快速模式 **流程**``` /specify → /research → /topic ↓ /write (快速模式) → /review (style + detail) → /publish ``` **说明**:跳过 `/collect``/extract``/authentic` --- ### 场景 3: 技术教程(混合型) **需求**- 框架部分可以 AI 生成 - 关键技巧需要个人经验 - 平衡质量和效率 **推荐模式**:🔄 混合模式 **流程**``` /specify → /research → /topic → /collect (可选) ↓ /write (混合模式) → /authentic (检查用户部分) → /review → /publish ``` --- ## 🎯 实施优先级 ### P0 (必须实施) 1.**修改 `/specify`**:添加文章类型检测和模式推荐 2.**改造 `/write`** - 添加模式选择界面 - 保留教练模式逻辑(当前逻辑) - 实现快速模式逻辑 - 实现混合模式逻辑 ### P1 (建议实施) 3.**更新 `/topic`**:在选题讨论时提示推荐模式 4.**调整工作流提示**:在每个命令结束时,根据模式给出下一步建议 ### P2 (后续优化) 5. ⚠️ **添加模式切换**:允许用户在写作过程中切换模式(技术难度较高) 6. ⚠️ **模式混搭**:某些段落用教练模式,某些用快速模式(复杂度高) --- ## 📝 文件修改清单 ### 1. `templates/commands/specify.md` **修改内容**- 在 brief 标准格式中添加"文章类型分析"字段 - 添加文章类型判断逻辑 - 添加写作模式推荐逻辑 **预计修改量**:约 50 行 --- ### 2. `templates/commands/write.md` ⚠️ 重大改造 **修改内容**- **开头新增**:模式选择界面(约 40 行) - **保留**:当前教练模式全部逻辑(297 行,不动) - **新增**:快速模式逻辑(约 150 行) - **新增**:混合模式逻辑(约 200 行) **预计修改量**:约 390 行新增,0 行删除 **结构**```markdown # /write - 多模式写作 ## 第一步:选择写作模式 [模式选择 UI] ## 第二步:执行对应模式 ### 模式 1: 教练模式 [保留 PRD-08 全部逻辑] ### 模式 2: 快速模式 [新增逻辑] ### 模式 3: 混合模式 [新增逻辑] ``` --- ### 3. `templates/commands/topic.md` **修改内容**- 在生成 specification 后,添加模式推荐提示 **预计修改量**:约 20 行 --- ### 4. `docs/prd/prd-08-complete-workflow-redesign.md` **修改内容**- 在开头添加"PRD-09 扩展说明"章节 - 更新 `/write` 命令说明 - 添加多模式对比表 - 说明这是扩展而非否定 **预计修改量**:约 100 行 --- ## ⚠️ 风险与应对 ### 风险 1: 用户总选择快速模式 **风险描述**: 用户为了省时间,总是选择快速模式,导致内容质量下降。 **应对措施**1. ✅ 在模式选择时明确标注质量差异(星级评分) 2. ✅ 快速模式生成后,AI 提示"建议执行 `/review style` 降低 AI 味" 3. ✅ 在 `/review` 时,如果 AI 味过高(> 40%),强烈建议用户补充真实素材 --- ### 风险 2: 混合模式的边界不清晰 **风险描述**: 用户不知道哪些部分该 AI 写,哪些该自己写。 **应对措施**1. ✅ AI 在生成框架时,明确标记 `[用户补充]` 的位置 2. ✅ 提供示例:教程类文章(步骤 = AI,技巧 = 用户) 3. ✅ 提问引导:AI 像教练模式一样引导用户写核心部分 --- ### 风险 3: 快速模式的 AI 检测率过高 **风险描述**: 快速模式生成的内容 AI 味太重,超过 40%。 **应对措施**1. ✅ 在快速模式的生成逻辑中,强制使用口语化表达 2. ✅ 引用真实素材(如有 `/collect` 的结果) 3. ✅ 在生成后立即建议执行 `/review style`(风格审校) 4. ✅ 设置质量门槛:如果 AI 检测率 > 45%,强制用户补充真实素材 --- ## 📈 成功指标 ### 用户体验指标 1. **模式使用分布** - 目标:教练模式 30%,快速模式 50%,混合模式 20% - 说明:快速模式使用率高是正常的,但不应该 > 70% 2. **完整流程完成率** - 目标:> 80%(用户完整走完 /specify → /publish) - 当前:约 60%(很多用户在 /write 卡住) 3. **用户满意度** - 目标:4.5/5.0 - 收集反馈:"多模式设计是否解决了你的痛点?" --- ### 质量指标 1. **AI 检测率达标** - 教练模式:> 80% 文章 AI 检测率 < 15% - 快速模式:> 80% 文章 AI 检测率 < 40% - 混合模式:> 80% 文章 AI 检测率 < 25% 2. **内容质量** - 教练模式:⭐⭐⭐⭐⭐(保持当前水平) - 快速模式:⭐⭐⭐ 以上 - 混合模式:⭐⭐⭐⭐ 以上 --- ## 🎉 预期效果 ### 解决的问题 1.**支持多种创作场景**:不再强制所有文章都用教练模式 2.**提升流程灵活性**:用户可以根据时间和质量需求选择模式 3.**降低使用门槛**:信息整理型文章不再需要挖掘个人经历 4.**保留核心价值**:教练模式仍然存在,专业博主可以继续使用 ### 不改变的优势 1.**系统化流程**:仍然是 11 步完整流程(/specify → /publish) 2.**三遍审校**:所有模式都可以使用 `/review` 降低 AI 味 3.**真实性检查**:教练模式和混合模式仍然有 `/authentic` 保障 --- ## 🚀 下一步 ### 等待用户确认 请审阅此 PRD,如果同意,我将开始实施: 1. ✅ 修改 `templates/commands/specify.md` 2. ✅ 改造 `templates/commands/write.md`(重点) 3. ✅ 更新 `templates/commands/topic.md` 4. ✅ 更新 `docs/prd/prd-08-complete-workflow-redesign.md` ### 预计实施时间 - **P0(必须)**: 约 4-6 小时 - **P1(建议)**: 约 2 小时 - **总计**: 约 6-8 小时 --- ## 附录:常见问题 ### Q1: 为什么不直接替换 PRD-08? **A**: PRD-08 的设计理念是正确的,只是适用场景有限。多模式设计是**扩展而非否定**。 --- ### Q2: 快速模式会不会让用户"偷懒"? **A**: 不会。我们的设计是: - 明确标注质量差异(AI 检测率、星级评分) - 快速模式仍需要用户审校和修改 - 系统会在 AI 味过高时提示用户补充素材 快速模式的目标用户是**信息整理型文章**,而不是个人经历型文章。 --- ### Q3: 如何防止 AI 检测率失控? **A**: 质量门槛机制: 1. 快速模式生成时,强制口语化 2. 生成后建议立即执行 `/review style` 3. 如果 AI 检测率 > 45%,强制用户补充真实素材 4.`/publish` 前,最终检查 AI 检测率 --- ### Q4: 混合模式的 40% AI / 60% 用户是如何划分的? **A**: 按内容性质划分: **AI 负责写(40%)**- 文章框架(开头、结尾) - 过渡段落 - 数据总结和对比 - 背景介绍 **用户负责写(60%)**- 核心观点 - 个人经验和案例 - 关键技巧和心得 - 独特洞察 --- ### Q5: 如果用户中途想切换模式怎么办? **A**: - **P0 阶段**:不支持切换(技术复杂度高) - **P2 阶段**:考虑实现模式切换功能 - **临时方案**:删除 draft.md,重新执行 `/write` 并选择新模式 --- ## 结语 这个 PRD 的核心思想是: **不是要否定 PRD-08,而是承认"不是所有文章都需要深度原创"** 我们保留了教练模式的全部逻辑,同时为信息整理型文章提供了快速模式,为混合型文章提供了混合模式。 用户可以根据文章类型、时间预算、质量要求自主选择,而不是被强制使用单一模式。 **这才是真正的"以用户为中心"。** --- **待办事项**- [ ] 用户审阅并确认 PRD - [ ] 实施 P0 修改 - [ ] 实施 P1 修改 - [ ] 测试三种模式 - [ ] 更新文档 - [ ] 发布新版本