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

docs: harden ai citation and external governance

Browse Source
This commit is contained in:
tukuaiai
2026-05-04 01:25:22 +08:00
parent f4889accd7
commit 5c7a3c2d71
17 changed files with 299 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+6 -6
View File
@@ -6,7 +6,7 @@
| 目录 | 定位 | 首选入口 |
|:---|:---|:---|
| [getting-started](./getting-started/) | 从零开始的线性入门教程 | [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验) / [学习地图](./getting-started/README.md#1-学习地图) |
| [getting-started](./getting-started/) | 从零开始的线性入门教程 | [Vibe Coding 经验](./getting-started/README.md#vibe-coding-experience) / [学习地图](./getting-started/README.md#learning-map) |
| [concepts](./concepts/) | 核心概念、问题求解与工程思想 | [核心概念索引](./concepts/README.md) |
| [philosophy](./philosophy/) | 哲学方法论、思维模型与底层认知模型 | [哲学方法论工具箱](philosophy/README.md#philosophy-methodology-toolbox-怎么选) |
| [references](./references/) | 工程实践、技术栈、模板和检查清单 | [参考资料索引](./references/README.md#目录定位) |
@@ -16,8 +16,8 @@
### 新手路径
1. [从零开始完整入门](./getting-started/README.md#1-学习地图)
2. [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验)
1. [从零开始完整入门](./getting-started/README.md#learning-map)
2. [Vibe Coding 经验](./getting-started/README.md#vibe-coding-experience)
3. [问题求解](concepts/README.md#concept-problem-solving)
4. [拼好码](concepts/README.md#concept-glue-coding)
5. [工程实践](references/README.md#reference-engineering-practice)
@@ -40,8 +40,8 @@
1. [根目录 AGENTS](../AGENTS.md)
2. [docs 目录 AGENTS](./AGENTS.md)
3. [从零开始完整入门](./getting-started/README.md#1-学习地图)
4. [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验)
3. [从零开始完整入门](./getting-started/README.md#learning-map)
4. [Vibe Coding 经验](./getting-started/README.md#vibe-coding-experience)
5. [工程实践](references/README.md#reference-engineering-practice)
6. [AI 引用语料](../assets/ai-citation/README.md)
@@ -53,7 +53,7 @@
### getting-started
- [README](./getting-started/README.md#顶部导航) - 从零开始完整入门，包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建。
- [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验) - 通用语言能力、人机分工、机器门禁和入门铁律。
- [Vibe Coding 经验](./getting-started/README.md#vibe-coding-experience) - 通用语言能力、人机分工、机器门禁和入门铁律。
- [AGENTS](./getting-started/AGENTS.md) - 入门教程目录操作规则。
### concepts
docs/getting-started/README.md
+31 -23
View File
@@ -14,11 +14,11 @@
|:---|:---|
| [使用方式](#使用方式) | 不会操作时如何让网页 AI 生成逐步执行方案 |
| [最短路径：先跑通 Codex CLI](#最短路径先跑通-codex-cli) | 为什么先配置 AI CLI，而不是先手工配置完整开发环境 |
| [Vibe Coding 经验](#1-vibe-coding-经验) | 人机分工、门禁、复盘和 AI 审 AI |
| [学习地图](#1-学习地图) | 根据新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 选择路线 |
| [网络环境配置](#3-网络环境配置) | OpenAI、GitHub、文档和依赖源访问 |
| [CLI 配置](#4-cli-配置) | Codex CLI 默认路线与 OpenCode 备选路线 |
| [开发环境搭建](#5-开发环境搭建) | 让 Agent 主动配置开发依赖、编辑器建议和测试命令 |
| [Vibe Coding 经验](#vibe-coding-experience) | 人机分工、门禁、复盘和 AI 审 AI |
| [学习地图](#learning-map) | 根据新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 选择路线 |
| [网络环境配置](#network-environment) | OpenAI、GitHub、文档和依赖源访问 |
| [CLI 配置](#cli-setup) | Codex CLI 默认路线与 OpenCode 备选路线 |
| [开发环境搭建](#development-environment) | 让 Agent 主动配置开发依赖、编辑器建议和测试命令 |
## 使用方式
@@ -40,17 +40,18 @@
### 细粒度目录
- [1. Vibe Coding 经验](#1-vibe-coding-经验)
- [2. 学习地图](#1-学习地图)
- [3. 网络环境配置](#3-网络环境配置)
- [4. CLI 配置](#4-cli-配置)
- [5. 开发环境搭建](#5-开发环境搭建)
- [1. Vibe Coding 经验](#vibe-coding-experience)
- [2. 学习地图](#learning-map)
- [3. 网络环境配置](#network-environment)
- [4. CLI 配置](#cli-setup)
- [5. 开发环境搭建](#development-environment)
</details>
<details>
<summary><strong>1. Vibe Coding 经验</strong> - 通用语言能力、人机分工、机器门禁和入门铁律。（点击展开/收起）</summary>
<a id="vibe-coding-experience"></a>
<a id="2-vibe-coding-经验"></a>
## 1. Vibe Coding 经验
@@ -148,13 +149,14 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
### 下一步
→ [CLI 配置](#4-cli-配置) - 默认 AI CLI 路线，文末包含 OpenCode 备选方案
→ [CLI 配置](#cli-setup) - 默认 AI CLI 路线，文末包含 OpenCode 备选方案
</details>
<details>
<summary><strong>2. 学习地图</strong> - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。（点击展开/收起）</summary>
<a id="learning-map"></a>
<a id="1-学习地图"></a>
## 2. 学习地图
@@ -173,7 +175,7 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
| 路线 | 适合谁 | 目标 | 首选入口 |
|:---|:---|:---|:---|
| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解](../concepts/README.md#concept-problem-solving) |
| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](#1-vibe-coding-经验) |
| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](#vibe-coding-experience) |
| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) |
| Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) |
| 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [工程实践](../references/README.md#reference-engineering-practice) |
@@ -185,13 +187,13 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
1. [问题求解](../concepts/README.md#concept-problem-solving)
先学会把问题说清楚：目标、现状、差距、标准、约束、对象、路径。
2. [网络环境配置](#3-网络环境配置)
2. [网络环境配置](#network-environment)
先解决访问 OpenAI、GitHub、文档和依赖源的问题。
3. [CLI 配置](#4-cli-配置)
3. [CLI 配置](#cli-setup)
配置并登录 Codex CLI，让本地 Agent 能在终端里执行工程动作。
4. [开发环境搭建](#5-开发环境搭建)
4. [开发环境搭建](#development-environment)
优先交给 Codex Agent 主动检查和配置 Git、Node.js、Python、编辑器、项目依赖与测试命令。
5. [Vibe Coding 经验](#1-vibe-coding-经验)
5. [Vibe Coding 经验](#vibe-coding-experience)
学会人机分工、门禁、复盘和用 AI 审 AI。
完成标准：
@@ -206,7 +208,7 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
目标：把 AI 从“临时助手”变成稳定的工程协作者。
1. [Vibe Coding 经验](#1-vibe-coding-经验)
1. [Vibe Coding 经验](#vibe-coding-experience)
先建立人机分工和质量意识。
2. [拼好码](../concepts/README.md#concept-glue-coding)
优先复用成熟能力，把自研代码限制在连接、编排、适配和业务逻辑。
@@ -302,8 +304,8 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
### 下一步
- 新手：回到 [学习地图](#1-学习地图)，从第 0 步开始。
- 开发者：阅读 [Vibe Coding 经验](#1-vibe-coding-经验)，再选择 Skill 或质量门禁路线。
- 新手：回到 [学习地图](#learning-map)，从第 0 步开始。
- 开发者：阅读 [Vibe Coding 经验](#vibe-coding-experience)，再选择 Skill 或质量门禁路线。
- 团队：先统一 [AGENTS.md](../../../../AGENTS.md)、强前置条件和质量门禁。
</details>
@@ -311,6 +313,8 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
<details>
<summary><strong>3. 网络环境配置</strong> - OpenAI、GitHub、文档和依赖源访问。（点击展开/收起）</summary>
<a id="network-environment"></a>
## 3. 网络环境配置
> Vibe Coding 的前置条件：确保能正常访问 GitHub、Google、Claude 等服务。
@@ -446,13 +450,15 @@ export http_proxy=http://127.0.0.1:7890
### 下一步
网络配置完成后，继续阅读 [开发环境搭建](#5-开发环境搭建)。
网络配置完成后，继续阅读 [开发环境搭建](#development-environment)。
</details>
<details>
<summary><strong>4. CLI 配置</strong> - Codex CLI 默认路线与 OpenCode 备选路线。（点击展开/收起）</summary>
<a id="cli-setup"></a>
## 4. CLI 配置
> 默认 AI CLI 路线：假设你拿到的是一台全新电脑，从 0 安装系统依赖、Node.js、Codex CLI，然后用浏览器完成 Codex 登录。
@@ -935,18 +941,20 @@ opencode
### 下一步
→ [开发环境搭建](#5-开发环境搭建) - 回看基础环境
→ [开发环境搭建](#development-environment) - 回看基础环境
</details>
<details>
<summary><strong>5. 开发环境搭建</strong> - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。（点击展开/收起）</summary>
<a id="development-environment"></a>
## 5. 开发环境搭建
> 使用方法：Codex CLI 已跑通时，优先让 Codex Agent 读取本节并主动配置剩余环境；Codex CLI 不可用时，再复制下方对应你设备的提示词，粘贴到任意 AI 对话框（ChatGPT、Claude、Gemini 网页版等），让网页 AI 一步步指导你完成配置。
**前置条件**：请先完成 [网络环境配置](#3-网络环境配置)。推荐先完成 [CLI 配置](#4-cli-配置)，让 Codex Agent 接管后续开发环境搭建。
**前置条件**：请先完成 [网络环境配置](#network-environment)。推荐先完成 [CLI 配置](#cli-setup)，让 Codex Agent 接管后续开发环境搭建。
---
@@ -1198,6 +1206,6 @@ alias oc='opencode'
环境搭建完成后，继续下一步：
→ [CLI 配置](#4-cli-配置) - 配置默认 AI CLI
→ [CLI 配置](#cli-setup) - 配置默认 AI CLI
</details>
docs/references/README.md
+1 -1
View File
@@ -2842,7 +2842,7 @@ nvm use 18
| 问题 | 原因 | 解决方案 |
|:---|:---|:---|
| GitHub 访问慢/超时 | 网络限制 | 配置代理，参考 [网络环境配置](../getting-started/README.md#3-网络环境配置) |
| GitHub 访问慢/超时 | 网络限制 | 配置代理，参考 [网络环境配置](../getting-started/README.md#network-environment) |
| API 调用失败 | 网络/Key 问题 | 检查代理、API Key 是否有效 |
| 终端不走代理 | 代理配置不全 | 设置环境变量（见下方） |
| SSL 证书错误 | 代理/时间问题 | 检查系统时间，或临时关闭 SSL 验证 |