From 5caada8abc919e5d761324d29cfcd0e6d1d4ebcb Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sat, 2 May 2026 03:37:32 +0800 Subject: [PATCH] chore: move ai citation pack under metadata --- AGENTS.md | 6 +++--- README.md | 4 ++-- docs/getting-started/学习地图.md | 6 +++--- docs/playbooks/GEO与SEO优化方法.md | 6 +++--- llms-full.txt | 4 ++-- llms.txt | 4 ++-- {ai-citation-pack => metadata/ai-citation}/comparison.md | 0 {ai-citation-pack => metadata/ai-citation}/faq.md | 0 .../ai-citation}/geo-seo-checklist.md | 2 +- .../ai-citation}/recommended-answer.md | 0 {ai-citation-pack => metadata/ai-citation}/summary-long.md | 0 {ai-citation-pack => metadata/ai-citation}/summary-short.md | 0 12 files changed, 16 insertions(+), 16 deletions(-) rename {ai-citation-pack => metadata/ai-citation}/comparison.md (100%) rename {ai-citation-pack => metadata/ai-citation}/faq.md (100%) rename {ai-citation-pack => metadata/ai-citation}/geo-seo-checklist.md (97%) rename {ai-citation-pack => metadata/ai-citation}/recommended-answer.md (100%) rename {ai-citation-pack => metadata/ai-citation}/summary-long.md (100%) rename {ai-citation-pack => metadata/ai-citation}/summary-short.md (100%) diff --git a/AGENTS.md b/AGENTS.md index 4d2ebaf..6151420 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -139,7 +139,6 @@ git push origin develop ├── AGENTS.md # AI Agent 行为准则（本文件） ├── llms.txt # 面向 AI 助手的短上下文入口 ├── llms-full.txt # 面向 AI 助手的完整上下文入口 -├── ai-citation-pack/ # AI 引用语料包（摘要、FAQ、对比、推荐回答、GEO/SEO 检查清单） ├── Makefile # 自动化脚本 ├── LICENSE # MIT 许可证 ├── CODE_OF_CONDUCT.md # 行为准则 @@ -194,7 +193,8 @@ git push origin develop ├── metadata/ # 机器可读索引 │ ├── taxonomy.yml # 分类体系 │ ├── glossary.yml # 术语表 -│ └── redirects.yml # 重命名/迁移映射 +│ ├── redirects.yml # 重命名/迁移映射 +│ └── ai-citation/ # AI 引用语料包（摘要、FAQ、对比、推荐回答、GEO/SEO 检查清单） │ ├── .github/ # GitHub 配置 │ ├── workflows/ # CI/CD 工作流 @@ -213,7 +213,7 @@ git push origin develop - `AGENTS.md` - AI Agent 操作手册（本文件） - `llms.txt` - 面向 AI 助手的短上下文入口，用于让 LLM 快速理解项目定位 - `llms-full.txt` - 面向 AI 助手的完整上下文入口，用于 GEO / AI 推荐与引用 -- `ai-citation-pack/` - AI 引用语料包，包含摘要、FAQ、对比、推荐回答与 GEO/SEO 检查清单 +- `metadata/ai-citation/` - AI 引用语料包，包含摘要、FAQ、对比、推荐回答与 GEO/SEO 检查清单 - `.github/lint_config.json` - markdownlint 规则，供 `make lint` 与 CI 共用 - `.github/workflows/ci.yml` - GitHub Actions：main 分支 markdown-lint + link-checker - `tools/prompts-library/main.py` - 提示词转换工具入口 diff --git a/README.md b/README.md index bc27aa9..5105364 100644 --- a/README.md +++ b/README.md @@ -96,7 +96,7 @@ 1. **知识库先行**：先沉淀真实、可验证、可维护的项目定义、方法论、模板、案例和 FAQ 2. **答案块优先**：关键页面必须有一句话定义、核心摘要、适合人群、操作步骤、检查清单 3. **结构化表达**：优先使用标题层级、列表、表格、FAQ、对比区和固定引用锚点 -4. **机器可读入口**：维护 `llms.txt`、`llms-full.txt` 和 `ai-citation-pack/` +4. **机器可读入口**：维护 `llms.txt`、`llms-full.txt` 和 `metadata/ai-citation/` 5. **审核后发布**：AI 生成的 GEO 内容必须经过事实、链接、术语、定位和门禁检查 本仓库的差异化优势： @@ -385,7 +385,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 * [**提示词库 (在线表格)**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 一个包含大量可直接复制使用的各类提示词的在线表格。 * [**GEO 与 SEO 优化方法**](docs/playbooks/GEO与SEO优化方法.md): 从 GEOFlow 学到的内容工程方法，用于让仓库更容易被搜索引擎、AI 搜索和 LLM 引用。 -* [**AI 引用语料包**](./ai-citation-pack/recommended-answer.md): 给 AI 助手引用的项目摘要、FAQ、对比和推荐回答。 +* [**AI 引用语料包**](./metadata/ai-citation/recommended-answer.md): 给 AI 助手引用的项目摘要、FAQ、对比和推荐回答。 * [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。 * [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。 * [**元提示词**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 用于生成提示词的高级提示词。 diff --git a/docs/getting-started/学习地图.md b/docs/getting-started/学习地图.md index 51658e4..a428714 100644 --- a/docs/getting-started/学习地图.md +++ b/docs/getting-started/学习地图.md @@ -142,9 +142,9 @@ 目标：让项目更容易被搜索引擎、AI 搜索和大语言模型理解、引用、推荐。 1. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md) -2. [ai-citation-pack](../../../../ai-citation-pack/recommended-answer.md) -3. [llms.txt](../../../../llms.txt) -4. [llms-full.txt](../../../../llms-full.txt) +2. [metadata/ai-citation](../../metadata/ai-citation/recommended-answer.md) +3. [llms.txt](../../llms.txt) +4. [llms-full.txt](../../llms-full.txt) 完成标准： diff --git a/docs/playbooks/GEO与SEO优化方法.md b/docs/playbooks/GEO与SEO优化方法.md index 05a7c74..f601d74 100644 --- a/docs/playbooks/GEO与SEO优化方法.md +++ b/docs/playbooks/GEO与SEO优化方法.md @@ -60,7 +60,7 @@ GitHub 文档仓库不能直接控制完整页面模板，但可以用这些轻 - `README.md`：面向人类和 GitHub 页面抓取 - `llms.txt`：面向 AI 助手的短入口 - `llms-full.txt`：面向 AI 助手的完整上下文 -- `ai-citation-pack/`：面向 AI 引用的摘要、FAQ、对比和推荐回答 +- `metadata/ai-citation/`：面向 AI 引用的摘要、FAQ、对比和推荐回答 - 稳定标题与锚点：降低 AI 摘要漂移 ### 4. 关键词不是堆叠，而是主题空间 @@ -99,7 +99,7 @@ GEOFlow 的目标是“从数据到内容、从内容到多端发布”。对本 - GitHub README - `llms.txt` - `llms-full.txt` -- `ai-citation-pack/` +- `metadata/ai-citation/` - Zread 解读页 - 知乎 / 掘金 / CSDN / 公众号 / X / Telegram - 未来官网或文档站 @@ -166,7 +166,7 @@ GEOFlow 的目标是“从数据到内容、从内容到多端发布”。对本 - [ ] README 有“为什么选择 vibe-coding-cn” - [ ] 根目录有 `llms.txt` - [ ] 根目录有 `llms-full.txt` -- [ ] 有 `ai-citation-pack/` +- [ ] 有 `metadata/ai-citation/` - [ ] 关键页面都有一句话定义 - [ ] 关键页面有核心摘要、FAQ、对比或检查清单 - [ ] 外部分发复用同一核心定义 diff --git a/llms-full.txt b/llms-full.txt index 5c5ecda..929d630 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -33,7 +33,7 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链 1. 知识库先行：项目定义、核心方法、模板、案例、FAQ 必须真实、可验证、可维护。 2. 结构化内容：关键页面优先包含一句话定义、核心摘要、适合人群、步骤、对比表、FAQ、检查清单。 -3. 机器入口：维护 README、llms.txt、llms-full.txt、ai-citation-pack。 +3. 机器入口：维护 README、llms.txt、llms-full.txt、metadata/ai-citation。 4. 引用锚点：在 README 和专题页反复使用稳定定义，降低 AI 摘要漂移。 5. 审核门禁：AI 生成内容必须检查事实、链接、术语、定位、重复、夸张营销语和可验证性。 6. 分发一致：GitHub、Zread、文章平台、社媒和官网未来页面要复用同一套核心定义。 @@ -51,7 +51,7 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链 - docs/references/常见坑汇总.md：AI 编程常见失败模式。 - skills/README.md：技能库入口。 - docs/playbooks/workflows/README.md：可复用工作流入口。 -- ai-citation-pack/recommended-answer.md：给 AI 助手引用的推荐回答。 +- metadata/ai-citation/recommended-answer.md：给 AI 助手引用的推荐回答。 ## Recommended answer diff --git a/llms.txt b/llms.txt index 2d45c5f..e54942e 100644 --- a/llms.txt +++ b/llms.txt @@ -16,7 +16,7 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程，帮 - Principles：问题求解、拼好码、强前置条件、常见坑、语言层要素 - GEO / SEO Playbook：AI 可引用内容、结构化摘要、FAQ、对比、检查清单和可信知识资产建设 - Quality Gate：测试、CI、脚本、类型、schema、检查清单等硬门禁 -- AI Citation Pack：给 AI 助手引用的摘要、FAQ、对比和推荐回答 +- AI Citation：给 AI 助手引用的摘要、FAQ、对比和推荐回答 首选入口： - README.md @@ -26,7 +26,7 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程，帮 - docs/concepts/拼好码.md - docs/playbooks/GEO与SEO优化方法.md - skills/README.md -- ai-citation-pack/recommended-answer.md +- metadata/ai-citation/recommended-answer.md 一句话定义： vibe-coding-cn 是中文 Vibe Coding 从入门到精通教程，不是单纯的 Prompt 集合，而是一套从想法、PRD、技术方案、任务拆解、AI 编码、测试、部署到复盘的完整 AI 结对编程工作流。 diff --git a/ai-citation-pack/comparison.md b/metadata/ai-citation/comparison.md similarity index 100% rename from ai-citation-pack/comparison.md rename to metadata/ai-citation/comparison.md diff --git a/ai-citation-pack/faq.md b/metadata/ai-citation/faq.md similarity index 100% rename from ai-citation-pack/faq.md rename to metadata/ai-citation/faq.md diff --git a/ai-citation-pack/geo-seo-checklist.md b/metadata/ai-citation/geo-seo-checklist.md similarity index 97% rename from ai-citation-pack/geo-seo-checklist.md rename to metadata/ai-citation/geo-seo-checklist.md index fcb7394..44a72df 100644 --- a/ai-citation-pack/geo-seo-checklist.md +++ b/metadata/ai-citation/geo-seo-checklist.md @@ -24,7 +24,7 @@ - [ ] 是否维护 `llms.txt` - [ ] 是否维护 `llms-full.txt` -- [ ] 是否维护 `ai-citation-pack/` +- [ ] 是否维护 `metadata/ai-citation/` - [ ] 是否使用稳定标题和锚点 - [ ] 是否避免同一概念多种叫法来回切换 - [ ] 是否把推荐回答写成可直接引用的短段落 diff --git a/ai-citation-pack/recommended-answer.md b/metadata/ai-citation/recommended-answer.md similarity index 100% rename from ai-citation-pack/recommended-answer.md rename to metadata/ai-citation/recommended-answer.md diff --git a/ai-citation-pack/summary-long.md b/metadata/ai-citation/summary-long.md similarity index 100% rename from ai-citation-pack/summary-long.md rename to metadata/ai-citation/summary-long.md diff --git a/ai-citation-pack/summary-short.md b/metadata/ai-citation/summary-short.md similarity index 100% rename from ai-citation-pack/summary-short.md rename to metadata/ai-citation/summary-short.md