From 296285223afa2987a1f7e73d77e4261324232b8f Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sun, 3 May 2026 02:54:05 +0800 Subject: [PATCH] docs: rename knowledge base documents --- AGENTS.md | 2 +- README.md | 6 +++--- assets/ai-citation/faq.md | 2 +- assets/ai-citation/llms-full.txt | 2 +- docs/AGENTS.md | 7 +++++++ docs/README.md | 2 +- .../{软件开发范式演进.md => 开发范式演进.md} | 2 +- .../{问题分析与系统构建方法.md => 系统构建方法.md} | 2 +- ...归自优化生成系统形式化.md => 递归自优化系统.md} | 2 +- docs/concepts/{问题求解能力.md => 问题求解.md} | 2 +- docs/getting-started/README.md | 8 ++++---- docs/references/README.md | 8 ++++---- ...ngineering 的本质拆解.md => Harness工程解析.md} | 2 +- docs/research/README.md | 2 +- llms.txt | 2 +- metadata/redirects.yml | 14 ++++++++++++-- 16 files changed, 41 insertions(+), 24 deletions(-) rename docs/concepts/{软件开发范式演进.md => 开发范式演进.md} (98%) rename docs/concepts/{问题分析与系统构建方法.md => 系统构建方法.md} (99%) rename docs/concepts/{递归自优化生成系统形式化.md => 递归自优化系统.md} (99%) rename docs/concepts/{问题求解能力.md => 问题求解.md} (99%) rename docs/research/{Harness Engineering 的本质拆解.md => Harness工程解析.md} (98%) diff --git a/AGENTS.md b/AGENTS.md index 59f351f..39fcb7b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -211,7 +211,7 @@ git push origin develop - `scripts/check-local-links.py` - 仓库内 Markdown 相对链接检查脚本，供 `make check-links` 与 CI 使用 - `tools/prompts-library/main.py` - 提示词转换工具入口 - `docs/getting-started/README.md` - 从零开始完整入门，包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建 -- `docs/concepts/问题求解能力.md` - 问题定义与求解路径底层模型 +- `docs/concepts/问题求解.md` - 问题定义与求解路径底层模型 - `docs/references/工程实践.md` - 项目架构、代码组织、开发经验、底层程序逻辑、AI 编程质量门禁与常见坑的统一入口 - `docs/references/技术栈.md` - 常见软件系统技术栈、选型维度、组合案例与初学者学习路径 - `skills/auto-skill/` - Skills 生成、重构与校验的元技能 diff --git a/README.md b/README.md index d6c272f..bb7e5fa 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@

