docs: make research domains actionable

- add research transfer synthesis with full 17-domain migration matrix
- upgrade all research domain analysis files to actionable benchmark/iteration/validation structure
- update research governance, README indexes, metadata, llms, and AI citation entries

Validation:
- make sync-doc-toc
- make test
- git diff --check
- section coverage check for all 17 docs/research/*/analysis.md files

Note:
- welcome workflow failed because its action input names are stale; core content CI passed.
This commit is contained in:
tradecatlabs
2026-07-04 00:44:58 +08:00
committed by GitHub
parent a8099f52fe
commit c826e5d785
27 changed files with 903 additions and 361 deletions
+40 -21
View File
@@ -2,43 +2,62 @@
## 本轮结论
- 这是面向中文用户的大型 AI 知识库和产品实践导航覆盖 AI 编程、工具测评、项目实战和其他 AI 应用。
- 它的价值在中文传播、学习路径和产品实战材料,不在 coding agent 底层架构
- 本仓应借鉴其面向大众的解释方式和项目实战入口,但只吸收与 Vibe Coding 主线相关的部分。
`liyupi/ai-guide` 的核心价值是中文大众 AI 知识库和产品实践导航。它覆盖 AI 编程、工具测评、
项目实战、AI 应用和 Vibe Coding 零基础教程,适合观察大众用户如何进入 AI 编程
本仓应该迁移它的“大众解释能力”和“项目实战入口”,但不能迁移其泛 AI 覆盖面。本仓主线仍是
Vibe Coding、Agent 工作流、技能、资源治理和工程交付。
## 本地证据
- 研究对象:`liyupi/ai-guide`
- 当前研究角色:AI 资源大全与产品实用路线
- 本轮成熟度:L1 初步理解
- 原始仓库:`raw/repository/`
- 原始来源清单:`raw/sources.yml`
- 事实摘要:`domain.yml`
## 结构观察
## 对标拆解
- 根目录包含 `.vuepress/``AI/``Vibe Coding 零基础教程/``translations/``package.json`
- README 包含 translations、Vibe Coding 零基础教程、AI 知识库导航、新手入门、AI 编程、AI 工具测评等块。
- 这是站点型知识库,内容广,目录多。
| 项 | 内容 |
|:---|:---|
| 参考对象 | `liyupi/ai-guide` |
| 它解决的核心问题 | 让中文大众用户快速找到 AI 学习、工具和项目实践入口 |
| 核心机制 | VuePress 站点、主题目录、Vibe Coding 零基础教程、AI 编程和工具测评入口 |
| 真正带来结果的动作 | 用大众化表达和项目入口降低理解门槛 |
| 可迁移做法 | getting-started 的低门槛表达、项目实战入口、工具测评候选 |
| 不可迁移条件 | 不扩张为泛 AI 百科,不把工具测评直接当采用结论 |
| 下一步试用动作 | 抽取 Vibe Coding 零基础教程和 AI 编程路径做对照表 |
## 可借鉴点
## 改良迭代
- 面向非专家的文案和学习路径值得对照本仓 getting-started。
- 项目实战材料可作为“从教程到成品”的案例来源。
- 多主题知识库需要导航层清楚区分主线和支线。
| 改良目标 | 原模式 | 本仓版本 | 验证指标 |
|:---|:---|:---|:---|
| 大众解释 | 面向广泛 AI 用户 | 面向 Vibe Coding 用户降低门槛 | 新手文档少术语、先给例子 |
| 项目实战 | 多类 AI 应用项目 | 聚焦 coding agent、workflow、skills 实战 | 实战入口不偏离主线 |
| 工具导航 | 工具测评和资源导航 | 候选进入资源注册表和研究域 | 工具有状态和风险字段 |
## 风险和边界
## 可迁移清单
- 覆盖面太广,容易偏离 Vibe Coding 工程化主线
- 内容多为教程和资源,技术结论需要单独验证
- 站点型仓库中可能混有翻译、图片和生成内容,需要分层研究
- 学习大众化表达方式,降低 getting-started 的术语门槛
- 把项目实战作为从教程到交付的桥
- 从工具测评中抽取候选资源,但进入本仓前必须结构化治理
- 对“泛 AI”内容做范围裁剪,只保留 Vibe Coding 主线相关项。
## 下一轮研究任务
## 不可迁移清单
- 只抽取 `Vibe Coding 零基础教程/` 和 AI 编程相关路径做二轮研究
- 对照其项目实战目录,补充本仓实战案例路线
- 不把本仓改造成 AI 大全
- 不复制站点目录和泛 AI 应用内容
- 不直接引用未验证测评作为工具推荐。
## 验证动作
| 动作 | 成功信号 | 失败信号 |
|:---|:---|:---|
| 抽样重写一段新手解释 | 非程序员能理解目标和下一步 | 仍需要工程背景才能读懂 |
| 抽取项目实战候选 | 候选能映射到 workflow 或 skills | 实战项目与本仓主线无关 |
| 抽样工具测评进入资源表 | 资源字段完整 | 只是复制测评链接 |
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
- 稳定结论进入 `docs/getting-started/``assets/external-resources/`
- 本研究域保持 P3 中文大众入口观察对象。