mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-15 03:48:04 +00:00
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:
@@ -2,43 +2,63 @@
|
||||
|
||||
## 本轮结论
|
||||
|
||||
- 这是 Claude Code 生态资源索引,但比普通 awesome list 更工程化:有 CSV、data、resources、scripts、tests、templates。
|
||||
- 它的研究价值在资源登记、分类、生成/校验管线,而不只是链接数量。
|
||||
- 本仓应重点吸收其资源数据化和索引维护方式,用于强化 `assets/external-resources/`。
|
||||
`hesreallyhim/awesome-claude-code` 的核心价值不是链接多,而是把 Claude Code 生态资源做成可治理数据资产。
|
||||
它有 CSV 主表、动态数据、资源目录、脚本、测试和模板,已经从普通 awesome list 进化成资源登记系统。
|
||||
|
||||
本仓最应该迁移的是资源治理模型:外部资源必须有主表、字段契约、状态、最后检查时间、许可证、失效标记、
|
||||
生成/校验脚本和归档策略。
|
||||
|
||||
## 本地证据
|
||||
|
||||
- 研究对象:`hesreallyhim/awesome-claude-code`
|
||||
- 当前研究角色:Claude Code 生态索引
|
||||
- 本轮成熟度:L1 初步理解
|
||||
- 原始仓库:`raw/repository/`
|
||||
- 原始来源清单:`raw/sources.yml`
|
||||
- 事实摘要:`domain.yml`
|
||||
- 深度证据:`deep-dive.md`
|
||||
|
||||
## 结构观察
|
||||
## 对标拆解
|
||||
|
||||
- 根目录包含 `THE_RESOURCES_TABLE.csv`、`data/`、`resources/`、`scripts/`、`tests/`、`templates/`、`pyproject.toml`。
|
||||
- README 以 Awesome Claude Code 和 Table of Contents 为主入口。
|
||||
- 存在 `README_ALTERNATIVES/`,说明它关注不同展示形态。
|
||||
| 项 | 内容 |
|
||||
|:---|:---|
|
||||
| 参考对象 | `hesreallyhim/awesome-claude-code` |
|
||||
| 它解决的核心问题 | 让快速增长的 Claude Code 资源从链接堆变成可维护数据资产 |
|
||||
| 核心机制 | `THE_RESOURCES_TABLE.csv`、`data/`、`resources/`、`scripts/`、`tests/`、`templates/` |
|
||||
| 真正带来结果的动作 | 用结构化字段和校验脚本治理资源生命周期 |
|
||||
| 可迁移做法 | 资源 schema、active/stale/removed 状态、last_checked、license、release 字段 |
|
||||
| 不可迁移条件 | 不复制 Claude Code 生态分类,不让本仓变成泛 AI 资源大全 |
|
||||
| 下一步试用动作 | 为 `assets/external-resources/` 建字段契约和过期检查规则 |
|
||||
|
||||
## 可借鉴点
|
||||
## 改良迭代
|
||||
|
||||
- 资源不应只放 Markdown,应该有表格/数据源、生成脚本和测试。
|
||||
- 外部生态索引需要模板和校验来防止链接堆腐烂。
|
||||
- 适合对照本仓外部资源注册表的字段和质量门禁。
|
||||
| 改良目标 | 原模式 | 本仓版本 | 验证指标 |
|
||||
|:---|:---|:---|:---|
|
||||
| 资源事实源 | CSV 主表 | 本地资源注册表 + schema | 每个资源有 id、category、source、status、last_checked |
|
||||
| 生命周期治理 | active / stale / removed | active、stale、archived、removed | 过期资源能被脚本发现 |
|
||||
| 展示与治理分离 | templates 生成展示 | README 作为展示,数据文件作为事实源 | README 不再手写漂移 |
|
||||
|
||||
## 风险和边界
|
||||
## 可迁移清单
|
||||
|
||||
- 生态索引很宽,直接照搬会稀释本仓主线。
|
||||
- Claude Code 特有资源需要和 Codex/Cline/Aider 等工具中立视角区分。
|
||||
- 资源质量需要按 owner、维护状态和可验证性二次筛选。
|
||||
- 明确外部资源字段:ID、名称、分类、链接、作者、许可证、状态、最后检查时间、失效原因。
|
||||
- 增加资源生命周期状态,不再只有“存在/不存在”。
|
||||
- 把资源展示和资源事实源分离。
|
||||
- 用脚本检查重复 ID、缺字段、过期检查和非法分类。
|
||||
|
||||
## 下一轮研究任务
|
||||
## 不可迁移清单
|
||||
|
||||
- 研究 `THE_RESOURCES_TABLE.csv` 字段,映射到本仓 `assets/external-resources/` schema。
|
||||
- 阅读其 scripts/tests,判断哪些资源校验可复用。
|
||||
- 不复制 Claude Code 生态的具体分类体系。
|
||||
- 不把所有资源都升级成研究域;只有高价值资源才进入 research。
|
||||
- 不在 README 中手写所有资源事实。
|
||||
|
||||
## 验证动作
|
||||
|
||||
| 动作 | 成功信号 | 失败信号 |
|
||||
|:---|:---|:---|
|
||||
| 抽样 30 条本地资源做 schema 校验 | 能发现缺字段和过期资源 | 仍靠人工肉眼检查 |
|
||||
| 为资源增加生命周期状态 | stale/removed 能被识别 | 失效资源仍在 active 列表 |
|
||||
| 生成或校验展示索引 | 展示和事实源一致 | README 与数据源不一致 |
|
||||
|
||||
## 沉淀判断
|
||||
|
||||
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
|
||||
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
|
||||
- 稳定结论应进入 `assets/external-resources/`、`assets/AGENTS.md` 和资源校验脚本。
|
||||
- 这是 P1 资源治理对标对象,不只是 Claude Code 生态目录。
|
||||
|
||||
Reference in New Issue
Block a user