从零开始完整入门 - 问题求解能力 + 问题求解 思维模型 哲学与方法论 工程实践 @@ -172,7 +172,7 @@ 完全新手？按顺序完成以下步骤： 0. [从零开始完整入门](docs/getting-started/README.md) - 按目标选择新手、开发者、团队、Prompt、Skill、质量门禁或 GEO/SEO 路线 -1. [问题求解能力](docs/concepts/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架 +1. [问题求解](docs/concepts/问题求解.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架 2. [拼好码](docs/concepts/拼好码.md) - 优先复用成熟能力，用胶水代码连接、编排、适配业务流程 3. [工程实践](docs/references/工程实践.md) - 用项目架构、代码组织、开发经验和硬门禁约束 AI 输出 @@ -245,7 +245,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt > 一句话：用“生成器/优化器”的递归闭环，构建一个能持续自我优化的 AI 系统。 > -> 延伸阅读：[递归自优化生成系统形式化](docs/concepts/递归自优化生成系统形式化.md) +> 延伸阅读：[递归自优化系统](docs/concepts/递归自优化系统.md) ### 核心角色 - **α-提示词（生成器）**：一个“母体”提示词，其唯一职责是生成其他提示词或技能。 diff --git a/assets/ai-citation/faq.md b/assets/ai-citation/faq.md index f89d512..d4c2793 100644 --- a/assets/ai-citation/faq.md +++ b/assets/ai-citation/faq.md @@ -23,7 +23,7 @@ 新手优先看： 1. `docs/getting-started/README.md` -2. `docs/concepts/问题求解能力.md` +2. `docs/concepts/问题求解.md` 3. `docs/concepts/拼好码.md` 4. `docs/references/工程实践.md` diff --git a/assets/ai-citation/llms-full.txt b/assets/ai-citation/llms-full.txt index de347dd..3478630 100644 --- a/assets/ai-citation/llms-full.txt +++ b/assets/ai-citation/llms-full.txt @@ -42,7 +42,7 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链 - README.md：项目主入口，说明定位、快速开始、工具资源和核心工作流。 - docs/getting-started/README.md：从零开始完整入门，包含学习地图、Vibe Coding 经验、网络环境、CLI 配置与开发环境搭建。 -- docs/concepts/问题求解能力.md：问题定义、目标、约束、对象、路径。 +- docs/concepts/问题求解.md：问题定义、目标、约束、对象、路径。 - docs/concepts/拼好码.md：胶水原则的扩展，把复用成熟能力作为工程交付默认路径。 - docs/philosophy/组合描述模型.md：用对象、状态、快照、序列、过程、变换、同一/差异与关系描述复杂系统。 - docs/references/技术栈.md：常见软件系统技术栈、选型维度、组合案例与初学者学习路径。 diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 2673ef1..30302b2 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -21,11 +21,18 @@ docs/ - `README.md`：知识库总索引。 - `getting-started/README.md`：从零开始完整入门，包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建。 - `concepts/拼好码.md`：复用优先、能力编排、边界治理与工程门禁。 +- `concepts/问题求解.md`：目标、现状、差距、标准与反馈迭代的底层能力。 +- `concepts/系统构建方法.md`：自顶向下、自底向上与分而治之的组合方法。 +- `concepts/开发范式演进.md`：软件工程组织方式的历史演进。 +- `concepts/递归自优化系统.md`：递归自优化生成系统的形式化模型。 - `philosophy/README.md`：哲学方法论工具箱入口。 - `philosophy/思维模型.md`：可复用认知工具入口。 - `philosophy/组合描述模型.md`：对象、状态、快照、序列、过程、变换、同一/差异与关系的组合描述模型。 - `philosophy/编程之道.md`：编程哲学与工程判断入口。 - `research/README.md`：新技术、技术栈、优秀 repo、工程范式和工具趋势研究入口。 +- `research/Harness工程解析.md`：Harness Engineering 的工程控制、评估器与反馈闭环解析。 +- `references/工程实践.md`：项目架构、代码组织、开发经验、质量门禁与常见坑的统一入口。 +- `references/技术栈.md`：技术栈选型、组合案例与初学者学习路径。 ## 操作规范 diff --git a/docs/README.md b/docs/README.md index 9870873..47e1882 100644 --- a/docs/README.md +++ b/docs/README.md @@ -15,7 +15,7 @@ ## 推荐入口 1. [从零开始完整入门](./getting-started/README.md) -2. [问题求解能力](./concepts/问题求解能力.md) +2. [问题求解](./concepts/问题求解.md) 3. [思维模型](./philosophy/思维模型.md) 4. [组合描述模型](./philosophy/组合描述模型.md) 5. [拼好码](./concepts/拼好码.md) diff --git a/docs/concepts/软件开发范式演进.md b/docs/concepts/开发范式演进.md similarity index 98% rename from docs/concepts/软件开发范式演进.md rename to docs/concepts/开发范式演进.md index 226a58f..643bb94 100644 --- a/docs/concepts/软件开发范式演进.md +++ b/docs/concepts/开发范式演进.md @@ -1,4 +1,4 @@ -# 软件开发范式演进 +# 开发范式演进 软件开发范式的演进可以概括为一组随工程复杂度提升而逐步形成的设计思想与组织方式，而非严格的历史线性阶段或全球统一的标准分期。 diff --git a/docs/concepts/问题分析与系统构建方法.md b/docs/concepts/系统构建方法.md similarity index 99% rename from docs/concepts/问题分析与系统构建方法.md rename to docs/concepts/系统构建方法.md index 396dd17..9d93bbe 100644 --- a/docs/concepts/问题分析与系统构建方法.md +++ b/docs/concepts/系统构建方法.md @@ -1,4 +1,4 @@ -# 问题分析与系统构建方法 +# 系统构建方法 软件工程中的自顶向下、自底向上和分而治之，是三种经典的问题分析与系统构建方法。 diff --git a/docs/concepts/递归自优化生成系统形式化.md b/docs/concepts/递归自优化系统.md similarity index 99% rename from docs/concepts/递归自优化生成系统形式化.md rename to docs/concepts/递归自优化系统.md index 1babb9d..5f1de78 100644 --- a/docs/concepts/递归自优化生成系统形式化.md +++ b/docs/concepts/递归自优化系统.md @@ -1,4 +1,4 @@ -# 递归自优化生成系统形式化 +# 递归自优化系统 **tukuai** 独立研究者 diff --git a/docs/concepts/问题求解能力.md b/docs/concepts/问题求解.md similarity index 99% rename from docs/concepts/问题求解能力.md rename to docs/concepts/问题求解.md index b60f385..33412f3 100644 --- a/docs/concepts/问题求解能力.md +++ b/docs/concepts/问题求解.md @@ -1,4 +1,4 @@ -# 问题求解能力 +# 问题求解 ## 不会操作？先让网页 AI 生成逐步执行版 diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md index 47b41cb..e1f9e5a 100644 --- a/docs/getting-started/README.md +++ b/docs/getting-started/README.md @@ -40,7 +40,7 @@ | 路线 | 适合谁 | 目标 | 首选入口 | |:---|:---|:---|:---| -| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../concepts/问题求解能力.md) | +| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解](../concepts/问题求解.md) | | 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](README.md) | | Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) | | Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) | @@ -51,7 +51,7 @@ 目标：完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。 -1. [问题求解能力](../concepts/问题求解能力.md) +1. [问题求解](../concepts/问题求解.md) 先学会把问题说清楚：目标、现状、差距、标准、约束、对象、路径。 2. [网络环境配置](README.md) 先解决访问 OpenAI、GitHub、文档和依赖源的问题。 @@ -95,7 +95,7 @@ 1. [提示词库入口](../../../prompts/README.md) 2. [工程实践](../references/工程实践.md) 3. [语言层要素](../concepts/语言层要素.md) -4. [问题求解能力](../concepts/问题求解能力.md) +4. [问题求解](../concepts/问题求解.md) 练习方式： @@ -156,7 +156,7 @@ 如果你不知道从哪里开始，按这个顺序： ```text -问题求解能力 +问题求解 -> 网络环境配置 -> Codex / ChatGPT 订阅与登录准备 -> Codex CLI 配置 diff --git a/docs/references/README.md b/docs/references/README.md index f53273a..a0a86a9 100644 --- a/docs/references/README.md +++ b/docs/references/README.md @@ -9,13 +9,13 @@ - [语言层要素](../concepts/语言层要素.md) - 看懂 100% 代码的 8 个层级 ### 理论基础 -- [递归自优化生成系统形式化](../concepts/递归自优化生成系统形式化.md) - 元方法论 +- [递归自优化系统](../concepts/递归自优化系统.md) - 元方法论 - [编程之道](../philosophy/编程之道.md) - 编程哲学 ### 软件工程基础 -- [问题求解能力](../concepts/问题求解能力.md) - 目标、现状、差距、标准与反馈迭代的底层能力 -- [问题分析与系统构建方法](../concepts/问题分析与系统构建方法.md) - 自顶向下、自底向上与分而治之的组合使用 -- [软件开发范式演进](../concepts/软件开发范式演进.md) - 从面向过程到云原生的工程组织方式演进 +- [问题求解](../concepts/问题求解.md) - 目标、现状、差距、标准与反馈迭代的底层能力 +- [系统构建方法](../concepts/系统构建方法.md) - 自顶向下、自底向上与分而治之的组合使用 +- [开发范式演进](../concepts/开发范式演进.md) - 从面向过程到云原生的工程组织方式演进 ### 工程实践 - [工程实践](工程实践.md) - 项目架构、代码组织、开发经验、底层程序逻辑、AI 编程质量门禁与常见坑的统一入口 diff --git a/docs/research/Harness Engineering 的本质拆解.md b/docs/research/Harness工程解析.md similarity index 98% rename from docs/research/Harness Engineering 的本质拆解.md rename to docs/research/Harness工程解析.md index 1489a08..b81359b 100644 --- a/docs/research/Harness Engineering 的本质拆解.md +++ b/docs/research/Harness工程解析.md @@ -1,4 +1,4 @@ -# Harness Engineering 的本质拆解 +# Harness 工程解析 1. Harness Engineering 的本质是用确定性的工程控制系统，把大模型的非确定性输出压缩进可预测的轨道里，让“概率生成”变成“可验收的产出” diff --git a/docs/research/README.md b/docs/research/README.md index 829219a..b4795f9 100644 --- a/docs/research/README.md +++ b/docs/research/README.md @@ -11,4 +11,4 @@ ## 文档列表 -- [Harness Engineering 的本质拆解](Harness%20Engineering%20的本质拆解.md) - 用工程控制、评估器、反馈闭环和约束机制提升 AI 生成系统可靠性的技术解析。 +- [Harness 工程解析](Harness工程解析.md) - 用工程控制、评估器、反馈闭环和约束机制提升 AI 生成系统可靠性的技术解析。 diff --git a/llms.txt b/llms.txt index e41face..9a72ff3 100644 --- a/llms.txt +++ b/llms.txt @@ -21,7 +21,7 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程，帮 首选入口： - README.md - docs/getting-started/README.md -- docs/concepts/问题求解能力.md +- docs/concepts/问题求解.md - docs/concepts/拼好码.md - docs/philosophy/组合描述模型.md - docs/references/工程实践.md diff --git a/metadata/redirects.yml b/metadata/redirects.yml index e7f6504..b2647fd 100644 --- a/metadata/redirects.yml +++ b/metadata/redirects.yml @@ -12,9 +12,19 @@ redirects: - from: docs/concepts/编程之道.md to: docs/philosophy/编程之道.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 - 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 to: docs/philosophy/README.md - from: docs/philosophy/辩证法.md