Phase 0-2: Schema cleanup, typed relations, event-driven automation

- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd)
- Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py)
- Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks
- Fix .gitignore to track tools/ and .githooks/
- Fix git remote URL (remove plaintext token)
- New wiki pages: 504 pages, 34 raw sources
This commit is contained in:
hehaiguang1123
2026-07-01 08:05:43 +08:00
parent e544d6e04a
commit a6f05ab2d5
1067 changed files with 522992 additions and 819 deletions
+490
View File
@@ -0,0 +1,490 @@
---
categories:
- "[[Documentation]]"
tags:
- documentation
- examples
- reading-notes
created: 2026-05-23
type: example
---
# 读书笔记规范使用示例
> 本文档展示如何使用《读书笔记优化规范》,包含完整的实际案例。
## 示例 1:完整读书笔记
### 案例:读躬行客之《井冈山的战略》
**文件位置**`读躬行客之《井冈山的战略》.md`
**优化前的问题**
- ❌ Frontmatter 缺少 `categories`
- ❌ 标签不规范(大写、空格)
- ❌ 内容嵌套在 ` ```markdown` 代码块中
- ❌ 章节标题冗余(带序号"一、"、"二、"
- ❌ 缺少 Callout 高亮
- ❌ 缺少延伸阅读
**优化后**
```markdown
---
categories:
- "[[Clippings]]"
tags:
- clippings
- reading
- strategy
- mao-zedong
- jinggangshan
- cognition
created: 2026-05-22
rating: 5
author:
- 躬行客
via: ""
url: "https://articles.zsxq.com/id_p7oor15elw8z.html"
---
> **一句话**:战略问题是决定死活和输赢的全局性问题。制定战略的基础是实事求是调查研究的数据。坚持战略的关键是对事物本质的认知。
---
来源:[文章链接](https://articles.zsxq.com/id_p7oor15elw8z.html)
# 井冈山的战略逻辑与个人启发
> 基于对话内容整理
## 战略的定义
战略问题是指对全局有决定性影响的问题,而非局部性的、对全局无关紧要的问题。
"对全局有决定意义的一着,而不是那种带局部性的,即对全局无决定意义的一着。"
> [!info] 战略的核心问题
>
> 战略问题通常只跟两个问题有关:
>
> - **什么问题解决不掉,你会死?(目标死亡)**
> - **什么问题解决不掉,你无法赢?(目标无法实现)**
### 井冈山的两大战略短板
1. **资源匮乏**
- 人口不满两千,产谷不满万担
- 军粮全靠宁冈、永新、遂川三县输送
2. **军事机动范围太小**
- 湘江和赣江像两堵墙,夹住井冈山
- 红军无法徒涉大江,机动范围受限
> [!danger] 战略危机
>
> **这两个短板不解决,井冈山根据地没有发展前途可言。**
## 逻辑链
1. 战略的定义 → 全局性、关乎生死/胜负的问题
2. 井冈山案例 → 识别两大战略短板
3. 教员的方案 → 以永新为跳板向赣东发展
4. 干扰与分歧 → 八月失败导致方案中断
## 教员的战略规划
### 革命战略的核心问题
> [!important] 革命胜利的基本条件
>
> **革命力量必须大于反革命力量。**
>
> 不是一时一地的大于,而是系统性的大于。
### 农村包围城市战略
- **土地革命**:每多一个分得土地的农民,革命力量就大一分
- **武装力量**:红军支持土地革命
- **根据地**:保卫革命成果,积累力量
> [!tip] 三位一体
>
> **三者是一个整体,缺一不可。**
## 有战略 vs 无战略
> [!quote] 战略的本质差异
>
> 人生有无战略区别之大,犹如草履虫和人之间的区别。
### 陈浩(无战略)
- 打下茶陵后,不知道要做什么
- 碰到问题用老办法,关键问题视而不见
- 最终叛变
### 教员(有战略)
- 打土豪分田地
- 提出三大任务(战斗、宣传、政治)
- 建立三大纪律、六项注意
> [!warning] 战略缺失的后果
>
> 没有战略,所有的问题都将失去可靠解。
>
> 要拿战略方针去指导战役战术方针。
## 战略制定的基础
> [!tip] 战略制定的禁忌
>
> **战略绝对不是拍脑门想出来的。**
可靠的战略,一定建立在可靠的、全面的、有效的信息之上。
### 教员的"数字井冈山"
教员对以下信息全部了然于心:
- 地貌环境、关键拗口
- 村落分布、人口、粮食产出
- 周边各县的枪械数量、党组织情况
> [!success] 实事求是的力量
>
> 调查研究是教员的看家本领。
>
> 实事求是,永远都是最有力量的。
## 坚持战略的难点
战略在没有实现之前,谁都不敢讲是百分百正确的。
在坚持战略的过程中,会碰到很多干扰,每一次干扰和打击都会让你怀疑:**自己是不是错了?**
### 教员对抗悲观情绪的武器:认知
#### 两个核心认知
1. **红军的发展前途**:看军阀混战 → 军阀混战取决于列强是否分出胜负
2. **革命最终能否胜利**:看群众 → 群众是创造历史的根本动力
> [!important] 群众的力量
>
> 只要赢得了群众,最终一定能赢得战争。
## 个人启发
### 1. 高手在成名之前就已经是高手
> 教员不是上了井冈山才有了本事,这些文章是他此前的思考跟实际情况结合的产物。
### 2. 战略能力需要认知基础
- 如果没有认知基础,随便一个负反馈就会让你自我怀疑
- **认知是一个人的核心竞争力**
> [!info] 核心竞争力
>
> **认知是一个人的核心竞争力**
### 3. 第一步:先让自己的肚子里有货
- 杜修经头脑空空,哪怕教员一对一辅导也无法提高
- 需要大量的阅读、学习、经历
- **像存钱罐一样,先装点东西进去**
> [!tip] 认知积累
>
> **像存钱罐一样,先装点东西进去**
### 4. 从小事培养战略头脑
- 任何事都有局部和全局问题
- 只要涉及全局问题,就有战略问题
- 从小事做起,多从全局、整体出发考虑事情
> 当你想要把一件事做成功时,就必须考虑这件事涉及到的方方面面,从而明确最关键的部分、最核心的矛盾。
>
> 当你开始围绕这个核心矛盾做布置时,就已经涉及到了战略问题。
## 总结
| 核心论点 | 关键表述 |
|----------|----------|
| 战略的定义 | 全局性、决定生死/胜负的问题 |
| 战略的制定 | 建立在全面调研、实事求是的基础上 |
| 战略的坚持 | 需要对事物本质的认知 |
| 个人启发 | 从小事全局意识开始,长期积累认知,逐步形成战略头脑 |
## 延伸阅读
### 相关主题
- [[实事求是]] - 实事求是的哲学基础和方法论
- [[调查研究]] - 调查研究的意义和实践方法
- [[唯物辩证法]] - 对事物本质的认知工具
- [[群众路线]] - 群众是创造历史的根本动力
### 阅读建议
这篇笔记适合反复阅读,建议配合以下实践:
1. 在实际工作/学习中应用"两个战略问题"框架
2. 建立自己的"数字XXX"调研体系
3. 从小事开始培养全局意识
```
---
## 示例 2:使用模板快速创建
### 步骤 1:复制模板
`Templates/读书笔记模板.md` 复制内容。
### 步骤 2:填写 Frontmatter
```yaml
---
categories:
- "[[Clippings]]"
tags:
- clippings
- reading
- strategy
- cognition
created: 2026-05-23
rating: 5
author:
- 躬行客
via: ""
url: "https://articles.zsxq.com/id_p7oor15elw8z.html"
---
```
### 步骤 3:填写一句话总结
```markdown
> **一句话**:战略问题是决定死活和输赢的全局性问题。制定战略的基础是实事求是调查研究的数据。坚持战略的关键是对事物本质的认知。
```
### 步骤 4:整理正文内容
按章节结构组织内容,使用 Callout 高亮关键观点。
---
## 示例 3Callout 使用场景
### 场景 1:高亮核心观点
```markdown
> [!info] 战略的核心问题
>
> 战略问题通常只跟两个问题有关:
> - 什么问题解决不掉,你会死?
> - 什么问题解决不掉,你无法赢?
```
### 场景 2:警示风险
```markdown
> [!danger] 战略危机
>
> **这两个短板不解决,井冈山根据地没有发展前途可言。**
```
### 场景 3:引用金句
```markdown
> [!quote] 战略的本质差异
>
> 人生有无战略区别之大,犹如草履虫和人之间的区别。
```
### 场景 4:提供建议
```markdown
> [!tip] 三位一体
>
> **三者是一个整体,缺一不可。**
```
### 场景 5:标注重要原则
```markdown
> [!important] 革命胜利的基本条件
>
> **革命力量必须大于反革命力量。**
>
> 不是一时一地的大于,而是系统性的大于。
```
---
## 示例 4:延伸阅读 wikilink
### 添加相关主题
```markdown
### 相关主题
- [[实事求是]] - 实事求是的哲学基础和方法论
- [[调查研究]] - 调查研究的意义和实践方法
- [[唯物辩证法]] - 对事物本质的认知工具
```
### 添加阅读建议
```markdown
### 阅读建议
这篇笔记适合反复阅读,建议配合以下实践:
1. 在实际工作/学习中应用"两个战略问题"框架
2. 建立自己的"数字XXX"调研体系
3. 从小事开始培养全局意识
```
---
## 示例 5:常见错误及修正
### 错误 1Frontmatter 缺失 categories
**❌ 错误**
```yaml
---
tags:
- note
- journal
created: 2026-05-22
---
```
**✅ 修正**
```yaml
---
categories:
- "[[Clippings]]"
tags:
- clippings
- reading
created: 2026-05-22
---
```
---
### 错误 2:内容嵌套在代码块中
**❌ 错误**
```markdown
---
```markdown
# 井冈山的战略逻辑
内容...
```
```
**✅ 修正**
```markdown
---
# 井冈山的战略逻辑
内容...
```
---
### 错误 3:章节标题冗余
**❌ 错误**
```markdown
## 一、什么叫战略?
## 二、作者的逻辑链(示意图)
## 三、教员的战略规划
```
**✅ 修正**
```markdown
## 战略的定义
## 逻辑链
## 教员的战略规划
```
---
### 错误 4:列表缩进不规范
**❌ 错误**
```markdown
- 一级列表
- 二级列表(4 空格)
- 三级列表(8 空格)
```
**✅ 修正**
```markdown
- 一级列表
- 二级列表(3 空格)
- 三级列表(6 空格)
```
---
## 工作流演示
### 完整创建流程
```bash
# 1. 使用 Obsidian CLI 创建笔记
obsidian create name="读XX之《标题》" template="读书笔记模板.md" silent
# 2. 编辑笔记,填写 frontmatter 和内容
# (手动编辑)
# 3. 验证格式
obsidian read file="读XX之《标题》"
```
### 质量检查清单
创建/优化读书笔记时,逐项检查:
**Frontmatter**
- [ ] `categories: [[Clippings]]` 存在
- [ ] `tags` 包含 `clippings``reading`
- [ ] `created` 日期正确
- [ ] `author``url` 等可选字段填写
**内容结构**
- [ ] 有一句话总结(推荐)
- [ ] 来源信息明确
- [ ] 章节标题简洁(无序号前缀)
- [ ] 使用 Callout 高亮关键观点(3-8 个)
- [ ] 列表缩进规范(3/6 空格)
- [ ] 有总结章节
**可关联性**
- [ ] 添加延伸阅读章节
- [ ] 包含 3+ 个 wikilink
- [ ] 使用嵌套标签
---
## 相关资源
- [[读书笔记优化规范]] - 完整规范文档
- [[Templates/读书笔记模板.md]] - 可直接使用的模板
- [[Templates/Clipping Template.md]] - 优化后的 Clipping 模板
- [[AGENTS.md]] - PARA + LLM Wiki 架构规范