# Not A Vibe Coder

> 将模糊的项目想法转化为 8 份结构化规划文件，适用于全新项目。禁止在已有代码库上使用。

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

---


# 非氛围型编码器

一个将任何项目创意——无论多么模糊——转化为 8 份动态规划文档的技能。这些文档在长上下文窗口中充当项目的持久记忆。

文档是"我们达成了什么共识"的唯一依据；用户的实时指令始终拥有最终解释权，可随时覆盖文档内容。

## 核心原则（绝对不可违反）

1. **用户指令 > 文件 > AI 假设。** 如果用户说的内容与某份文件矛盾，以用户为准——然后更新相关文件以反映新指令。
2. **禁止静默添加。** 绝不添加用户未要求或未确认的功能、技术选型、页面、表格或规则。如果觉得缺了什么，先问——别自己猜。例外情况：用户明确说了"你填""剩下的你想想""你来定"等——见第 3 阶段。
3. **Design.md 是特殊文件。** 绝不能用你自己的审美填充 Design.md。写入前必须向用户询问风格方向（如极简、活泼、企业风、暗黑模式、新拟态等）和配色方案（或提供 2-3 套方案供选择）。
4. **初始规划时逐个文件、按顺序生成**——除非用户明确要求，否则不要一次性倾倒全部 8 个文件。
5. **Tracker.md 是仅追加的进度跟踪**——每完成一项工作就更新，绝不改写历史，只需勾选项并在出现新任务时追加即可。
6. **中途变更会连锁影响。** 如果用户在构建过程中请求的变更会影响之前的决策（如"其实用 Postgres 吧，不用 Firebase 了""加一个预订功能"），主动更新所有受影响文件，不需要逐个询问。然后总结变更内容。
7. **写之前先读。** 在任何会话开始时，如果项目中已存在这些文件，做任何操作前先读取全部 8 个——它们就是你的记忆。

## 8 个文件

| 文件 | 用途 |
|---|---|
| PRD.md | 应用功能描述、特性列表、目标、用户需求 |
| TechSpec.md | 架构设计、技术栈、API、数据库选型 |
| AppFlow.md | 用户流程与导航逻辑 |
| Design.md | UI/UX 规范、布局、风格、配色方案 |
| Schema.md | 数据库表结构、关系模型、数据定义 |
| ImplementationPlan.md | 分步开发路线图 |
| Tracker.md | 已完成任务、待办事项、进度记录 |
| Rules.md | 编码规范、约束条件、项目规则 |

## 工作流

### 第 0 阶段 — 意图检测

- 仅用于全新项目。如果项目已有代码文件，中止操作，不要使用本技能。
- 如果用户为全新项目提供了一个单行想法（如"帮我做一个餐厅点餐应用"），这是启动第 1 阶段的触发信号。
- 如果用户已经提供了完整详细的规格说明，仍可创建这些文件，但直接根据其描述填写——跳过冗余提问。

### 第 1 阶段 — PRD.md 优先

这是基础。其他所有文件都依赖它。

- 根据用户提供的内容（哪怕只是"餐厅应用"），提出少量澄清性问题来完善 PRD——目标受众、核心功能、平台（Web/移动端/两者都要）、必备项 vs 锦上添花、变现方式等。适合场景下使用 `ask_user_input_v0` 进行快速多选澄清。
- 用户也可以跳过问答环节，直接自行写入 PRD.md——如果他们说"我自己来填"，创建一个带章节标题和占位符的 PRD.md 骨架，等待他们填写。
- 不要臆造功能。如果用户回答模糊，再次追问或提供选项——不要用假设来填补空白。
- 一旦 PRD 内容充实，写入 PRD.md，展示给用户，获得确认后再进入下一个文件。

### 第 2 阶段 — 其余文件逐个生成（Design.md 除外）

按此顺序：TechSpec.md → AppFlow.md → Schema.md → ImplementationPlan.md → Rules.md → Tracker.md → Design.md（最后处理，见第 2.5 阶段）。

对每个文件：
- 基于 PRD 和已有文件提出草稿，或者如果有真正需要决策的地方就问用户问题（如"这里应该用 PostgreSQL 还是更简单的 SQLite/Firebase？"）。
- 展示草稿，请求确认或修改。
- 只有用户对当前文件满意后，才进入下一个文件。

如果说"剩下的你自己填，不要瞎猜，认真想清楚再填"——意思是：做出合理且有理有据的选择，与 PRD 及已陈述的约束保持一致（不是随机/偷懒的默认值），但在开始构建前仍需将所有内容展示给用户审核。"不要瞎猜"在这里的意思是"不得违背或超出 PRD 的意图"——而不是"每个细节都问一遍"。

### 第 2.5 阶段 — Design.md（始终需要交互）

未经用户确认绝不能编写 Design.md：
- 整体风格方向（如极简 / 现代 / 活泼 / 企业 / 复古 / 粗野主义 / 玻璃态 / 暗色优先）——必要时提供 `ask_user_input_v0` 选项。
- 配色方案——要么要求具体颜色/十六进制色值，要么提供 2-3 套与其选定风格匹配的方案供选择。
- 排版偏好、间距密度、任何他们喜欢的参考网站或应用。

只有在收集到这些输入后，才能编写 Design.md。

### 第 3 阶段 — 最终审查

- 全部 8 个文件草稿完成后，展示整个计划的简要摘要，请用户审阅所有内容（尤其是 Rules.md——询问是否要添加约束条件，如"不允许使用外部库""仅限 TypeScript""必须离线运行"等）。
- 明确询问："在我开始构建之前还有什么要修改的吗？"

### 第 4 阶段 — 构建

- 用户确认后，按照 ImplementationPlan.md 分步开始实施。
- 每完成一个步骤/任务，就在 Tracker.md 中标记完成（勾选项，如有必要可附简短备注/日期）。
- 未经用户明确指示，不得偏离 ImplementationPlan.md、Rules.md、TechSpec.md 或 Schema.md。
- 如果用户在构建中途给出了文件中没有的新指令：立即执行（用户指令是最终的），之后更新相关文件以保持文档同步。简要告知用户更新了哪些文件以及原因。

## 快速参考：决策规则

- 模糊的功能请求 → 先问，不要假设。
- 用户明确说"你来定""你自己想" → 做出合理的、符合 PRD 的选择，记录下来并提交审核——不要静默塞进去。
- 用户当前消息与文件产生冲突 → 以用户为准；然后同步该文件。
- Design.md → 必须先询问风格和配色，无例外。
- 任何已完成的任务 → 立即更新 Tracker.md。
- 项目中途转向 → 主动更新所有受影响文件，总结变更内容。

## 局限性

- 仅适用于全新项目。在已有代码库上运行会失败。
- 高度依赖初始 PRD 生成阶段用户输入的准确性。