# wendy7756/vibe-coding-guide 研究分析

## 本轮结论

`wendy7756/vibe-coding-guide` 的核心价值是非程序员视角。它把 IDE、LLM、Prompt 和个人经验分目录组织，
说明新手真正卡住的不是某个工具，而是语言、模型、工具和执行环境之间的关系。

本仓应该迁移它的“自然语言描述 -> AI 生成 -> 执行观察”解释框架，但必须补上 Git、测试、回滚和质量门禁。

## 本地证据

- 研究对象：`wendy7756/vibe-coding-guide`
- 当前研究角色：非程序员自然语言编程指南
- 原始仓库：`raw/repository/`
- 原始来源清单：`raw/sources.yml`
- 事实摘要：`domain.yml`

## 对标拆解

| 项 | 内容 |
|:---|:---|
| 参考对象 | `wendy7756/vibe-coding-guide` |
| 它解决的核心问题 | 让非程序员理解 Vibe Coding 的语言、工具、模型和提示词关系 |
| 核心机制 | `IDEs-and-Tools/`、`LLMs/`、`Prompts/`、`my-experience/` 分层 |
| 真正带来结果的动作 | 先解释对象关系，再进入工具操作 |
| 可迁移做法 | 非程序员路径、术语解释、经验型障碍清单 |
| 不可迁移条件 | 不弱化测试、版本控制、质量门禁和交付标准 |
| 下一步试用动作 | 为 getting-started 增加“非程序员先理解什么”的入口段 |

## 改良迭代

| 改良目标 | 原模式 | 本仓版本 | 验证指标 |
|:---|:---|:---|:---|
| 低门槛入口 | IDE / LLM / Prompt 分层解释 | 对象、目标、上下文、约束、验证五件事先讲清 | 非程序员能描述任务输入输出 |
| 经验障碍 | my-experience 承载个人经验 | 本仓沉淀常见误区和修正动作 | 常见问题能链接到对应文档 |
| 工程补强 | 概念解释为主 | 加入 Git、测试、回滚和门禁 | 新手不会只依赖聊天窗口 |

## 可迁移清单

- 把非程序员最先需要理解的对象关系写清：人、AI、提示词、工具、代码、运行环境。
- 用经验障碍反推 getting-started 的说明顺序。
- 提供“预期 vs 实际 + 最小复现”的 debug 表达模板。
- 将 prompt 模式候选进入提示词库前做质量筛选。

## 不可迁移清单

- 不把个人经验当成硬规则。
- 不降低工程交付标准来迁就低门槛。
- 不把 prompt 技巧当作 Vibe Coding 全部。

## 验证动作

| 动作 | 成功信号 | 失败信号 |
|:---|:---|:---|
| 写一段非程序员入口说明 | 读者能说清 AI 需要什么上下文 | 仍然只知道“让 AI 写代码” |
| 抽取 5 个常见障碍 | 每个障碍有修正动作 | 障碍只是情绪描述 |
| 筛选 prompt 模式 | 能进入提示词表或被明确淘汰 | prompt 无质量边界 |

## 沉淀判断

- 稳定结论进入 `docs/getting-started/` 和提示词库治理。
- 本研究域保持 P3 非程序员视角观察对象。
