gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-08-18 05:18:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: add research domains and resource registry

Browse Source 
- add local external resources registry
- add research domain contract and per-repository research domains
- add raw fact snapshot governance and validation scripts

Validation:
- make test
- git diff --check HEAD~1..HEAD

Note:
- welcome workflow failed because its action input names are stale; core content CI passed.
This commit is contained in:
tradecatlabs
2026-07-03 08:20:22 +08:00
committed by GitHub
parent 2253a46935
commit a8099f52fe
254 changed files with 28589 additions and 165 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/research/wendy7756-vibe-coding-guide/AGENTS.md
+23
View File
@@ -0,0 +1,23 @@
# wendy7756/vibe-coding-guide 研究域 Agent 指南
本目录维护 `wendy7756/vibe-coding-guide` 的独立研究域。
## 目录职责
```text
wendy7756-vibe-coding-guide/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层：仓库元数据、研究角色、来源证据
└── raw/ # 原始事实层：拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `wendy7756/vibe-coding-guide`，不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`，并更新 `observed_at`。
- `raw/` 保存原始事实层，必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件；稳定事实摘要再同步到 `domain.yml`。
- README 只写判断、定位、使用方式和后续观察点，不堆外部 README 全文。
- 如果需要横向比较，在 `docs/research/README.md` 或新的对比文档中处理，不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc` 和 `make test`。
docs/research/wendy7756-vibe-coding-guide/README.md
+56
View File
@@ -0,0 +1,56 @@
# wendy7756/vibe-coding-guide 研究域
## 字多不看
- 本目录研究 `wendy7756/vibe-coding-guide` 这个外部仓库。
- 当前优先级：P3；研究角色：非程序员自然语言编程指南。
- GitHub 动态事实放在 `domain.yml`，观测日期为 2026-07-03。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
<details>
<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
### 细粒度目录
- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
</details>
## 使用方式
- 先读本 README 的判断，再读 `analysis.md` 的结构化研究结论，最后读 `domain.yml` 的事实字段。
- 需要引用 stars、forks、release、归档状态时，先重新核验 GitHub。
- 如果形成稳定方法论，再迁入 concepts、references、workflow 或 skills。
## 正文
### 研究定位
`wendy7756/vibe-coding-guide` 的当前研究定位是：非程序员自然语言编程指南。
### 当前判断
适合研究非程序员视角下的表达、门槛和误区。
### 观察字段
- GitHub URL：https://github.com/wendy7756/vibe-coding-guide
- 当前研究方向：`cn-onboarding`
- 当前优先级：P3
- 当前归档状态：`false`
- 主要语言：`None`
### 后续观察
- 是否有稳定文档结构、命令入口和可复用工作流。
- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。
docs/research/wendy7756-vibe-coding-guide/analysis.md
+44
View File
@@ -0,0 +1,44 @@
# wendy7756/vibe-coding-guide 研究分析
## 本轮结论
- 这是面向非程序员的自然语言编程指南，价值在低门槛表达、工具解释和工作流概念化。
- 它把 IDEs and Tools、LLMs、Prompts、my-experience 分目录组织，适合观察非工程读者需要什么上下文。
- 本仓应吸收其“自然语言描述 -> AI 生成 -> 执行观察”的解释框架，但工程交付标准仍需更严格。
## 本地证据
- 研究对象：`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、核心定义、起源发展、技术基础、核心工作流程。
- 目录面向学习者，不是工具源码。
## 可借鉴点
- 非程序员入口要先解释语言、工具、模型和提示词之间的关系。
- 经验目录能补足正式教程缺少的真实使用感。
- 中英文 README 可以作为术语表达对照。
## 风险和边界
- 概念解释多，工程验证少。
- 非程序员视角可能弱化测试、版本控制和回滚。
- 需要避免把经验性表述上升为工程原则。
## 下一轮研究任务
- 抽取非程序员路径中的关键障碍，反馈到本仓 getting-started。
- 对照其 Prompts 目录，筛选可进入 prompts 表格的提示词模式。
## 沉淀判断
- 本轮只完成 L1 理解，不直接迁入 concepts、references、workflow 或 skills。
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论，才进入稳定层。
docs/research/wendy7756-vibe-coding-guide/domain.yml
+37
View File
@@ -0,0 +1,37 @@
version: 1
repo:
name: wendy7756/vibe-coding-guide
source_name: wendy7756/vibe-coding-guide
url: https://github.com/wendy7756/vibe-coding-guide
research:
domain_id: wendy7756-vibe-coding-guide
domain_name: wendy7756/vibe-coding-guide 研究域
primary_direction: cn-onboarding
role: 非程序员自然语言编程指南
priority: 3
why_study: 适合研究非程序员视角下的表达、门槛和误区。
github_observed:
observed_at: '2026-07-03'
source: gh repo view
stars: 69
forks: 8
archived: false
language: null
license: apache-2.0
default_branch: main
pushed_at: '2025-08-11T07:57:18Z'
updated_at: '2026-06-30T06:05:14Z'
latest_release: null
homepage: ''
topics:
- vibe-coding
- ai
- coding
- developer
- developer-tools
source_evidence:
file: ChatGPT-中文Vibe Coding仓库 (2).md
line: 28
maintenance:
fact_policy: GitHub 动态字段只代表 observed_at 当日快照，更新结论前必须重新核验。
split_policy: 本目录已经是一等研究域；更深分析放入本目录新增文档。
docs/research/wendy7756-vibe-coding-guide/raw/AGENTS.md
+12
View File
@@ -0,0 +1,12 @@
# raw/ Agent 指南
本目录是 `wendy7756/vibe-coding-guide` 的原始事实层。
## 维护规则
- 只保存从研究对象拉取的一手材料，不写分析判断。
- `repository/` 是本地 Git 工作树，刷新时由脚本 clone 或 fast-forward pull。
- 不手工改写 `*.raw.*` 文件内容；需要刷新时运行 `python3 scripts/fetch-research-raw.py`。
- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
- 外部 README 原文必须保存为 `.txt`，避免本仓库 Markdown 链接检查误判。
- 分析、判断、采用建议和沉淀路径写回上一级 `README.md`、`analysis.md` 或 `decisions.md`。
docs/research/wendy7756-vibe-coding-guide/raw/README.md
+16
View File
@@ -0,0 +1,16 @@
# raw 事实层
本目录保存 `wendy7756/vibe-coding-guide` 的本地原始材料快照。
这里不写分析结论，只保存可复查的一手资料：
- `sources.yml`：来源清单、拉取时间、命令和文件状态。
- `repository/`：Git 仓库工作树；本目录由 `.gitignore` 忽略，只作为本地研究材料。
- `github-repo.raw.json`：GitHub 仓库元数据。
- `github-readme.raw.md.txt`：GitHub README 原文快照。
- `github-license.raw.txt`：GitHub license 原文快照；仓库无 license 时可能不存在。
- `github-root-contents.raw.json`：默认分支根目录内容快照。
- `github-languages.raw.json`：GitHub language 统计快照。
- `github-latest-release.raw.json`：最新 release 快照；无 release 时可能不存在。
`repository/` 是外部源码快照，不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存，避免其中的外部相对链接被本仓库 Markdown 链接检查误判。
docs/research/wendy7756-vibe-coding-guide/raw/github-languages.raw.json
+1
View File
@@ -0,0 +1 @@
{}
docs/research/wendy7756-vibe-coding-guide/raw/github-license.raw.txt
+201
View File
@@ -0,0 +1,201 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
docs/research/wendy7756-vibe-coding-guide/raw/github-readme.raw.md.txt
+475
View File
@@ -0,0 +1,475 @@
<div align="center">
# 自然语言编程指南
中文 | <a href="README_EN.md">English</a>
</div>
没有任何代码基础，我在过去三个月借助 ChatGPT 和 Cursor 成功开发了 **6个ios APP** 并上架 App Store，还上线了 **2个完整的网站项目**, 网站代码均已开源：全球旅游攻略平台[Global Travel Guide](https://github.com/wendy7756/globaltravelguide)，精准获客工具[FollowNet](https://github.com/wendy7756/FollowNet)。
直到现在我仍然不懂编程，但 AI 帮我写了所有代码。借助AI，人人都可以成为独立开发者。正因为亲身体验了 AI 编程的强大力量，我创建了这个开源项目 **Vibe Coding Guide**，希望每个有想法的人都能借助 AI 创造属于自己的产品，让技术不再是创意实现的门槛。
<div align="center">
<img src="my-experience/6apps.jpeg" alt="myapps" width="90%">
</div>
---
## 目录
- [什么是Vibe Coding](#什么是vibe-coding)
- [核心工作流程](#核心工作流程)
- [技术原理与实现](#技术原理与实现)
- [主要工具与平台](#主要工具与平台)
- [实战教程](#实战教程)
- [最佳实践](#最佳实践)
- [社区与资源](#社区与资源)
- [参考文献](#参考文献)
## 什么是Vibe Coding
Vibe Coding 氛围编程由OpenAI联合创始人Andrej Karpathy在2025年提出，将传统的手工码代码转变为与AI的协作对话，强调开发者通过自然语言描述需求，AI生成完整的可运行代码，开发者仅需迭代、反馈、测试即可完成项目开发。
### 核心定义
Vibe Coding可以定义为：**开发者通过自然语言（文字或语音）描述需求，AI（大型语言模型）生成完整的可运行代码，开发者通过迭代反馈进入"心流"状态的协作编程方式**。
### 起源与发展
Vibe Coding概念由Andrej Karpathy（OpenAI联合创始人、前特斯拉AI负责人）在2025年初提出。他描述这种方法为"完全沉浸在AI的vibe中"，强调：
- **自然交互**：用自然语言与AI对话，描述想要的功能
- **快速迭代**：AI生成代码，开发者测试和反馈
- **心流状态**：开发者专注于创意和逻辑，而非语法细节
### 技术基础
Vibe Coding的技术基础包括：
- **大型语言模型（LLMs）**：如GPT-4、Claude、Gemini等
- **自然语言处理（NLP）**：理解开发者的需求描述
- **代码生成技术**：将需求转化为可执行代码
- **实时反馈系统**：支持快速迭代和修正
## 核心工作流程
Vibe Coding的核心工作流程是一个持续的迭代循环，具体步骤如下：
### 1. 自然语言描述 (Natural Language Input)
开发者用自然语言描述需要实现的功能：
- **需求描述**：清楚地表达想要的功能和效果
- **上下文提供**：给出相关的背景信息和约束条件
- **目标明确**：说明期望的输出结果
**示例**：
```
"创建一个用户注册页面，包含用户名、邮箱、密码输入框，
带有表单验证和提交功能，使用合适的技术栈"
```
### 2. AI代码生成 (AI Code Generation)
AI分析描述并生成相应的代码：
- **需求解析**：理解开发者的意图和要求
- **代码生成**：创建完整的可运行代码
- **最佳实践**：遵循编程规范和安全标准
### 3. 执行与观察 (Execute & Observe)
开发者运行AI生成的代码：
- **代码执行**：运行生成的代码查看效果
- **功能测试**：验证是否满足预期需求
- **问题识别**：发现潜在的bug或改进点
### 4. 反馈与修正 (Feedback & Refinement)
根据测试结果提供反馈：
- **错误报告**：报告发现的问题和错误
- **功能调整**：请求修改或增强功能
- **优化建议**：提出性能或用户体验改进
**示例反馈**：
```
"按钮颜色应该是蓝色的，密码验证需要包含特殊字符要求"
```
### 5. 迭代循环 (Iteration Loop)
重复以上过程直到满足需求：
- **持续改进**：多轮迭代完善功能
- **增量开发**：逐步添加新功能
- **质量保证**：确保代码质量和稳定性
## 技术原理与实现
### 核心技术架构
#### 大型语言模型（LLMs）
Vibe Coding的核心依赖于先进的大型语言模型：
- **GPT-4/GPT-4o**：OpenAI的最新模型，具有强大的代码生成能力
- **Claude 4 Sonnet**：Anthropic的高性能模型，擅长复杂推理
- **Gemini Pro**：Google的多模态模型，支持文本和图像理解
#### 自然语言处理流程
1. **意图识别**：理解开发者的真实需求
2. **上下文分析**：考虑项目背景和约束条件
3. **技术选型**：选择合适的技术栈和框架
4. **代码生成**：产生结构化的、可运行的代码
5. **质量检查**：自动检测潜在问题和改进点
#### 实时反馈机制
- **错误检测**：实时识别语法和逻辑错误
- **性能分析**：评估代码效率和优化建议
- **安全扫描**：检测潜在的安全漏洞
- **最佳实践**：确保代码符合行业标准
### 实现方式
#### 基于IDE的集成
- **实时补全**：在编辑器中提供智能代码建议
- **上下文感知**：理解整个项目的代码结构
- **多文件协调**：处理跨文件的代码依赖关系
#### 对话式开发
- **聊天界面**：通过自然语言对话进行开发
- **多轮交互**：支持持续的需求澄清和代码改进
- **历史记录**：记住之前的对话和决策
#### 自主代理系统
- **任务分解**：将复杂需求分解为可管理的小任务
- **自动执行**：AI可以自主完成某些开发步骤
- **质量保证**：内置的测试和验证机制
## 主要工具与平台
### AI编程助手
#### 主流AI编程工具
- **GitHub Copilot**: GitHub和OpenAI联合开发的AI编程助手
- **Cursor**: 基于VS Code的AI原生IDE，支持完整的对话式编程
- **Claude Code**: Anthropic的Claude模型，擅长代码生成和调试
#### 专业编程扩展
- **Cline**: VS Code开源扩展，支持计划和执行开发任务
- **Roo Code**: 自主开发代理，可以循环执行计划-编码-测试-调试
- **Tabnine**: 基于AI的代码补全工具
- **CodeWhisperer**: Amazon的AI代码生成服务
### 对话式开发平台
#### 无代码AI构建器
- **Lovable**: 浏览器内的AI应用构建平台
- **Vitara**: 支持自然语言描述的全栈应用生成器
- **Bolt.new**: StackBlitz的AI驱动的全栈开发环境
- **v0.dev**: Vercel的AI界面生成工具
#### 专业开发环境
- **Replit**: 支持AI协作的云端IDE
- **CodeSandbox**: 在线代码编辑器，集成AI助手
- **Gitpod**: 云端开发环境，支持AI增强功能
### 专业化AI工具
#### 代码审查与测试
- **Sweep AI**: 自动生成Pull Request修复的AI工具
- **Codium**: AI驱动的测试生成和代码审查工具
- **DeepCode**: 基于AI的代码质量分析
- **Snyk Code**: AI增强的安全漏洞检测
#### 项目管理与协作
- **Linear**: 集成AI功能的项目管理工具
- **Notion AI**: 支持AI协作的文档和项目管理
- **GitHub Issues AI**: 自动分析和处理GitHub Issues
## 实战教程
### 入门教程：你的第一个Vibe Coding项目
#### 步骤1：选择AI编程工具
推荐初学者使用的工具：
- **Cursor**: 下载并安装Cursor IDE
- **GitHub Copilot**: 在VS Code中安装Copilot扩展
- **Claude**: 访问claude.ai进行对话式编程
#### 步骤2：制定项目提示（Prompt）
清晰的需求描述是成功的关键：
**有效提示示例**：
```
"我想创建一个待办事项应用，具有以下功能：
1. 添加、编辑、删除待办事项
2. 标记完成状态
3. 按日期排序
4. 使用React和Tailwind CSS
5. 数据存储在localStorage中
6. 包含深色模式切换"
```
#### 步骤3：与AI对话开发
开始与AI的协作开发过程：
**对话流程**：
1. **初始需求**：描述你想要的应用
2. **AI回应**：AI生成代码框架
3. **运行测试**：执行生成的代码
4. **反馈修正**：报告问题或提出改进
5. **迭代优化**：重复直到满意
**示例对话**：
```
你: "帮我创建一个简单的计算器应用"
AI: [生成HTML+CSS+JavaScript代码]
你: "按钮太小了，能否增大一些？"
AI: [修改CSS样式，增大按钮尺寸]
你: "添加键盘支持"
AI: [添加键盘事件监听器]
```
#### 步骤4：优化和部署
完善项目并部署：
**优化检查清单**：
- [ ] 功能完整性测试
- [ ] 响应式设计验证
- [ ] 性能优化检查
- [ ] 错误处理完善
- [ ] 代码质量审查
**部署选项**：
- **Vercel**: 最适合React/Next.js应用
- **Netlify**: 静态网站部署
- **GitHub Pages**: 免费的静态托管
### 进阶教程：复杂项目的Vibe Coding
#### 项目分解策略
将大型项目分解为可管理的模块：
1. **用户界面层**：
```
"创建应用的主要布局，包含导航栏、侧边栏和主内容区域"
```
2. **数据层**：
```
"设计用户数据模型，包括注册、登录和个人资料管理"
```
3. **业务逻辑层**：
```
"实现核心功能逻辑，如搜索、过滤和数据处理"
```
#### 多轮对话管理
保持上下文连续性的技巧：
**上下文提示**：
```
"基于之前创建的用户认证系统，现在添加密码重置功能"
```
**引用之前的代码**：
```
"修改我们之前讨论的登录组件，添加'记住我'选项"
```
#### 代码审查与重构
使用AI进行代码优化：
**重构提示**：
```
"请审查这段代码的性能和可维护性，并提供改进建议"
```
**安全检查**：
```
"检查这个用户输入处理代码是否存在安全漏洞"
```
## 最佳实践
### 有效提示工程
#### 1. 清晰的需求描述
好的提示应该具备以下特征：
- **具体明确**：避免模糊的表述，提供具体的功能需求
- **技术栈说明**：明确指定想要使用的技术和框架
- **约束条件**：说明性能、兼容性等限制条件
- **预期结果**：描述期望的最终效果
**示例对比**：
```
❌ 糟糕的提示：
"做一个网站"
✅ 好的提示：
"使用React和Tailwind CSS创建一个响应式的个人博客网站，
包含文章列表、详情页面、搜索功能，支持Markdown渲染"
```
#### 2. 迭代式开发
- **小步快跑**：每次只要求实现一个小功能
- **逐步完善**：基于前一步的结果提出改进
- **保持上下文**：在对话中引用之前的代码
### 常见问题与解决方案
#### 1. AI生成代码质量差
**问题**：代码存在bug或不符合最佳实践
**解决方案**：
- 提供更具体的技术要求
- 分步骤生成，逐步完善
- 结合人工审查和修正
#### 2. 上下文丢失
**问题**：AI忘记了之前的对话内容
**解决方案**：
- 在新的对话中重新提供关键信息
- 使用代码注释记录设计决策
- 保持对话的连续性
#### 3. 过度依赖AI
**问题**：团队成员缺乏基础编程能力
**解决方案**：
- 平衡AI使用和传统学习
- 定期进行技术培训
- 建立代码审查机制
## 社区与资源
### 学习资源
#### Vibe Coding专门资源
- **Vibe Coding Guide**: [https://ai-hive.net/datacenters/vibe-coding](https://ai-hive.net/datacenters/vibe-coding)
- **Andrej Karpathy的博客**: [https://karpathy.ai](https://karpathy.ai)
- **MIT Technology Review**: [Vibe Coding解释](https://www.technologyreview.com/2025/04/16/1115135/what-is-vibe-coding-exactly/)
#### AI编程教程
- **Prompt Engineering指南**: [https://www.promptingguide.ai](https://www.promptingguide.ai)
- **OpenAI Cookbook**: [https://cookbook.openai.com](https://cookbook.openai.com)
- **Anthropic的Claude文档**: [https://docs.anthropic.com](https://docs.anthropic.com)
#### 视频教程
- **Cursor IDE教程**: YouTube上的官方教程
- **GitHub Copilot最佳实践**: Microsoft Learn
- **AI编程技巧**: Fireship, Code with Antonio
#### 技术博客
- **Google Cloud AI Blog**: [https://cloud.google.com/blog/topics/ai-ml](https://cloud.google.com/blog/topics/ai-ml)
- **Hugging Face Blog**: [https://huggingface.co/blog](https://huggingface.co/blog)
- **OpenAI Research**: [https://openai.com/research](https://openai.com/research)
### 开源项目
#### Vibe Coding相关项目
- **Aider**: [https://github.com/paul-gauthier/aider](https://github.com/paul-gauthier/aider) - 命令行AI编程助手
- **Cline**: [https://github.com/cline/cline](https://github.com/cline/cline) - VS Code自主开发扩展
- **Devin**: [https://github.com/Cognition-AI/devin](https://github.com/Cognition-AI/devin) - AI软件工程师
#### 提示工程库
- **LangChain**: [https://github.com/langchain-ai/langchain](https://github.com/langchain-ai/langchain)
- **Guidance**: [https://github.com/guidance-ai/guidance](https://github.com/guidance-ai/guidance)
- **Promptflow**: [https://github.com/microsoft/promptflow](https://github.com/microsoft/promptflow)
### 社区平台
#### 讨论社区
- **Reddit r/MachineLearning**: AI编程讨论
- **Discord服务器**: Cursor IDE, GitHub Copilot官方群
- **Stack Overflow**: AI编程相关问题
#### 开发者社区
- **Hugging Face Community**: [https://huggingface.co/community](https://huggingface.co/community)
- **OpenAI Community**: [https://community.openai.com](https://community.openai.com)
- **GitHub Discussions**: 各大AI编程工具的讨论区
### 工具与平台
#### AI编程工具
- **Cursor**: [https://cursor.sh](https://cursor.sh)
- **GitHub Copilot**: [https://github.com/features/copilot](https://github.com/features/copilot)
- **Windsurf**: [https://codeium.com/windsurf](https://codeium.com/windsurf)
- **Replit**: [https://replit.com](https://replit.com)
#### 在线IDE
- **CodeSandbox**: [https://codesandbox.io](https://codesandbox.io)
- **StackBlitz**: [https://stackblitz.com](https://stackblitz.com)
- **Gitpod**: [https://gitpod.io](https://gitpod.io)
#### 部署平台
- **Vercel**: [https://vercel.com](https://vercel.com)
- **Netlify**: [https://netlify.com](https://netlify.com)
- **Railway**: [https://railway.app](https://railway.app)
## 参考文献
### 核心文献
1. **Karpathy, A.** (2025). *Vibe Coding: A New Programming Paradigm*. OpenAI Blog.
2. **Chen, M., et al.** (2021). *Evaluating Large Language Models Trained on Code*. arXiv:2107.03374.
3. **Austin, J., et al.** (2021). *Program Synthesis with Large Language Models*. arXiv:2108.07732.
4. **Li, Y., et al.** (2022). *Competition-Level Code Generation with AlphaCode*. Science, 378(6624), 1092-1097.
5. **Nijkamp, E., et al.** (2022). *CodeGen: An Open Large Language Model for Code Generation*. arXiv:2203.13474.
### 技术研究
6. **Fried, D., et al.** (2023). *InCoder: A Generative Model for Code Infilling and Synthesis*. ICLR 2023.
7. **Wang, Y., et al.** (2023). *CodeT5+: Open Code Large Language Models for Code Understanding and Generation*. arXiv:2305.07922.
8. **Rozière, B., et al.** (2023). *Code Llama: Open Foundation Models for Code*. arXiv:2308.12950.
9. **Zheng, S., et al.** (2024). *SWE-RL: Training Code Generation Models with Reinforcement Learning from Software Engineering Feedback*. arXiv:2401.03994.
### 行业报告
10. **Y Combinator** (2025). *AI-Generated Codebases in Startup Ecosystem*. YC Research.
11. **GitHub** (2024). *GitHub Copilot Impact Report: Developer Productivity Study*. GitHub Inc.
12. **McKinsey & Company** (2024). *The Economic Impact of AI-Assisted Programming*. McKinsey Global Institute.
13. **Stack Overflow** (2024). *Developer Survey: AI Tools in Programming*. Stack Overflow Insights.
### 网络资源
#### 官方文档
- **OpenAI Codex**: [https://openai.com/blog/openai-codex](https://openai.com/blog/openai-codex)
- **GitHub Copilot Documentation**: [https://docs.github.com/en/copilot](https://docs.github.com/en/copilot)
- **Anthropic Claude for Coding**: [https://docs.anthropic.com/claude/docs/coding](https://docs.anthropic.com/claude/docs/coding)
#### 研究机构
- **MIT CSAIL**: [https://www.csail.mit.edu](https://www.csail.mit.edu)
- **Stanford HAI**: [https://hai.stanford.edu](https://hai.stanford.edu)
- **Google Research**: [https://research.google](https://research.google)
#### 技术博客
- **The Pragmatic Engineer**: [https://blog.pragmaticengineer.com](https://blog.pragmaticengineer.com)
- **Towards Data Science**: [https://towardsdatascience.com](https://towardsdatascience.com)
- **AI Research**: [https://ai.googleblog.com](https://ai.googleblog.com)
#### 学术数据库
- **arXiv Computer Science**: [https://arxiv.org/list/cs/recent](https://arxiv.org/list/cs/recent)
- **ACM Digital Library**: [https://dl.acm.org](https://dl.acm.org)
- **IEEE Xplore**: [https://ieeexplore.ieee.org](https://ieeexplore.ieee.org)
#### 开源项目
- **Hugging Face Code Models**: [https://huggingface.co/models?pipeline_tag=text-generation&other=code](https://huggingface.co/models?pipeline_tag=text-generation&other=code)
- **Papers with Code**: [https://paperswithcode.com/task/code-generation](https://paperswithcode.com/task/code-generation)
- **Awesome AI for Code**: [https://github.com/sourcegraph/awesome-ai-coding](https://github.com/sourcegraph/awesome-ai-coding)
---
## 贡献指南
欢迎为本指南贡献内容！请遵循以下步骤：
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 创建 Pull Request
## 许可证
本项目采用 Apache License 2.0 许可证。详情请参阅 [LICENSE](LICENSE) 文件。
---
*让编程成为一种美的享受。*
docs/research/wendy7756-vibe-coding-guide/raw/github-repo.raw.json
+44
View File
@@ -0,0 +1,44 @@
{
"createdAt": "2025-07-14T07:02:41Z",
"defaultBranchRef": {
"name": "main"
},
"description": "Beginner’s Vibe Coding Guide. AI氛围编程指南 Natural Language Programming 自然语言编程",
"forkCount": 8,
"homepageUrl": "",
"isArchived": false,
"isFork": false,
"isMirror": false,
"latestRelease": null,
"licenseInfo": {
"key": "apache-2.0",
"name": "Apache License 2.0",
"nickname": ""
},
"nameWithOwner": "wendy7756/vibe-coding-guide",
"primaryLanguage": null,
"pushedAt": "2025-08-11T07:57:18Z",
"repositoryTopics": [
{
"name": "vibe-coding"
},
{
"name": "ai"
},
{
"name": "coding"
},
{
"name": "developer"
},
{
"name": "developer-tools"
}
],
"stargazerCount": 69,
"updatedAt": "2026-06-30T06:05:14Z",
"url": "https://github.com/wendy7756/vibe-coding-guide",
"watchers": {
"totalCount": 1
}
}
docs/research/wendy7756-vibe-coding-guide/raw/github-root-contents.raw.json
+130
View File
@@ -0,0 +1,130 @@
[
{
"name": ".gitignore",
"path": ".gitignore",
"sha": "e43b0f988953ae3a84b00331d0ccf5f7d51cb3cf",
"size": 10,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/.gitignore?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/blob/main/.gitignore",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/e43b0f988953ae3a84b00331d0ccf5f7d51cb3cf",
"download_url": "https://raw.githubusercontent.com/wendy7756/vibe-coding-guide/main/.gitignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/.gitignore?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/e43b0f988953ae3a84b00331d0ccf5f7d51cb3cf",
"html": "https://github.com/wendy7756/vibe-coding-guide/blob/main/.gitignore"
}
},
{
"name": "IDEs-and-Tools",
"path": "IDEs-and-Tools",
"sha": "472875ef94f3b3cc4f9a43f1f88347525305319f",
"size": 0,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/IDEs-and-Tools?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/tree/main/IDEs-and-Tools",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/472875ef94f3b3cc4f9a43f1f88347525305319f",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/IDEs-and-Tools?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/472875ef94f3b3cc4f9a43f1f88347525305319f",
"html": "https://github.com/wendy7756/vibe-coding-guide/tree/main/IDEs-and-Tools"
}
},
{
"name": "LICENSE",
"path": "LICENSE",
"sha": "261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64",
"size": 11357,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/LICENSE?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/blob/main/LICENSE",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64",
"download_url": "https://raw.githubusercontent.com/wendy7756/vibe-coding-guide/main/LICENSE",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/LICENSE?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64",
"html": "https://github.com/wendy7756/vibe-coding-guide/blob/main/LICENSE"
}
},
{
"name": "LLMs",
"path": "LLMs",
"sha": "e0593945b4771ebe18fb314041a4e724b8179438",
"size": 0,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/LLMs?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/tree/main/LLMs",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/e0593945b4771ebe18fb314041a4e724b8179438",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/LLMs?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/e0593945b4771ebe18fb314041a4e724b8179438",
"html": "https://github.com/wendy7756/vibe-coding-guide/tree/main/LLMs"
}
},
{
"name": "Prompts",
"path": "Prompts",
"sha": "ee70804eca0b4bae7729d788a52f1fdc9e0685d1",
"size": 0,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/Prompts?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/tree/main/Prompts",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/ee70804eca0b4bae7729d788a52f1fdc9e0685d1",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/Prompts?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/ee70804eca0b4bae7729d788a52f1fdc9e0685d1",
"html": "https://github.com/wendy7756/vibe-coding-guide/tree/main/Prompts"
}
},
{
"name": "README.md",
"path": "README.md",
"sha": "5cba12b4005077b10508996013e05799d3f62a2a",
"size": 17734,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/README.md?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/blob/main/README.md",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/5cba12b4005077b10508996013e05799d3f62a2a",
"download_url": "https://raw.githubusercontent.com/wendy7756/vibe-coding-guide/main/README.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/README.md?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/5cba12b4005077b10508996013e05799d3f62a2a",
"html": "https://github.com/wendy7756/vibe-coding-guide/blob/main/README.md"
}
},
{
"name": "README_EN.md",
"path": "README_EN.md",
"sha": "481b593998c437852376706e7317cfcb5186e7f6",
"size": 20502,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/README_EN.md?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/blob/main/README_EN.md",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/481b593998c437852376706e7317cfcb5186e7f6",
"download_url": "https://raw.githubusercontent.com/wendy7756/vibe-coding-guide/main/README_EN.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/README_EN.md?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/blobs/481b593998c437852376706e7317cfcb5186e7f6",
"html": "https://github.com/wendy7756/vibe-coding-guide/blob/main/README_EN.md"
}
},
{
"name": "my-experience",
"path": "my-experience",
"sha": "573c4e979b85943d405daadb6721054b2d78d817",
"size": 0,
"url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/my-experience?ref=main",
"html_url": "https://github.com/wendy7756/vibe-coding-guide/tree/main/my-experience",
"git_url": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/573c4e979b85943d405daadb6721054b2d78d817",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/wendy7756/vibe-coding-guide/contents/my-experience?ref=main",
"git": "https://api.github.com/repos/wendy7756/vibe-coding-guide/git/trees/573c4e979b85943d405daadb6721054b2d78d817",
"html": "https://github.com/wendy7756/vibe-coding-guide/tree/main/my-experience"
}
}
]
docs/research/wendy7756-vibe-coding-guide/raw/sources.yml
+38
View File
@@ -0,0 +1,38 @@
version: 1
domain_id: wendy7756-vibe-coding-guide
object:
type: github_repository
name: wendy7756/vibe-coding-guide
url: https://github.com/wendy7756/vibe-coding-guide
pulled_at: '2026-07-02T22:47:14+00:00'
puller: scripts/fetch-research-raw.py
files:
- path: repository/
kind: git-working-tree
status: ok
source: 'git clone --depth=1 --single-branch --no-tags https://github.com/wendy7756/vibe-coding-guide.git docs/research/wendy7756-vibe-coding-guide/raw/repository'
- path: github-repo.raw.json
kind: repository-metadata
status: ok
source: 'gh repo view wendy7756/vibe-coding-guide --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
- path: github-readme.raw.md.txt
kind: readme
status: ok
source: 'gh api repos/wendy7756/vibe-coding-guide/readme -H Accept: application/vnd.github.raw'
- path: github-license.raw.txt
kind: license
status: ok
source: 'gh api repos/wendy7756/vibe-coding-guide/license -H Accept: application/vnd.github.raw'
- path: github-root-contents.raw.json
kind: root-contents
status: ok
source: 'gh api repos/wendy7756/vibe-coding-guide/contents'
- path: github-languages.raw.json
kind: languages
status: ok
source: 'gh api repos/wendy7756/vibe-coding-guide/languages'
- path: github-latest-release.raw.json
kind: latest-release
status: missing_or_error
source: 'gh api repos/wendy7756/vibe-coding-guide/releases/latest'
message: 'gh: Not Found (HTTP 404)'