From 6db70e4bd612fa2281e3840141c65269f9b97c06 Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sun, 3 May 2026 21:29:27 +0800 Subject: [PATCH] docs: fold linear article sections --- docs/concepts/README.md | 25 +++++++++++++++++++++++++ docs/getting-started/README.md | 25 +++++++++++++++++++++++++ docs/philosophy/README.md | 17 +++++++++++++++++ docs/references/README.md | 9 +++++++++ docs/research/README.md | 5 +++++ 5 files changed, 81 insertions(+) diff --git a/docs/concepts/README.md b/docs/concepts/README.md index ab61f3d..1a0e3c3 100644 --- a/docs/concepts/README.md +++ b/docs/concepts/README.md @@ -171,6 +171,9 @@ --- +
+1. 问题求解 - 目标、现状、差距、标准、约束、对象与路径。 + ## 1. 问题求解 @@ -752,6 +755,10 @@ A 和 B 之间的距离、障碍、路线不清楚的地方，就是问题。 任何问题，都是当前状态到目标状态之间的差距；任何能力，都是推进这个差距收敛的能力。 +
+ +
+2. 拼好码 - 复用成熟能力，用胶水代码连接、编排、适配业务流程。 @@ -1263,6 +1270,10 @@ AI 特别适合生成： - [语言层要素](#concept-language-layers) - 看懂代码需要掌握的语言层级 - [胶水开发提示词（在线提示词库入口）](../../../prompts/README.md) +
+ +
+3. 系统构建方法 - 自顶向下、自底向上与分而治之的组合使用。 @@ -1417,6 +1428,10 @@ AI 特别适合生成： 所以，这三种方法不是“选一个、排斥另外两个”，而是从不同角度帮助我们管理复杂度、组织代码和构建系统。 +
+ +
+4. 开发范式演进 - 软件工程组织方式的演进。 @@ -1446,6 +1461,10 @@ AI 特别适合生成： 上述内容并不表示软件开发存在固定、统一或严格递进的阶段划分。不同范式和架构思想往往并存，并会根据项目规模、业务复杂度、团队协作方式和技术环境被组合使用。 +
+ +
+5. 语言层要素 - 看懂代码所需的语言层要素。 @@ -2007,6 +2026,10 @@ async def get_user(user_id: int, db: Session = Depends(get_db)): > 🎯 **目标不是"学完 12 层"，而是"遇到问题知道卡在哪一层"** +
+ +
+6. 递归自优化系统 - 递归自优化生成系统的形式化模型。 @@ -2198,3 +2221,5 @@ $$ #### 3. 终极目标 通过这个持续运行的**递归优化循环**，系统在每次迭代中都完成一次**自我超越**，不断逼近我们设定的**理想状态**。 + +
diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md index 010f003..c341bba 100644 --- a/docs/getting-started/README.md +++ b/docs/getting-started/README.md @@ -48,6 +48,9 @@ +
+1. Vibe Coding 经验 - 通用语言能力、人机分工、机器门禁和入门铁律。 + ## 1. Vibe Coding 经验 @@ -147,6 +150,11 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认 → [CLI 配置](#4-cli-配置) - 默认 AI CLI 路线，文末包含 OpenCode 备选方案 +
+ +
+2. 学习地图 - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。 + ## 2. 学习地图 @@ -298,6 +306,11 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认 - 开发者：阅读 [Vibe Coding 经验](#1-vibe-coding-经验)，再选择 Skill 或质量门禁路线。 - 团队：先统一 [AGENTS.md](../../../../AGENTS.md)、强前置条件和质量门禁。 +
+ +
+3. 网络环境配置 - OpenAI、GitHub、文档和依赖源访问。 + ## 3. 网络环境配置 > Vibe Coding 的前置条件：确保能正常访问 GitHub、Google、Claude 等服务。 @@ -435,6 +448,11 @@ export http_proxy=http://127.0.0.1:7890 网络配置完成后，继续阅读 [开发环境搭建](#5-开发环境搭建)。 +
+ +
+4. CLI 配置 - Codex CLI 默认路线与 OpenCode 备选路线。 + ## 4. CLI 配置 > 默认 AI CLI 路线：假设你拿到的是一台全新电脑，从 0 安装系统依赖、Node.js、Codex CLI，然后用浏览器完成 Codex 登录。 @@ -919,6 +937,11 @@ opencode → [开发环境搭建](#5-开发环境搭建) - 回看基础环境 +
+ +
+5. 开发环境搭建 - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。 + ## 5. 开发环境搭建 > 使用方法：Codex CLI 已跑通时，优先让 Codex Agent 读取本节并主动配置剩余环境；Codex CLI 不可用时，再复制下方对应你设备的提示词，粘贴到任意 AI 对话框（ChatGPT、Claude、Gemini 网页版等），让网页 AI 一步步指导你完成配置。 @@ -1176,3 +1199,5 @@ alias oc='opencode' 环境搭建完成后，继续下一步： → [CLI 配置](#4-cli-配置) - 配置默认 AI CLI + +
diff --git a/docs/philosophy/README.md b/docs/philosophy/README.md index f8dabb4..cbe7aca 100644 --- a/docs/philosophy/README.md +++ b/docs/philosophy/README.md @@ -172,6 +172,9 @@ --- +
+1. 思维模型 - 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。 + ## 1. 思维模型 @@ -402,6 +405,10 @@ 在工程实践中，状态空间思维能防止“一步走死”：重要操作前先建立检查点，优先走可验证、可回滚、可分阶段收敛的路径。 +
+ +
+2. 组合描述模型 - 对象、状态、快照、序列、过程、变换、同一/差异与关系。 @@ -943,6 +950,10 @@ UserInput(组合描述模型) 从这个意义上说，这组概念，几乎就是一切系统性思考的基础语法。 +
+ +
+3. 编程之道 - 编程哲学、结构、状态、复杂度与工程判断。 @@ -1265,6 +1276,10 @@ UserInput(组合描述模型) 愿你在复杂世界中保持清晰，在代码中看到本质 +
+ +
+4. 方法论工具箱 - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。 @@ -1981,3 +1996,5 @@ README.md # 概念表/错误语义/验收指标 用于 AI 编程时，这套方法可以压缩成一句话： > 先把目标写成可检验状态，再用测试、日志、反馈、约束和迭代，把模型输出从可能性空间中逐步收缩到可验收结果。 + +
diff --git a/docs/references/README.md b/docs/references/README.md index 230b595..0e57625 100644 --- a/docs/references/README.md +++ b/docs/references/README.md @@ -264,6 +264,9 @@ --- +
+1. 工程实践 - 项目架构、代码组织、开发经验、质量门禁与常见坑。 + ## 1. 工程实践 @@ -3765,6 +3768,10 @@ CPU 成本 缺少容量评估 ``` +
+ +
+2. 技术栈 - 技术栈选型、组合案例与学习路径。 @@ -5456,3 +5463,5 @@ AI 路线： > Python + PyTorch + FastAPI + 大模型 API 真正重要的不是“知道很多技术名词”，而是能用合适的技术栈，把一个项目稳定、清晰、可维护地做出来。 + +
diff --git a/docs/research/README.md b/docs/research/README.md index 6c6e2ea..264ac4a 100644 --- a/docs/research/README.md +++ b/docs/research/README.md @@ -38,6 +38,9 @@ --- +
+1. Harness 工程解析 - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。 + ## 1. Harness 工程解析 @@ -87,3 +90,5 @@ 21. Harness 的上限由评估器决定：如果你无法把“好结果”编码为可检验的规则与测试，系统就无法稳定优化，模型也无法替你完成这层战略定义 22. 未来工程师的分化本质是控制权分配：一类在代码生成速度上竞争，另一类在规则、评估、架构与闭环设计上竞争，后者决定系统长期生产力与可维护性 + +