docs: methodology - format dialectics note

.gitmodules

@@ -4,3 +4,6 @@
 [submodule "libs/external/tmux"]
 	path = libs/external/tmux
 	url = https://github.com/tmux/tmux.git
+[submodule "libs/external/claude-official-skills"]
+	path = libs/external/claude-official-skills
+	url = https://github.com/anthropics/skills.git

README.md

@@ -242,32 +242,22 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真
 
 * **状态，变换；数据，函数；输入，处理，输出；抽象/收敛，展开；可解释性；层级；过程；全称/特称，肯定/否定**
 * **人下 AI 上**
-* **凡是 AI 能做的，就不要人工做**
 * **一切问题问 AI**
 * **目的主导：开发过程中的一切动作围绕"目的"展开**
 * **上下文是 vibe coding 的第一性要素，垃圾进，垃圾出**
-* **系统性思考，实体，链接，功能/目的，三个维度**
-* **数据与函数即是编程的一切**
-* **输入，处理，输出刻画整个过程**
-* **多问 AI 是什么？，为什么？，怎么做？（黄金圈法则）**
-* **先结构，后代码，一定要规划好框架，不然后面技术债还不完**
-* **奥卡姆剃刀定理，如无必要，勿增代码**
-* **帕累托法则，关注重要的那20%**
-* **逆向思考，先明确你的需求，从需求逆向构建代码**
-* **重复，多试几次，实在不行重新开个窗口，**
-* **专注，极致的专注可以击穿代码，一次只做一件事**
-* **一句话目标 + 非目标**
-* **正交性（这个分场景）**
-* **能抄不写，不重复造轮子，先问 AI 有没有合适的仓库，下载下来改（glue coding 基于 vibe coding全新的方法）**
-* **一定要看官方文档，先把官方文档爬下来喂给 AI（让 AI 找工具下载到本地）**
+* **系统性思考，从 实体，链接，功能/目的 开始**
+* **数据与函数是编程的一切**
+* **先结构，后代码**
+* **使用帕累托法则，关注重要的那20%**
+* **逆向思考，先明确你的需求，从满足需求为起点构建代码**
+* **重复，多尝试几次**
+* **模仿优先，不重复造轮子，先问 AI 有没有合适的仓库，下载下来改（glue coding 基于 vibe coding全新的方法）**
 * **按职责拆模块**
 * **接口先行，实现后补**
-* **一次只改一个模块**
 * **文档即上下文，不是事后补**
-* 明确写清：**能改什么，不能改什么**
-* Debug 只给：**预期 vs 实际 + 最小复现**
-* 测试可交给 AI，**断言人审**
-* 代码一多就**切会话**
+* **明确写清：能改什么，不能改什么**
+* **Debug 只给：预期 vs 实际 + 最小复现**
+* **测试可交给 AI，断言人审**
 * **AI 犯的错误使用提示词整理为经验持久化存储，遇到问题始终无法解决，就让AI检索这个收集的问题然后寻找解决方案**
 
 </details>
@@ -359,9 +349,9 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真
 
 ## 🏁 编码模型性能分级参考
 
-建议只选择第一梯队模型处理复杂任务，以确保最佳效果与效率。
+建议只选择苹果模型处理复杂任务，以确保最佳效果与效率。
 
