# Plain Plan

> 生成用户向、简洁的实现计划：少术语、无代码库类名，用人话说明会做成什么样。

- Skill: `gitbobobo/plain-plan` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gitbobobo/plain-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gitbobobo/plain-plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gitbobobo (https://skillmd.com/u/gitbobobo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gitbobobo/plain-plan

---


# Plain Plan

生成**用户向**的实现计划：短、能读完、普通人能懂「具体会怎么做」。

读者默认是**不写代码的决策者**。计划是决策材料，不是技术设计文档。

## 文字计划（默认产出）

### 硬性约束

1. **短**：默认控制在用户一屏内可读完（约 300–600 汉字 / 或等价英文篇幅）。复杂需求可略增，但必须分段且每段一句主旨；禁止长文墙。
2. **人话**：禁止代码库类名、文件路径、函数/接口名、框架黑话（如「注入 Repository」「挂 middleware」）。改用用户能感知的说法（「登录后记住身份」「提交前先检查必填项」）。
3. **说清做法**：不是只写目标，要写**实现方式长什么样**——用户/系统前后对比、关键步骤、谁触发、结果是什么。仍用生活化语言，不写伪代码。
4. **可决策**：每条改动写清「改什么体验/行为」和「不改什么」，便于用户点头或否决。
5. **不写代码**：不放代码块、不贴 schema、不列包名（除非用户点名要技术附录）。

### 推荐结构

用这一骨架，删掉空段，勿为凑结构注水：

```markdown
# <一句话：这次要达成什么>

## 做成什么样
- 现在：…
- 之后：…（用户能感知的变化）

## 怎么做（步骤）
1. …（一步 = 一个可理解的改动，附「为什么」半句）
2. …
3. …

## 不做什么
- …（明确边界，避免误解范围）

## 你需要拍板的点
- …（仅列出仍需用户选择的事项；没有则省略整节）
```

### 文风

- 短句；一条一行；少形容词。
- 术语不可避免时：先人话，括号里最多给一次通俗解释，不给类名。
- 禁止「赋能」「闭环」「对齐颗粒度」等空话。

### 自检（输出前）

- [ ] 删掉所有类名 / 路径 / API 符号后，计划是否仍完整？
- [ ] 非工程师能否据此回答「上线后我会看到什么」？
- [ ] 是否短到愿意通读，而不是想跳过？

## 图文网页（可选加深）

输出文字版计划后询问用户是否需要生成网页版计划。

### 目标

教育性讲解：帮用户**建立心智模型**，理解为什么这样改、改完世界变成什么样。

### 禁止

- 把文字计划原样复制进页面充字数
- 堆砌类名、目录树、接口表
- 纯装饰、无信息量的大图或动画噪音

### 页面应包含

按需选用：

1. **一句话目标**（页首）
2. **前后对比**：现在 vs 之后（图示或并排卡片）
3. **分步走查**：3–7 步，每步 = 小插图/示意图 + 一句人话 + 可选「若跳过这步会怎样」
4. **关键决策点**：需要用户拍板时，用选择题式呈现，而不是段落
5. **小结**：三句以内回顾「我们要做的事」

视觉：真实场景或简单示意图作主锚点；桌面与手机都可读。避免通用「AI 紫渐变」模板感。

### 交付

1. 生成本地单页 HTML 到系统临时目录。
2. 若环境可用，按 **html-preview** 技能上传并返回公开预览链接；否则给出本地文件路径供打开。