mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-22 23:38:05 +00:00
docs: rename knowledge base documents
This commit is contained in:
@@ -211,7 +211,7 @@ git push origin develop
|
|||||||
- `scripts/check-local-links.py` - 仓库内 Markdown 相对链接检查脚本,供 `make check-links` 与 CI 使用
|
- `scripts/check-local-links.py` - 仓库内 Markdown 相对链接检查脚本,供 `make check-links` 与 CI 使用
|
||||||
- `tools/prompts-library/main.py` - 提示词转换工具入口
|
- `tools/prompts-library/main.py` - 提示词转换工具入口
|
||||||
- `docs/getting-started/README.md` - 从零开始完整入门,包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建
|
- `docs/getting-started/README.md` - 从零开始完整入门,包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建
|
||||||
- `docs/concepts/问题求解能力.md` - 问题定义与求解路径底层模型
|
- `docs/concepts/问题求解.md` - 问题定义与求解路径底层模型
|
||||||
- `docs/references/工程实践.md` - 项目架构、代码组织、开发经验、底层程序逻辑、AI 编程质量门禁与常见坑的统一入口
|
- `docs/references/工程实践.md` - 项目架构、代码组织、开发经验、底层程序逻辑、AI 编程质量门禁与常见坑的统一入口
|
||||||
- `docs/references/技术栈.md` - 常见软件系统技术栈、选型维度、组合案例与初学者学习路径
|
- `docs/references/技术栈.md` - 常见软件系统技术栈、选型维度、组合案例与初学者学习路径
|
||||||
- `skills/auto-skill/` - Skills 生成、重构与校验的元技能
|
- `skills/auto-skill/` - Skills 生成、重构与校验的元技能
|
||||||
|
|||||||
@@ -30,7 +30,7 @@
|
|||||||
<!-- 🔴 核心理念 (红色系) -->
|
<!-- 🔴 核心理念 (红色系) -->
|
||||||
<p>
|
<p>
|
||||||
<a href="./docs/getting-started/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-完整入门-red?style=for-the-badge" alt="从零开始完整入门"></a>
|
<a href="./docs/getting-started/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-完整入门-red?style=for-the-badge" alt="从零开始完整入门"></a>
|
||||||
<a href="./docs/concepts/问题求解能力.md"><img src="https://img.shields.io/badge/🧩_问题求解-必读-purple?style=for-the-badge" alt="问题求解能力"></a>
|
<a href="./docs/concepts/问题求解.md"><img src="https://img.shields.io/badge/🧩_问题求解-必读-purple?style=for-the-badge" alt="问题求解"></a>
|
||||||
<a href="./docs/philosophy/思维模型.md"><img src="https://img.shields.io/badge/🧭_思维模型-认知工具-purple?style=for-the-badge" alt="思维模型"></a>
|
<a href="./docs/philosophy/思维模型.md"><img src="https://img.shields.io/badge/🧭_思维模型-认知工具-purple?style=for-the-badge" alt="思维模型"></a>
|
||||||
<a href="./docs/philosophy/README.md"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
|
<a href="./docs/philosophy/README.md"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
|
||||||
<a href="./docs/references/工程实践.md"><img src="https://img.shields.io/badge/🛡️_工程实践-质量门禁-darkred?style=for-the-badge" alt="工程实践"></a>
|
<a href="./docs/references/工程实践.md"><img src="https://img.shields.io/badge/🛡️_工程实践-质量门禁-darkred?style=for-the-badge" alt="工程实践"></a>
|
||||||
@@ -172,7 +172,7 @@
|
|||||||
完全新手?按顺序完成以下步骤:
|
完全新手?按顺序完成以下步骤:
|
||||||
|
|
||||||
0. [从零开始完整入门](docs/getting-started/README.md) - 按目标选择新手、开发者、团队、Prompt、Skill、质量门禁或 GEO/SEO 路线
|
0. [从零开始完整入门](docs/getting-started/README.md) - 按目标选择新手、开发者、团队、Prompt、Skill、质量门禁或 GEO/SEO 路线
|
||||||
1. [问题求解能力](docs/concepts/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
|
1. [问题求解](docs/concepts/问题求解.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
|
||||||
2. [拼好码](docs/concepts/拼好码.md) - 优先复用成熟能力,用胶水代码连接、编排、适配业务流程
|
2. [拼好码](docs/concepts/拼好码.md) - 优先复用成熟能力,用胶水代码连接、编排、适配业务流程
|
||||||
3. [工程实践](docs/references/工程实践.md) - 用项目架构、代码组织、开发经验和硬门禁约束 AI 输出
|
3. [工程实践](docs/references/工程实践.md) - 用项目架构、代码组织、开发经验和硬门禁约束 AI 输出
|
||||||
|
|
||||||
@@ -245,7 +245,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
|
|||||||
|
|
||||||
> 一句话:用“生成器/优化器”的递归闭环,构建一个能持续自我优化的 AI 系统。
|
> 一句话:用“生成器/优化器”的递归闭环,构建一个能持续自我优化的 AI 系统。
|
||||||
>
|
>
|
||||||
> 延伸阅读:[递归自优化生成系统形式化](docs/concepts/递归自优化生成系统形式化.md)
|
> 延伸阅读:[递归自优化系统](docs/concepts/递归自优化系统.md)
|
||||||
|
|
||||||
### 核心角色
|
### 核心角色
|
||||||
- **α-提示词(生成器)**:一个“母体”提示词,其唯一职责是生成其他提示词或技能。
|
- **α-提示词(生成器)**:一个“母体”提示词,其唯一职责是生成其他提示词或技能。
|
||||||
|
|||||||
@@ -23,7 +23,7 @@
|
|||||||
新手优先看:
|
新手优先看:
|
||||||
|
|
||||||
1. `docs/getting-started/README.md`
|
1. `docs/getting-started/README.md`
|
||||||
2. `docs/concepts/问题求解能力.md`
|
2. `docs/concepts/问题求解.md`
|
||||||
3. `docs/concepts/拼好码.md`
|
3. `docs/concepts/拼好码.md`
|
||||||
4. `docs/references/工程实践.md`
|
4. `docs/references/工程实践.md`
|
||||||
|
|
||||||
|
|||||||
@@ -42,7 +42,7 @@ GEOFlow 的关键启发是:GEO 不是关键词堆砌,而是内容工程链
|
|||||||
|
|
||||||
- README.md:项目主入口,说明定位、快速开始、工具资源和核心工作流。
|
- README.md:项目主入口,说明定位、快速开始、工具资源和核心工作流。
|
||||||
- docs/getting-started/README.md:从零开始完整入门,包含学习地图、Vibe Coding 经验、网络环境、CLI 配置与开发环境搭建。
|
- docs/getting-started/README.md:从零开始完整入门,包含学习地图、Vibe Coding 经验、网络环境、CLI 配置与开发环境搭建。
|
||||||
- docs/concepts/问题求解能力.md:问题定义、目标、约束、对象、路径。
|
- docs/concepts/问题求解.md:问题定义、目标、约束、对象、路径。
|
||||||
- docs/concepts/拼好码.md:胶水原则的扩展,把复用成熟能力作为工程交付默认路径。
|
- docs/concepts/拼好码.md:胶水原则的扩展,把复用成熟能力作为工程交付默认路径。
|
||||||
- docs/philosophy/组合描述模型.md:用对象、状态、快照、序列、过程、变换、同一/差异与关系描述复杂系统。
|
- docs/philosophy/组合描述模型.md:用对象、状态、快照、序列、过程、变换、同一/差异与关系描述复杂系统。
|
||||||
- docs/references/技术栈.md:常见软件系统技术栈、选型维度、组合案例与初学者学习路径。
|
- docs/references/技术栈.md:常见软件系统技术栈、选型维度、组合案例与初学者学习路径。
|
||||||
|
|||||||
@@ -21,11 +21,18 @@ docs/
|
|||||||
- `README.md`:知识库总索引。
|
- `README.md`:知识库总索引。
|
||||||
- `getting-started/README.md`:从零开始完整入门,包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建。
|
- `getting-started/README.md`:从零开始完整入门,包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建。
|
||||||
- `concepts/拼好码.md`:复用优先、能力编排、边界治理与工程门禁。
|
- `concepts/拼好码.md`:复用优先、能力编排、边界治理与工程门禁。
|
||||||
|
- `concepts/问题求解.md`:目标、现状、差距、标准与反馈迭代的底层能力。
|
||||||
|
- `concepts/系统构建方法.md`:自顶向下、自底向上与分而治之的组合方法。
|
||||||
|
- `concepts/开发范式演进.md`:软件工程组织方式的历史演进。
|
||||||
|
- `concepts/递归自优化系统.md`:递归自优化生成系统的形式化模型。
|
||||||
- `philosophy/README.md`:哲学方法论工具箱入口。
|
- `philosophy/README.md`:哲学方法论工具箱入口。
|
||||||
- `philosophy/思维模型.md`:可复用认知工具入口。
|
- `philosophy/思维模型.md`:可复用认知工具入口。
|
||||||
- `philosophy/组合描述模型.md`:对象、状态、快照、序列、过程、变换、同一/差异与关系的组合描述模型。
|
- `philosophy/组合描述模型.md`:对象、状态、快照、序列、过程、变换、同一/差异与关系的组合描述模型。
|
||||||
- `philosophy/编程之道.md`:编程哲学与工程判断入口。
|
- `philosophy/编程之道.md`:编程哲学与工程判断入口。
|
||||||
- `research/README.md`:新技术、技术栈、优秀 repo、工程范式和工具趋势研究入口。
|
- `research/README.md`:新技术、技术栈、优秀 repo、工程范式和工具趋势研究入口。
|
||||||
|
- `research/Harness工程解析.md`:Harness Engineering 的工程控制、评估器与反馈闭环解析。
|
||||||
|
- `references/工程实践.md`:项目架构、代码组织、开发经验、质量门禁与常见坑的统一入口。
|
||||||
|
- `references/技术栈.md`:技术栈选型、组合案例与初学者学习路径。
|
||||||
|
|
||||||
## 操作规范
|
## 操作规范
|
||||||
|
|
||||||
|
|||||||
+1
-1
@@ -15,7 +15,7 @@
|
|||||||
## 推荐入口
|
## 推荐入口
|
||||||
|
|
||||||
1. [从零开始完整入门](./getting-started/README.md)
|
1. [从零开始完整入门](./getting-started/README.md)
|
||||||
2. [问题求解能力](./concepts/问题求解能力.md)
|
2. [问题求解](./concepts/问题求解.md)
|
||||||
3. [思维模型](./philosophy/思维模型.md)
|
3. [思维模型](./philosophy/思维模型.md)
|
||||||
4. [组合描述模型](./philosophy/组合描述模型.md)
|
4. [组合描述模型](./philosophy/组合描述模型.md)
|
||||||
5. [拼好码](./concepts/拼好码.md)
|
5. [拼好码](./concepts/拼好码.md)
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# 软件开发范式演进
|
# 开发范式演进
|
||||||
|
|
||||||
软件开发范式的演进可以概括为一组随工程复杂度提升而逐步形成的设计思想与组织方式,而非严格的历史线性阶段或全球统一的标准分期。
|
软件开发范式的演进可以概括为一组随工程复杂度提升而逐步形成的设计思想与组织方式,而非严格的历史线性阶段或全球统一的标准分期。
|
||||||
|
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
# 问题分析与系统构建方法
|
# 系统构建方法
|
||||||
|
|
||||||
软件工程中的自顶向下、自底向上和分而治之,是三种经典的问题分析与系统构建方法。
|
软件工程中的自顶向下、自底向上和分而治之,是三种经典的问题分析与系统构建方法。
|
||||||
|
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
# 递归自优化生成系统形式化
|
# 递归自优化系统
|
||||||
|
|
||||||
**tukuai**
|
**tukuai**
|
||||||
独立研究者
|
独立研究者
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
# 问题求解能力
|
# 问题求解
|
||||||
|
|
||||||
## 不会操作?先让网页 AI 生成逐步执行版
|
## 不会操作?先让网页 AI 生成逐步执行版
|
||||||
|
|
||||||
@@ -40,7 +40,7 @@
|
|||||||
|
|
||||||
| 路线 | 适合谁 | 目标 | 首选入口 |
|
| 路线 | 适合谁 | 目标 | 首选入口 |
|
||||||
|:---|:---|:---|:---|
|
|:---|:---|:---|:---|
|
||||||
| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../concepts/问题求解能力.md) |
|
| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解](../concepts/问题求解.md) |
|
||||||
| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](README.md) |
|
| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](README.md) |
|
||||||
| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) |
|
| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) |
|
||||||
| Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) |
|
| Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) |
|
||||||
@@ -51,7 +51,7 @@
|
|||||||
|
|
||||||
目标:完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。
|
目标:完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。
|
||||||
|
|
||||||
1. [问题求解能力](../concepts/问题求解能力.md)
|
1. [问题求解](../concepts/问题求解.md)
|
||||||
先学会把问题说清楚:目标、现状、差距、标准、约束、对象、路径。
|
先学会把问题说清楚:目标、现状、差距、标准、约束、对象、路径。
|
||||||
2. [网络环境配置](README.md)
|
2. [网络环境配置](README.md)
|
||||||
先解决访问 OpenAI、GitHub、文档和依赖源的问题。
|
先解决访问 OpenAI、GitHub、文档和依赖源的问题。
|
||||||
@@ -95,7 +95,7 @@
|
|||||||
1. [提示词库入口](../../../prompts/README.md)
|
1. [提示词库入口](../../../prompts/README.md)
|
||||||
2. [工程实践](../references/工程实践.md)
|
2. [工程实践](../references/工程实践.md)
|
||||||
3. [语言层要素](../concepts/语言层要素.md)
|
3. [语言层要素](../concepts/语言层要素.md)
|
||||||
4. [问题求解能力](../concepts/问题求解能力.md)
|
4. [问题求解](../concepts/问题求解.md)
|
||||||
|
|
||||||
练习方式:
|
练习方式:
|
||||||
|
|
||||||
@@ -156,7 +156,7 @@
|
|||||||
如果你不知道从哪里开始,按这个顺序:
|
如果你不知道从哪里开始,按这个顺序:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
问题求解能力
|
问题求解
|
||||||
-> 网络环境配置
|
-> 网络环境配置
|
||||||
-> Codex / ChatGPT 订阅与登录准备
|
-> Codex / ChatGPT 订阅与登录准备
|
||||||
-> Codex CLI 配置
|
-> Codex CLI 配置
|
||||||
|
|||||||
@@ -9,13 +9,13 @@
|
|||||||
- [语言层要素](../concepts/语言层要素.md) - 看懂 100% 代码的 8 个层级
|
- [语言层要素](../concepts/语言层要素.md) - 看懂 100% 代码的 8 个层级
|
||||||
|
|
||||||
### 理论基础
|
### 理论基础
|
||||||
- [递归自优化生成系统形式化](../concepts/递归自优化生成系统形式化.md) - 元方法论
|
- [递归自优化系统](../concepts/递归自优化系统.md) - 元方法论
|
||||||
- [编程之道](../philosophy/编程之道.md) - 编程哲学
|
- [编程之道](../philosophy/编程之道.md) - 编程哲学
|
||||||
|
|
||||||
### 软件工程基础
|
### 软件工程基础
|
||||||
- [问题求解能力](../concepts/问题求解能力.md) - 目标、现状、差距、标准与反馈迭代的底层能力
|
- [问题求解](../concepts/问题求解.md) - 目标、现状、差距、标准与反馈迭代的底层能力
|
||||||
- [问题分析与系统构建方法](../concepts/问题分析与系统构建方法.md) - 自顶向下、自底向上与分而治之的组合使用
|
- [系统构建方法](../concepts/系统构建方法.md) - 自顶向下、自底向上与分而治之的组合使用
|
||||||
- [软件开发范式演进](../concepts/软件开发范式演进.md) - 从面向过程到云原生的工程组织方式演进
|
- [开发范式演进](../concepts/开发范式演进.md) - 从面向过程到云原生的工程组织方式演进
|
||||||
|
|
||||||
### 工程实践
|
### 工程实践
|
||||||
- [工程实践](工程实践.md) - 项目架构、代码组织、开发经验、底层程序逻辑、AI 编程质量门禁与常见坑的统一入口
|
- [工程实践](工程实践.md) - 项目架构、代码组织、开发经验、底层程序逻辑、AI 编程质量门禁与常见坑的统一入口
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Harness Engineering 的本质拆解
|
# Harness 工程解析
|
||||||
|
|
||||||
1. Harness Engineering 的本质是用确定性的工程控制系统,把大模型的非确定性输出压缩进可预测的轨道里,让“概率生成”变成“可验收的产出”
|
1. Harness Engineering 的本质是用确定性的工程控制系统,把大模型的非确定性输出压缩进可预测的轨道里,让“概率生成”变成“可验收的产出”
|
||||||
|
|
||||||
@@ -11,4 +11,4 @@
|
|||||||
|
|
||||||
## 文档列表
|
## 文档列表
|
||||||
|
|
||||||
- [Harness Engineering 的本质拆解](Harness%20Engineering%20的本质拆解.md) - 用工程控制、评估器、反馈闭环和约束机制提升 AI 生成系统可靠性的技术解析。
|
- [Harness 工程解析](Harness工程解析.md) - 用工程控制、评估器、反馈闭环和约束机制提升 AI 生成系统可靠性的技术解析。
|
||||||
|
|||||||
@@ -21,7 +21,7 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程,帮
|
|||||||
首选入口:
|
首选入口:
|
||||||
- README.md
|
- README.md
|
||||||
- docs/getting-started/README.md
|
- docs/getting-started/README.md
|
||||||
- docs/concepts/问题求解能力.md
|
- docs/concepts/问题求解.md
|
||||||
- docs/concepts/拼好码.md
|
- docs/concepts/拼好码.md
|
||||||
- docs/philosophy/组合描述模型.md
|
- docs/philosophy/组合描述模型.md
|
||||||
- docs/references/工程实践.md
|
- docs/references/工程实践.md
|
||||||
|
|||||||
+12
-2
@@ -12,9 +12,19 @@ redirects:
|
|||||||
- from: docs/concepts/编程之道.md
|
- from: docs/concepts/编程之道.md
|
||||||
to: docs/philosophy/编程之道.md
|
to: docs/philosophy/编程之道.md
|
||||||
- from: docs/concepts/A Formalization of Recursive Self-Optimizing Generative Systems.md
|
- from: docs/concepts/A Formalization of Recursive Self-Optimizing Generative Systems.md
|
||||||
to: docs/concepts/递归自优化生成系统形式化.md
|
to: docs/concepts/递归自优化系统.md
|
||||||
|
- from: docs/concepts/软件开发范式演进.md
|
||||||
|
to: docs/concepts/开发范式演进.md
|
||||||
|
- from: docs/concepts/递归自优化生成系统形式化.md
|
||||||
|
to: docs/concepts/递归自优化系统.md
|
||||||
|
- from: docs/concepts/问题分析与系统构建方法.md
|
||||||
|
to: docs/concepts/系统构建方法.md
|
||||||
|
- from: docs/concepts/问题求解能力.md
|
||||||
|
to: docs/concepts/问题求解.md
|
||||||
- from: docs/concepts/Harness Engineering 的本质拆解.md
|
- from: docs/concepts/Harness Engineering 的本质拆解.md
|
||||||
to: docs/research/Harness Engineering 的本质拆解.md
|
to: docs/research/Harness工程解析.md
|
||||||
|
- from: docs/research/Harness Engineering 的本质拆解.md
|
||||||
|
to: docs/research/Harness工程解析.md
|
||||||
- from: docs/philosophy/现象学还原.md
|
- from: docs/philosophy/现象学还原.md
|
||||||
to: docs/philosophy/README.md
|
to: docs/philosophy/README.md
|
||||||
- from: docs/philosophy/辩证法.md
|
- from: docs/philosophy/辩证法.md
|
||||||
|
|||||||
Reference in New Issue
Block a user