-*   **第一梯队**: [gpt-5.2-xhigh](https://chatgpt.com/codex)
+*   **苹果**: [gpt-5.2-xhigh](https://chatgpt.com/codex)
 
 ---
 

documents/05-哲学与方法论/辩证法.md

@@ -1,11 +1,28 @@
-把辩证法的正反合用到 vibe coding：我把每次写代码都当一轮“三段论”
-
-正（当前状态）：先让模型按直觉快速给出“最顺的实现”，目标只有一个：尽快跑通主路径
-
-反（审计与调优）：立刻站在“挑刺者”视角反驳它：列失败模式/边界条件/性能与安全隐患，并用测试、类型、lint、基准把反驳落地
-
-合（根据审核计修正）：把速度与约束合起来：重构接口、收敛依赖、补齐测试与文档，形成下一轮更稳定的起点
-
-实践口诀：先顺写 → 再打脸 → 再收敛
-
-vibe 负责生成可能性，正反合负责把可能性变成工程确定
+# 辩证法在 Vibe Coding 里的用法：正反合
+
+把辩证法的“正反合”用到 Vibe Coding：我把每次写代码都当一轮“三段论”。
+
+## 正：当前状态（先跑通）
+
+- 让模型按直觉快速给出“最顺的实现”
+- 目标只有一个：尽快跑通主路径
+
+## 反：审计与调优（再打脸）
+
+- 立刻站在“挑刺者”视角反驳它
+- 列出失败模式、边界条件、性能与安全隐患
+- 用测试、类型、lint、基准把反驳落地
+
+## 合：根据审核修正（再收敛）
+
+- 把速度与约束合起来
+- 重构接口、收敛依赖、补齐测试与文档
+- 形成下一轮更稳定的起点
+
+## 实践口诀
+
+先顺写 → 再打脸 → 再收敛
+
+## 一句话总结
+
+Vibe 负责生成可能性，正反合负责把可能性变成工程确定性。

libs/external/AGENTS.md

@@ -0,0 +1,27 @@
+# libs/external/ 目录 Agent 指南
+
+本目录用于收纳 **外部工具/第三方项目**（含 Git submodule），保持“主仓库资产”和“外部依赖”边界清晰、可审计、可更新。
+
+## 目录结构（约定）
+
+```text
+libs/external/
+├── AGENTS.md                         # 本文件（目录级行为准则）
+├── README.md                         # 外部工具索引
+├── .tmux/                            # submodule：oh-my-tmux 配置
+├── tmux/                             # submodule：tmux 源码
+└── claude-official-skills/           # submodule：Claude 官方 skills 仓库（Anthropic）
+```
+
+## 操作规范
+
+### 允许
+
+- 新增外部依赖（优先 Git submodule，确保可复现）
+- 更新 submodule 指针（明确记录上游来源与用途）
+
+### 禁止 / 不推荐
+
+- 直接复制粘贴大型第三方仓库内容到主仓库（优先 submodule）
+- 将 submodule 替换为本地绝对路径软链接（会导致他人环境不可用）
+

libs/external/claude-official-skills

@@ -0,0 +1 @@
+Subproject commit 1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563

skills/AGENTS.md

@@ -17,6 +17,11 @@ skills/
 └── skills-skills/                # 元技能：生成/校验/脚手架化其它技能
 ```
 
+## 外部仓库引用（约定）
+
+- 允许在 `skills/` 下放置“只读引用”的软链接，用于引入外部权威仓库的内容（便于统一索引与检索）。
+- 为保证可复现性：软链接目标必须落在仓库内，并优先使用 Git submodule 管理（避免链接到个人机器的绝对路径）。
+
 ## 模块职责与边界
 
 - 每个 `<skill-name>/` 必须以 `SKILL.md` 作为入口，明确：
@@ -45,3 +50,4 @@ skills/
 - `skills/sop-generator/`：SOP 生成与规范化
 - `skills/markdown-to-epub/`：Markdown → EPUB 稳定构建
 - `skills/skills-skills/`：元技能（技能生成/校验/脚手架）
+- `skills/claude-official-skills/`：Claude 官方 skills 仓库（Anthropic）的软链接入口

skills/README.md

@@ -54,6 +54,11 @@
 |:---|:---|
 | [markdown-to-epub](./markdown-to-epub/SKILL.md) | Markdown 转 EPUB 电子书 |
 
+## 外部技能仓库（软链接）
+
+- `skills/claude-official-skills/`：来自 Claude 官方 skills 仓库（Anthropic）。本仓库以 Git submodule 的形式落在 `libs/external/claude-official-skills/`，并通过软链接暴露到 `skills/` 下便于浏览与复用。
+- 初始化/更新方式：`git submodule update --init --recursive`
+
 ## 快速使用
 
 ```bash
@@ -79,3 +84,4 @@ cat skills/postgresql/SKILL.md
 - [元技能文件](./skills-skills/SKILL.md) - 生成 Skills 的 Skills
 - [提示词库](../prompts/) - 更细粒度的提示词集合
 - [文档库](../documents/) - 方法论与开发经验
+- [skills.sh](https://skills.sh/) - Skill 大全网站

skills/claude-official-skills

@@ -0,0 +1 @@
+../libs/external/claude-official-skills