Plain Plan
生成用户向的实现计划:短、能读完、普通人能懂「具体会怎么做」。
读者默认是不写代码的决策者。计划是决策材料,不是技术设计文档。
文字计划(默认产出)
硬性约束
- 短:默认控制在用户一屏内可读完(约 300–600 汉字 / 或等价英文篇幅)。复杂需求可略增,但必须分段且每段一句主旨;禁止长文墙。
- 人话:禁止代码库类名、文件路径、函数/接口名、框架黑话(如「注入 Repository」「挂 middleware」)。改用用户能感知的说法(「登录后记住身份」「提交前先检查必填项」)。
- 说清做法:不是只写目标,要写实现方式长什么样——用户/系统前后对比、关键步骤、谁触发、结果是什么。仍用生活化语言,不写伪代码。
- 可决策:每条改动写清「改什么体验/行为」和「不改什么」,便于用户点头或否决。
- 不写代码:不放代码块、不贴 schema、不列包名(除非用户点名要技术附录)。
推荐结构
用这一骨架,删掉空段,勿为凑结构注水:
# <一句话:这次要达成什么>
## 做成什么样
- 现在:…
- 之后:…(用户能感知的变化)
## 怎么做(步骤)
1. …(一步 = 一个可理解的改动,附「为什么」半句)
2. …
3. …
## 不做什么
- …(明确边界,避免误解范围)
## 你需要拍板的点
- …(仅列出仍需用户选择的事项;没有则省略整节)
文风
- 短句;一条一行;少形容词。
- 术语不可避免时:先人话,括号里最多给一次通俗解释,不给类名。
- 禁止「赋能」「闭环」「对齐颗粒度」等空话。
自检(输出前)
- 删掉所有类名 / 路径 / API 符号后,计划是否仍完整?
- 非工程师能否据此回答「上线后我会看到什么」?
- 是否短到愿意通读,而不是想跳过?
图文网页(可选加深)
输出文字版计划后询问用户是否需要生成网页版计划。
目标
教育性讲解:帮用户建立心智模型,理解为什么这样改、改完世界变成什么样。
禁止
- 把文字计划原样复制进页面充字数
- 堆砌类名、目录树、接口表
- 纯装饰、无信息量的大图或动画噪音
页面应包含
按需选用:
- 一句话目标(页首)
- 前后对比:现在 vs 之后(图示或并排卡片)
- 分步走查:3–7 步,每步 = 小插图/示意图 + 一句人话 + 可选「若跳过这步会怎样」
- 关键决策点:需要用户拍板时,用选择题式呈现,而不是段落
- 小结:三句以内回顾「我们要做的事」
视觉:真实场景或简单示意图作主锚点;桌面与手机都可读。避免通用「AI 紫渐变」模板感。
交付
- 生成本地单页 HTML 到系统临时目录。
- 若环境可用,按 html-preview 技能上传并返回公开预览链接;否则给出本地文件路径供打开。