Files
tradecatlabs f1f0b9fe75 refactor: move research domain to repository root (#58)
Move the complete research domain from docs/research to root-level research, update indexes and path-aware tooling, and align raw snapshot governance and CODEOWNERS.\n\nVerified with make test and GitHub CI.
2026-07-11 22:18:37 +08:00

2.8 KiB

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 非程序员视角观察对象。