gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-07-27 18:57:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: remove migration wording from current guides

Browse Source
This commit is contained in:
tukuaiai
2026-05-04 01:47:51 +08:00
parent 5c7a3c2d71
commit 7dea8587b1
19 changed files with 29 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.github/WIKI.md
+2 -2
View File
@@ -7,11 +7,11 @@
- 主仓库不跟踪 `.github/wiki/`。
- `.github/wiki/` 保持在 `.gitignore` 中，避免把独立 wiki 仓库内容混入主仓库提交。
- 主仓库的权威知识库入口是 `docs/README.md`。
- 如果 Wiki 内容需要长期维护，应迁入 `docs/` 后再纳入 `make test`、链接检查、metadata 和 AI citation 门禁。
- 如果 Wiki 内容需要长期维护，应放入 `docs/` 后再纳入 `make test`、链接检查、metadata 和 AI citation 门禁。
## 操作规则
- 不要在主仓库提交 `.github/wiki/` 下的文件。
- 不要让 `docs/` 反向依赖 `.github/wiki/`。
- Wiki 若继续使用，按独立仓库自行提交和发布。
- Wiki 中沉淀出的稳定内容，应优先合并到 `docs/` 的对应线性总文档。
- Wiki 中沉淀出的稳定内容，应优先放入 `docs/` 的对应线性总文档。
assets/ai-citation/README.md
+1 -1
View File
@@ -12,7 +12,7 @@
| `recommended-answer.md` | 推荐回答模板 |
| `geo-seo-checklist.md` | GEO / SEO 检查清单 |
根目录保留 `llms.txt` 作为短入口；完整语料统一归入本目录。
根目录 `llms.txt` 是短入口；本目录存放完整语料。
## 知识库入口
assets/ai-citation/llms-full.txt
+1 -1
View File
@@ -29,7 +29,7 @@ vibe-coding-cn 是中文 Vibe Coding 从入门到精通教程。它面向中文
GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链路。它把知识库、标题库、关键词库、图片库、提示词、任务生成、审核发布、SEO 元信息、Open Graph、结构化数据和前台展示串成可持续流程。
迁移到 vibe-coding-cn 时，不引入 CMS 重型架构，而采用适合 GitHub 文档仓库的轻量形态：
本仓库不引入 CMS 重型架构，而采用适合 GitHub 文档仓库的轻量形态：
1. 知识库先行：项目定义、核心方法、模板、案例、FAQ 必须真实、可验证、可维护。
2. 结构化内容：关键页面优先包含一句话定义、核心摘要、适合人群、步骤、对比表、FAQ、检查清单。
docs/concepts/AGENTS.md
+1 -1
View File
@@ -29,4 +29,4 @@ concepts/
- 每个概念先说明它解决的问题。
- 尽量给出使用场景、判断标准和简单例子。
- 不确定的外部事实必须标注 TODO 或迁移到 `docs/research/`。
- 不确定的外部事实必须标注 TODO，或放入 `docs/research/` 等待验证。
docs/concepts/README.md
+1 -1
View File
@@ -8,7 +8,7 @@
- 本目录回答“先用什么概念理解问题”。
- 它不是操作教程，也不是工具清单，而是把 Vibe Coding 中反复出现的关键概念沉淀成稳定入口。
- 每个原独立文档都已并入本 README，并通过稳定锚点提供细粒度跳转。
- 本 README 提供稳定锚点和细粒度目录，作为核心概念的统一入口。
## 总目录
docs/getting-started/README.md
-2
View File
@@ -1,7 +1,5 @@
# 从零开始：Vibe Coding 完整入门教程
> 本文件合并原 `学习地图.md`、`Vibe Coding 经验.md`、`网络环境配置.md`、`CLI配置.md` 与 `开发环境搭建.md`，作为零基础到独立交付项目的线性入门版本。
## 核心摘要
这是一条面向新电脑和零基础用户的线性路线：先解决网络环境与 Codex / ChatGPT 订阅，再跑通 Codex CLI，随后让本地 Agent 主动检查和配置 Git、Node.js、Python、编辑器、项目依赖、测试命令和 Git 工作流。
docs/philosophy/README.md
+1 -7
View File
@@ -9,7 +9,7 @@
- 本目录回答“为什么这样判断、如何减少幻觉、如何让复杂问题可描述、可推理、可验证”。
- 它保留可迁移的认知模型和方法论，不放一次性命令、工具清单或新技术观察。
- 每个原独立文档都已并入本 README，并通过稳定锚点提供细粒度跳转。
- 本 README 提供稳定锚点和细粒度目录，作为哲学方法论的统一入口。
## 总目录
@@ -149,7 +149,6 @@
- [通用"性质测试"提示（可复用）](#philosophy-methodology-toolbox-通用性质测试提示可复用)
- [建议的项目框架（最小）](#philosophy-methodology-toolbox-建议的项目框架最小)
- [使用指南](#philosophy-methodology-toolbox-使用指南)
- [来源文档整合补充](#philosophy-methodology-toolbox-来源文档整合补充)
- [现象学还原用于 Vibe Coding](#philosophy-methodology-toolbox-现象学还原用于-vibe-coding)
- [辩证法用于 Vibe Coding：正反合](#philosophy-methodology-toolbox-辩证法用于-vibe-coding正反合)
- [控制论与科学方法论](#philosophy-methodology-toolbox-控制论与科学方法论)
@@ -1898,11 +1897,6 @@ README.md # 概念表/错误语义/验收指标
| 复杂系统 | 7（系统论）+ 21（计算哲学）+ 14（反思平衡） |
| 交互默认争议 | 20（x-phi）+ 6（实用主义指标） |
<a id="philosophy-methodology-toolbox-来源文档整合补充"></a>
### 来源文档整合补充
本节合并原 `现象学还原.md`、`辩证法.md` 与 `控制论与科学方法论.md` 的核心内容，作为哲学方法论的统一入口。
<a id="philosophy-methodology-toolbox-现象学还原用于-vibe-coding"></a>
#### 现象学还原用于 Vibe Coding
docs/references/README.md
+2 -18
View File
@@ -9,7 +9,7 @@
- 本目录回答“具体工程怎么组织、怎么选技术、怎么设置硬门禁”。
- 它承载稳定、可执行、可检查、可复用的工程参考资料。
- 每个原独立文档都已并入本 README，并通过稳定锚点提供细粒度跳转。
- 本 README 提供稳定锚点和细粒度目录，作为工程参考资料的统一入口。
## 常用入口
@@ -253,7 +253,7 @@
- 检查清单、模板、质量门禁和经验类内容优先收敛到本 README 的工程实践部分。
- 技术选型、技术栈组合和学习路径优先收敛到本 README 的技术栈部分。
- 新技术、工具趋势、优秀 repo 解析先放入 [research](../research/README.md)，稳定后再迁入本目录。
- 新技术、工具趋势、优秀 repo 解析先放入 [research](../research/README.md)，形成稳定工程参考后再放入本目录。
## 维护规则
@@ -273,8 +273,6 @@
> 项目架构、代码组织、开发经验、质量门禁与常见坑。
> 本文档合并原 `项目架构模板.md`、`代码组织.md`、`开发经验.md`、`底层程序逻辑设计与工程优化项.md` 与 `AI编程质量门禁与常见坑.md`，作为项目架构、代码组织、开发经验、底层程序逻辑、AI 编程质量门禁与常见坑的统一入口。
<a id="reference-engineering-practice-核心摘要"></a>
### 核心摘要
@@ -314,10 +312,6 @@
<a id="reference-engineering-practice-1-项目架构模板"></a>
### 1. 项目架构模板
> 来源：`项目架构模板.md`
> 本文档合并原 `通用项目架构模板.md` 与 `数据集导向数据服务模板.md`，用于新项目初始化、旧项目重组和数据采集服务架构设计。
<a id="reference-engineering-practice-1-使用原则"></a>
#### 1. 使用原则
@@ -966,8 +960,6 @@ temp/
<a id="reference-engineering-practice-2-代码组织"></a>
### 2. 代码组织
> 来源：`代码组织.md`
<a id="reference-engineering-practice-模块化编程"></a>
#### 模块化编程
@@ -1025,8 +1017,6 @@ temp/
<a id="reference-engineering-practice-3-开发经验"></a>
### 3. 开发经验
> 来源：`开发经验.md`
<a id="reference-engineering-practice-目录-2"></a>
#### 目录
@@ -1285,10 +1275,6 @@ Redis 的作用：
<a id="reference-engineering-practice-4-ai-编程质量门禁与常见坑"></a>
### 4. AI 编程质量门禁与常见坑
> 来源：`AI编程质量门禁与常见坑.md`
> 本文档合并原 `系统提示词构建原则.md`、`强前置条件约束.md` 与 `常见坑汇总.md`，用于统一约束 AI 编程行为、质量门禁与常见问题排查。
<a id="reference-engineering-practice-使用方式-2"></a>
#### 使用方式
@@ -3190,8 +3176,6 @@ git stash pop
<a id="reference-engineering-practice-5-底层程序逻辑设计与工程优化项"></a>
### 5. 底层程序逻辑设计与工程优化项
> 来源：`底层程序逻辑设计与工程优化项.md`
这一节是底层程序逻辑、运行模型、性能模型、并发模型、数据模型和工程交付优化的检查清单。用于代码实现、重构、性能排查和 AI 编程验收前的系统性自检。
```text
docs/research/AGENTS.md
+1 -1
View File
@@ -24,7 +24,7 @@ research/
- 每篇研究笔记聚焦一个技术、repo、范式或工具，并追加到 `README.md`。
- 不再新增同级主题 `.md` 文件；如确需拆分，必须同步更新全仓链接和 `metadata/redirects.yml`。
- 研究内容稳定后，可迁移到 `docs/concepts/`、`docs/references/` 或 `docs/philosophy/`。
- 研究内容稳定后，放入 `docs/concepts/`、`docs/references/` 或 `docs/philosophy/` 的对应章节。
- 外部项目、模型、工具、版本和事实状态可能变化，涉及最新信息时必须核验来源。
## 质量要求
docs/research/README.md
+4 -4
View File
@@ -8,7 +8,7 @@
- 本目录是“观察与判断区”。
- 内容还没有稳定到可以放入 `concepts/` 或 `references/`，但已经值得记录、分析和跟踪。
- 每个原独立研究笔记都已并入本 README，并通过稳定锚点提供细粒度跳转。
- 本 README 提供稳定锚点和细粒度目录，作为研究笔记的统一入口。
## 总目录
@@ -25,9 +25,9 @@
## 和其他目录的边界
- 稳定教程应迁入 `getting-started/` 或 `references/`。
- 核心概念应迁入 `concepts/`。
- 纯哲学模型应迁入 `philosophy/`。
- 稳定教程放入 `getting-started/` 或 `references/`。
- 核心概念放入 `concepts/`。
- 纯哲学模型放入 `philosophy/`。
## 维护规则
prompts/AGENTS.md
+1 -1
View File
@@ -2,7 +2,7 @@
## 目录用途
`prompts/` 提示词库入口，实际内容已迁移至云端表格。
`prompts/` 是提示词库入口，实际内容以云端表格为准。
## 在线资源
prompts/README.md
+1 -1
View File
@@ -1,6 +1,6 @@
# 💬 提示词库
提示词资源已迁移至云端表格，便于实时更新和协作编辑。
提示词资源以云端表格为统一入口，便于实时更新和协作编辑。
## 📋 在线提示词库
skills/README.md
+2 -2
View File
@@ -9,11 +9,11 @@
| [auto-skill](./auto-skill/SKILL.md) | 生成、重构与校验 Skills 的元技能 |
| [claude-official-skills](./claude-official-skills/) | Claude 官方 skills 仓库的软链接入口，事实来源在 `tools/external/claude-official-skills/` |
## 清理口径
## 维护口径
- `auto-skill/` 是本仓库的 Skill 生产与升级入口，继续保留。
- `claude-official-skills/` 是外部官方仓库展示入口，通过 submodule 管理事实来源。
- 领域型/工具型 Skill 如交易、数据库、代理、Telegram、tmux、EPUB 等已从主仓库清退；如需恢复，优先以独立仓库、submodule 或重新生成的方式引入。
- 领域型/工具型 Skill 如交易、数据库、代理、Telegram、tmux、EPUB 等不在主仓库维护；如需引入，优先使用独立仓库、submodule 或重新生成的方式。
## 外部技能仓库
skills/auto-skill/AGENTS.md
+2 -2
View File
@@ -40,7 +40,7 @@ auto-skill/
- `skills/auto-skill/scripts/skill-seekers-bootstrap.sh`: create a local venv and install deps for the linked Skill Seekers tool.
- `skills/auto-skill/scripts/skill-seekers.sh`: run Skill Seekers from the linked source (docs/github/pdf -> output/<name>/).
- `skills/auto-skill/scripts/skill-seekers-import.sh`: import output/<name>/ into the canonical skills/<name>/ tree.
- `skills/auto-skill/scripts/skill-seekers-update.sh`: legacy updater; guarded because the tool source now lives in `tools/external/`.
- `skills/auto-skill/scripts/skill-seekers-update.sh`: guarded update helper; do not use it to overwrite the linked source.
- `skills/auto-skill/scripts/validate-skill.sh`: spec validator (supports `--strict`).
- `skills/auto-skill/references/index.md`: navigation for this meta-skill's reference docs.
- `skills/auto-skill/references/README.md`: upstream official reference (lightly adjusted to keep links working in this repo).
@@ -53,5 +53,5 @@ auto-skill/
- `scripts/*.sh`: depend on `bash` + common POSIX tooling; some scripts require extra tooling:
- `skill-seekers-bootstrap.sh`: requires `python3` + `pip` (network required for PyPI).
- `skill-seekers-update.sh`: legacy helper; do not use it to overwrite the linked `tools/external/` source.
- `skill-seekers-update.sh`: guarded helper; do not use it to overwrite the linked `tools/external/` source.
- This directory is about "how to build Skills", not about any specific domain; domain knowledge belongs in `skills/<domain>/`.
skills/auto-skill/SKILL.md
+1 -1
View File
@@ -65,7 +65,7 @@ Import the generated skill into this repo's canonical `skills/` tree:
./skills/auto-skill/scripts/skill-seekers-import.sh react --force
```
Update the linked source by moving the `tools/external/Skill_Seekers-development` submodule pointer directly. The legacy updater is guarded to avoid overwriting the linked repository.
Update the linked source by moving the `tools/external/Skill_Seekers-development` submodule pointer directly. The update helper is guarded to avoid overwriting the linked repository.
```bash
./skills/auto-skill/scripts/skill-seekers-update.sh --dry-run
skills/auto-skill/references/skill-seekers.md
+1 -1
View File
@@ -8,7 +8,7 @@
- 运行入口：`skills/auto-skill/scripts/skill-seekers.sh`
- 依赖初始化：`skills/auto-skill/scripts/skill-seekers-bootstrap.sh`
- 导入到本仓库：`skills/auto-skill/scripts/skill-seekers-import.sh`
- 更新源码：直接更新 `tools/external/Skill_Seekers-development` submodule 指针；`skill-seekers-update.sh` 仅保留为受保护的旧入口。
- 更新源码：直接更新 `tools/external/Skill_Seekers-development` submodule 指针；`skill-seekers-update.sh` 是受保护的辅助入口，不能覆盖链接源码。
## 推荐工作流（强约束）
skills/auto-skill/scripts/skill-seekers-update.sh
+2 -2
View File
@@ -3,7 +3,7 @@
set -euo pipefail
# ==================== Purpose ====================
# Legacy updater for the old vendored Skill Seekers source snapshot.
# Guarded updater for the linked Skill Seekers source.
#
# Notes:
# - Skill Seekers now lives under tools/external/Skill_Seekers-development.
@@ -71,7 +71,7 @@ command -v tar >/dev/null 2>&1 || die "tar not found"
command -v rsync >/dev/null 2>&1 || die "rsync not found"
if [[ -L "$target_dir" && "$dry_run" -eq 0 ]]; then
die "Skill_Seekers-development is linked to tools/external. Update tools/external/Skill_Seekers-development directly instead of overwriting through this legacy updater."
die "Skill_Seekers-development is linked to tools/external. Update tools/external/Skill_Seekers-development directly instead of overwriting through this guarded helper."
fi
tmp_dir="$(mktemp -d)"
tools/README.md
+5 -5
View File
@@ -2,9 +2,9 @@
本目录存放辅助工具、转换器、外部工具镜像和工具配置。
迁移完成后：
## 当前结构
- `prompts-library` 归入 `tools/prompts-library/`
- `chat-vault` 归入 `tools/chat-vault/`
- 外部仓库归入 `tools/external/`
- Codex 等配置归入 `tools/config/`
- `tools/prompts-library/`：提示词 Excel ↔ Markdown 互转工具。
- `tools/chat-vault/`：AI 聊天记录保存工具。
- `tools/external/`：外部仓库、第三方工具与 submodule。
- `tools/config/`：Codex 等工具配置。
tools/external/README.md
Vendored
-6
View File
@@ -33,12 +33,6 @@ tools/external/
- `MCPlayerTransfer/`：MC 玩家迁移工具
- `XHS-image-to-PDF-conversion/`：图片合并 PDF 工具
## 相关迁移
- 提示词转换工具已迁移到 `tools/prompts-library/`。
- AI 聊天记录保存工具已迁移到 `tools/chat-vault/`。
- 技能库入口已迁移到 `skills/`。
## 当前源码表达状态
| 目录 | 当前表达 | 处理策略 |