mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-15 11:58:04 +00:00
docs: make research domains actionable
- add research transfer synthesis with full 17-domain migration matrix - upgrade all research domain analysis files to actionable benchmark/iteration/validation structure - update research governance, README indexes, metadata, llms, and AI citation entries Validation: - make sync-doc-toc - make test - git diff --check - section coverage check for all 17 docs/research/*/analysis.md files Note: - welcome workflow failed because its action input names are stale; core content CI passed.
This commit is contained in:
@@ -2,43 +2,61 @@
|
||||
|
||||
## 本轮结论
|
||||
|
||||
- 这是面向非程序员的自然语言编程指南,价值在低门槛表达、工具解释和工作流概念化。
|
||||
- 它把 IDEs and Tools、LLMs、Prompts、my-experience 分目录组织,适合观察非工程读者需要什么上下文。
|
||||
- 本仓应吸收其“自然语言描述 -> AI 生成 -> 执行观察”的解释框架,但工程交付标准仍需更严格。
|
||||
`wendy7756/vibe-coding-guide` 的核心价值是非程序员视角。它把 IDE、LLM、Prompt 和个人经验分目录组织,
|
||||
说明新手真正卡住的不是某个工具,而是语言、模型、工具和执行环境之间的关系。
|
||||
|
||||
本仓应该迁移它的“自然语言描述 -> AI 生成 -> 执行观察”解释框架,但必须补上 Git、测试、回滚和质量门禁。
|
||||
|
||||
## 本地证据
|
||||
|
||||
- 研究对象:`wendy7756/vibe-coding-guide`
|
||||
- 当前研究角色:非程序员自然语言编程指南
|
||||
- 本轮成熟度:L1 初步理解
|
||||
- 原始仓库:`raw/repository/`
|
||||
- 原始来源清单:`raw/sources.yml`
|
||||
- 事实摘要:`domain.yml`
|
||||
|
||||
## 结构观察
|
||||
## 对标拆解
|
||||
|
||||
- 根目录包含 `IDEs-and-Tools/`、`LLMs/`、`Prompts/`、`my-experience/`、`README.md`、`README_EN.md`。
|
||||
- README 包含什么是 Vibe Coding、核心定义、起源发展、技术基础、核心工作流程。
|
||||
- 目录面向学习者,不是工具源码。
|
||||
| 项 | 内容 |
|
||||
|:---|:---|
|
||||
| 参考对象 | `wendy7756/vibe-coding-guide` |
|
||||
| 它解决的核心问题 | 让非程序员理解 Vibe Coding 的语言、工具、模型和提示词关系 |
|
||||
| 核心机制 | `IDEs-and-Tools/`、`LLMs/`、`Prompts/`、`my-experience/` 分层 |
|
||||
| 真正带来结果的动作 | 先解释对象关系,再进入工具操作 |
|
||||
| 可迁移做法 | 非程序员路径、术语解释、经验型障碍清单 |
|
||||
| 不可迁移条件 | 不弱化测试、版本控制、质量门禁和交付标准 |
|
||||
| 下一步试用动作 | 为 getting-started 增加“非程序员先理解什么”的入口段 |
|
||||
|
||||
## 可借鉴点
|
||||
## 改良迭代
|
||||
|
||||
- 非程序员入口要先解释语言、工具、模型和提示词之间的关系。
|
||||
- 经验目录能补足正式教程缺少的真实使用感。
|
||||
- 中英文 README 可以作为术语表达对照。
|
||||
| 改良目标 | 原模式 | 本仓版本 | 验证指标 |
|
||||
|:---|:---|:---|:---|
|
||||
| 低门槛入口 | IDE / LLM / Prompt 分层解释 | 对象、目标、上下文、约束、验证五件事先讲清 | 非程序员能描述任务输入输出 |
|
||||
| 经验障碍 | my-experience 承载个人经验 | 本仓沉淀常见误区和修正动作 | 常见问题能链接到对应文档 |
|
||||
| 工程补强 | 概念解释为主 | 加入 Git、测试、回滚和门禁 | 新手不会只依赖聊天窗口 |
|
||||
|
||||
## 风险和边界
|
||||
## 可迁移清单
|
||||
|
||||
- 概念解释多,工程验证少。
|
||||
- 非程序员视角可能弱化测试、版本控制和回滚。
|
||||
- 需要避免把经验性表述上升为工程原则。
|
||||
- 把非程序员最先需要理解的对象关系写清:人、AI、提示词、工具、代码、运行环境。
|
||||
- 用经验障碍反推 getting-started 的说明顺序。
|
||||
- 提供“预期 vs 实际 + 最小复现”的 debug 表达模板。
|
||||
- 将 prompt 模式候选进入提示词库前做质量筛选。
|
||||
|
||||
## 下一轮研究任务
|
||||
## 不可迁移清单
|
||||
|
||||
- 抽取非程序员路径中的关键障碍,反馈到本仓 getting-started。
|
||||
- 对照其 Prompts 目录,筛选可进入 prompts 表格的提示词模式。
|
||||
- 不把个人经验当成硬规则。
|
||||
- 不降低工程交付标准来迁就低门槛。
|
||||
- 不把 prompt 技巧当作 Vibe Coding 全部。
|
||||
|
||||
## 验证动作
|
||||
|
||||
| 动作 | 成功信号 | 失败信号 |
|
||||
|:---|:---|:---|
|
||||
| 写一段非程序员入口说明 | 读者能说清 AI 需要什么上下文 | 仍然只知道“让 AI 写代码” |
|
||||
| 抽取 5 个常见障碍 | 每个障碍有修正动作 | 障碍只是情绪描述 |
|
||||
| 筛选 prompt 模式 | 能进入提示词表或被明确淘汰 | prompt 无质量边界 |
|
||||
|
||||
## 沉淀判断
|
||||
|
||||
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
|
||||
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
|
||||
- 稳定结论进入 `docs/getting-started/` 和提示词库治理。
|
||||
- 本研究域保持 P3 非程序员视角观察对象。
|
||||
|
||||
Reference in New Issue
Block a user