diff --git a/.github/WIKI.md b/.github/WIKI.md index fe99861..29ec0bf 100644 --- a/.github/WIKI.md +++ b/.github/WIKI.md @@ -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/` 的对应线性总文档。 diff --git a/assets/ai-citation/README.md b/assets/ai-citation/README.md index a770bc7..727c0f3 100644 --- a/assets/ai-citation/README.md +++ b/assets/ai-citation/README.md @@ -12,7 +12,7 @@ | `recommended-answer.md` | 推荐回答模板 | | `geo-seo-checklist.md` | GEO / SEO 检查清单 | -根目录保留 `llms.txt` 作为短入口；完整语料统一归入本目录。 +根目录 `llms.txt` 是短入口；本目录存放完整语料。 ## 知识库入口 diff --git a/assets/ai-citation/llms-full.txt b/assets/ai-citation/llms-full.txt index 26de9eb..5d403e5 100644 --- a/assets/ai-citation/llms-full.txt +++ b/assets/ai-citation/llms-full.txt @@ -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、检查清单。 diff --git a/docs/concepts/AGENTS.md b/docs/concepts/AGENTS.md index c64cd77..f8cd7a2 100644 --- a/docs/concepts/AGENTS.md +++ b/docs/concepts/AGENTS.md @@ -29,4 +29,4 @@ concepts/ - 每个概念先说明它解决的问题。 - 尽量给出使用场景、判断标准和简单例子。 -- 不确定的外部事实必须标注 TODO 或迁移到 `docs/research/`。 +- 不确定的外部事实必须标注 TODO，或放入 `docs/research/` 等待验证。 diff --git a/docs/concepts/README.md b/docs/concepts/README.md index 4611767..efaa2d1 100644 --- a/docs/concepts/README.md +++ b/docs/concepts/README.md @@ -8,7 +8,7 @@ - 本目录回答“先用什么概念理解问题”。 - 它不是操作教程，也不是工具清单，而是把 Vibe Coding 中反复出现的关键概念沉淀成稳定入口。 -- 每个原独立文档都已并入本 README，并通过稳定锚点提供细粒度跳转。 +- 本 README 提供稳定锚点和细粒度目录，作为核心概念的统一入口。 ## 总目录 diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md index e27c597..480e62b 100644 --- a/docs/getting-started/README.md +++ b/docs/getting-started/README.md @@ -1,7 +1,5 @@ # 从零开始：Vibe Coding 完整入门教程 -> 本文件合并原 `学习地图.md`、`Vibe Coding 经验.md`、`网络环境配置.md`、`CLI配置.md` 与 `开发环境搭建.md`，作为零基础到独立交付项目的线性入门版本。 - ## 核心摘要 这是一条面向新电脑和零基础用户的线性路线：先解决网络环境与 Codex / ChatGPT 订阅，再跑通 Codex CLI，随后让本地 Agent 主动检查和配置 Git、Node.js、Python、编辑器、项目依赖、测试命令和 Git 工作流。 diff --git a/docs/philosophy/README.md b/docs/philosophy/README.md index 7aa1a8c..5ae3cb2 100644 --- a/docs/philosophy/README.md +++ b/docs/philosophy/README.md @@ -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（实用主义指标） | - -### 来源文档整合补充 - -本节合并原 `现象学还原.md`、`辩证法.md` 与 `控制论与科学方法论.md` 的核心内容，作为哲学方法论的统一入口。 - #### 现象学还原用于 Vibe Coding diff --git a/docs/references/README.md b/docs/references/README.md index e24a517..8998d30 100644 --- a/docs/references/README.md +++ b/docs/references/README.md @@ -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 编程质量门禁与常见坑的统一入口。 - ### 核心摘要 @@ -314,10 +312,6 @@ ### 1. 项目架构模板 -> 来源：`项目架构模板.md` - -> 本文档合并原 `通用项目架构模板.md` 与 `数据集导向数据服务模板.md`，用于新项目初始化、旧项目重组和数据采集服务架构设计。 - #### 1. 使用原则 @@ -966,8 +960,6 @@ temp/ ### 2. 代码组织 -> 来源：`代码组织.md` - #### 模块化编程 @@ -1025,8 +1017,6 @@ temp/ ### 3. 开发经验 -> 来源：`开发经验.md` - #### 目录 @@ -1285,10 +1275,6 @@ Redis 的作用： ### 4. AI 编程质量门禁与常见坑 -> 来源：`AI编程质量门禁与常见坑.md` - -> 本文档合并原 `系统提示词构建原则.md`、`强前置条件约束.md` 与 `常见坑汇总.md`，用于统一约束 AI 编程行为、质量门禁与常见问题排查。 - #### 使用方式 @@ -3190,8 +3176,6 @@ git stash pop ### 5. 底层程序逻辑设计与工程优化项 -> 来源：`底层程序逻辑设计与工程优化项.md` - 这一节是底层程序逻辑、运行模型、性能模型、并发模型、数据模型和工程交付优化的检查清单。用于代码实现、重构、性能排查和 AI 编程验收前的系统性自检。 ```text diff --git a/docs/research/AGENTS.md b/docs/research/AGENTS.md index f1b59c9..bbe0a73 100644 --- a/docs/research/AGENTS.md +++ b/docs/research/AGENTS.md @@ -24,7 +24,7 @@ research/ - 每篇研究笔记聚焦一个技术、repo、范式或工具，并追加到 `README.md`。 - 不再新增同级主题 `.md` 文件；如确需拆分，必须同步更新全仓链接和 `metadata/redirects.yml`。 -- 研究内容稳定后，可迁移到 `docs/concepts/`、`docs/references/` 或 `docs/philosophy/`。 +- 研究内容稳定后，放入 `docs/concepts/`、`docs/references/` 或 `docs/philosophy/` 的对应章节。 - 外部项目、模型、工具、版本和事实状态可能变化，涉及最新信息时必须核验来源。 ## 质量要求 diff --git a/docs/research/README.md b/docs/research/README.md index 0a21d54..6d99846 100644 --- a/docs/research/README.md +++ b/docs/research/README.md @@ -8,7 +8,7 @@ - 本目录是“观察与判断区”。 - 内容还没有稳定到可以放入 `concepts/` 或 `references/`，但已经值得记录、分析和跟踪。 -- 每个原独立研究笔记都已并入本 README，并通过稳定锚点提供细粒度跳转。 +- 本 README 提供稳定锚点和细粒度目录，作为研究笔记的统一入口。 ## 总目录 @@ -25,9 +25,9 @@ ## 和其他目录的边界 -- 稳定教程应迁入 `getting-started/` 或 `references/`。 -- 核心概念应迁入 `concepts/`。 -- 纯哲学模型应迁入 `philosophy/`。 +- 稳定教程放入 `getting-started/` 或 `references/`。 +- 核心概念放入 `concepts/`。 +- 纯哲学模型放入 `philosophy/`。 ## 维护规则 diff --git a/prompts/AGENTS.md b/prompts/AGENTS.md index 7b5ae2f..91e1902 100644 --- a/prompts/AGENTS.md +++ b/prompts/AGENTS.md @@ -2,7 +2,7 @@ ## 目录用途 -`prompts/` 提示词库入口，实际内容已迁移至云端表格。 +`prompts/` 是提示词库入口，实际内容以云端表格为准。 ## 在线资源 diff --git a/prompts/README.md b/prompts/README.md index 840181a..8055c15 100644 --- a/prompts/README.md +++ b/prompts/README.md @@ -1,6 +1,6 @@ # 💬 提示词库 -提示词资源已迁移至云端表格，便于实时更新和协作编辑。 +提示词资源以云端表格为统一入口，便于实时更新和协作编辑。 ## 📋 在线提示词库 diff --git a/skills/README.md b/skills/README.md index 1a79bf7..14a08a5 100644 --- a/skills/README.md +++ b/skills/README.md @@ -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 或重新生成的方式。 ## 外部技能仓库 diff --git a/skills/auto-skill/AGENTS.md b/skills/auto-skill/AGENTS.md index 2b3bf7d..1fb63ef 100644 --- a/skills/auto-skill/AGENTS.md +++ b/skills/auto-skill/AGENTS.md @@ -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//). - `skills/auto-skill/scripts/skill-seekers-import.sh`: import output// into the canonical skills// 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//`. diff --git a/skills/auto-skill/SKILL.md b/skills/auto-skill/SKILL.md index 0da36e7..42f7534 100644 --- a/skills/auto-skill/SKILL.md +++ b/skills/auto-skill/SKILL.md @@ -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 diff --git a/skills/auto-skill/references/skill-seekers.md b/skills/auto-skill/references/skill-seekers.md index a36f127..d16166a 100644 --- a/skills/auto-skill/references/skill-seekers.md +++ b/skills/auto-skill/references/skill-seekers.md @@ -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` 是受保护的辅助入口，不能覆盖链接源码。 ## 推荐工作流（强约束） diff --git a/skills/auto-skill/scripts/skill-seekers-update.sh b/skills/auto-skill/scripts/skill-seekers-update.sh index bd63317..0bc8033 100755 --- a/skills/auto-skill/scripts/skill-seekers-update.sh +++ b/skills/auto-skill/scripts/skill-seekers-update.sh @@ -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)" diff --git a/tools/README.md b/tools/README.md index a594a58..60f66ea 100644 --- a/tools/README.md +++ b/tools/README.md @@ -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 等工具配置。 diff --git a/tools/external/README.md b/tools/external/README.md index 31d41c0..70f43f3 100644 --- a/tools/external/README.md +++ b/tools/external/README.md @@ -33,12 +33,6 @@ tools/external/ - `MCPlayerTransfer/`：MC 玩家迁移工具 - `XHS-image-to-PDF-conversion/`：图片合并 PDF 工具 -## 相关迁移 - -- 提示词转换工具已迁移到 `tools/prompts-library/`。 -- AI 聊天记录保存工具已迁移到 `tools/chat-vault/`。 -- 技能库入口已迁移到 `skills/`。 - ## 当前源码表达状态 | 目录 | 当前表达 | 处理策略 |