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
@@ -2,43 +2,63 @@
## 本轮结论
- 这是轻量级 awesome list,价值在于补充 Vibe Coding 工具和资料的横向发现,不适合作为方法论主线。
- 仓库本体几乎只有 `readme.md`,说明它的核心资产是人工维护的分类索引,而不是可运行系统。
- 更适合作为外部资源发现源和分类词表来源,后续应把稳定条目沉淀到 `assets/external-resources/`,而不是直接复制列表
`ai-for-developers/awesome-vibe-coding` 的核心价值不是深度判断,而是轻量资源雷达。它用一个
README 把 Web builder、IDE、移动工具、插件、本地应用和 CLI 工具粗分出来,适合帮助本仓发现
候选资源和分类词表。
本仓不能直接复制它的条目,因为它缺少结构化字段、状态、许可证、最后检查时间和采用风险。正确用法是:
把它作为 `assets/external-resources/` 的候选输入源,经过二次筛选后再进入本地资源注册表。
## 本地证据
- 研究对象:`ai-for-developers/awesome-vibe-coding`
- 当前研究角色:精选 Vibe Coding 资料清单
- 本轮成熟度:L1 初步理解
- 原始仓库:`raw/repository/`
- 原始来源清单:`raw/sources.yml`
- 事实摘要:`domain.yml`
## 结构观察
## 对标拆解
- 根目录只有 `readme.md`,没有脚本、测试、数据源或生成管线。
- README 以 Web-Based Builders、Editors and IDEs、Mobile Tools、Extensions & Plugins、Desktop & Local Apps、CLI Tools 等类别组织。
- 结构更偏资源目录,不承担工程实现、课程或 Agent 工作流定义。
| 项 | 内容 |
|:---|:---|
| 参考对象 | `ai-for-developers/awesome-vibe-coding` |
| 它解决的核心问题 | 快速发现 Vibe Coding 工具生态中的候选对象 |
| 核心机制 | 单 README 分类索引,按工具形态组织入口 |
| 真正带来结果的动作 | 用低成本分类让读者知道生态里有哪些工具族 |
| 可迁移做法 | 补充本仓资源分类、发现候选工具、观察工具族变化 |
| 不可迁移条件 | 不直接复制条目,不把 awesome list 当推荐结论 |
| 下一步试用动作 | 抽取分类词,与 `assets/external-resources/categories.yml` 做对照 |
## 可借鉴点
## 改良迭代
- 可借鉴它对 Vibe Coding 工具生态的分类标签,用于补充本仓外部资源注册表的 category 体系。
- 适合作为低频巡检对象:只提取新增高质量工具,不跟随每个条目做深度研究。
- 可用它校验本仓是否遗漏 Web builder、IDE、CLI、local app、plugin 等工具族。
| 改良目标 | 原模式 | 本仓版本 | 验证指标 |
|:---|:---|:---|:---|
| 资源发现 | README 手工分类 | 候选资源进入本地注册表前先二次筛选 | 新资源有 category、source、status、last_checked |
| 分类补齐 | Web / IDE / CLI 等工具族 | 本仓资源 category 增加缺失工具族 | 分类能覆盖 Web builder、IDE agent、CLI、plugin、local app |
| 候选升级 | 条目停留在列表 | 高价值条目升级为独立研究域 | 进入 P1/P2 候选必须有采用理由和风险 |
## 风险和边界
## 可迁移清单
- 没有机器可读数据源,质量依赖维护者手工更新
- 缺少采用判断和风险说明,不能直接作为推荐清单
- 条目多但深度浅,进入本仓前必须二次筛选
- 使用它补全 Vibe Coding 工具族分类
- 将条目作为资源候选,不作为最终推荐
- 对重复出现的工具族提取关键词,反馈到关键词系统
- 对高频出现的 coding agent、IDE agent、CLI 工具建立 P1/P2 研究候选。
## 下一轮研究任务
## 不可迁移清单
- 抽取其分类体系,与 `assets/external-resources/categories.yml` 做对照
- 只选择与 coding agent、CLI、IDE agent 强相关的条目进入深度研究候选
- 不复制整张 awesome list
- 不把没有许可证、维护状态和风险说明的条目放进推荐区
- 不把它当作学习路径或工程规范。
## 验证动作
| 动作 | 成功信号 | 失败信号 |
|:---|:---|:---|
| 抽取分类词并对照本仓资源分类 | 发现缺失分类并能补齐 | 分类无变化,只多一批链接 |
| 抽样 20 条资源做二次筛选 | 每条有采用/不采用理由 | 仍然只是链接搬运 |
| 挑出 3 个高价值工具进入候选研究 | 能说明为什么值得深挖 | 候选没有优先级和风险 |
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
- 稳定结果进入 `assets/external-resources/``metadata/taxonomy.yml`
- 本研究域保持 P3 低频雷达,不升级为方法论主线。