docs: clean readme title preambles

This commit is contained in:
tukuaiai
2026-05-05 01:49:37 +08:00
parent 373a68c166
commit 6cae4ba3bb
6 changed files with 7 additions and 10 deletions
-2
View File
@@ -1,7 +1,5 @@
# 知识库总索引
> `docs/` 是本仓库的核心知识库入口,承载从零开始、核心概念、哲学模型、研究笔记和工程参考资料。
## 字多不看
- 新手先读 `getting-started/`,按网络环境、CLI 配置、开发环境和 Git 闭环推进。
-2
View File
@@ -2,8 +2,6 @@
# 核心概念
> `concepts/` 是 Vibe Coding 的核心概念手册,用一个线性文档承载问题求解、拼好码、系统构建、开发范式、语言层要素与递归自优化系统。
## 字多不看
- 本目录回答“先用什么概念理解问题”。
-2
View File
@@ -3,8 +3,6 @@
# 哲学方法论
> `philosophy/` 是哲学方法论、思维模型、编程哲学和底层认知模型的线性手册。
## 字多不看
- 本目录回答“为什么这样判断、如何减少幻觉、如何让复杂问题可描述、可推理、可验证”。
-2
View File
@@ -3,8 +3,6 @@
# 参考资料
> `references/` 是工程实践、技术栈、模板、清单、质量门禁和可复用经验的线性手册。
## 字多不看
- 本目录回答“具体工程怎么组织、怎么选技术、怎么设置硬门禁”。
-2
View File
@@ -2,8 +2,6 @@
# 研究
> `research/` 是新技术、新技术栈、优秀 repo、工程范式和工具趋势的短篇解析与判断笔记。
## 字多不看
- 本目录是“观察与判断区”。
+7
View File
@@ -132,6 +132,13 @@ def check_standard_readme_blocks(path: Path, text: str) -> list[str]:
if len(positions) != len(STANDARD_README_BLOCKS):
return errors
title_end = positions[0][1] + text[positions[0][1] :].find("\n")
if title_end < positions[0][1]:
title_end = len(text)
between_title_and_summary = text[title_end:positions[1][1]].strip()
if between_title_and_summary:
errors.append(f"{rel}: standard README block '字多不看' must immediately follow the top title")
previous_name, previous_pos = positions[0]
for block_name, position in positions[1:]:
if position <= previous_pos: