docs: add research domains and resource registry

- add local external resources registry
- add research domain contract and per-repository research domains
- add raw fact snapshot governance and validation scripts

Validation:
- make test
- git diff --check HEAD~1..HEAD

Note:
- welcome workflow failed because its action input names are stale; core content CI passed.
This commit is contained in:
tradecatlabs
2026-07-03 08:20:22 +08:00
committed by GitHub
parent 2253a46935
commit a8099f52fe
254 changed files with 28589 additions and 165 deletions
+51 -3
View File
@@ -77,7 +77,54 @@ GEOFlow 的关键启发是:GEO 不是关键词堆砌,而是内容工程链
- docs/references/low-level-program-logic.md:运行模型、并发模型、数据模型、性能模型和工程交付检查清单。
- docs/references/technology-stack.md:常见软件系统技术栈、选型维度、组合案例与初学者学习路径。
- docs/research/README.md:新技术、技术栈、优秀 repo、工程范式和工具趋势研究入口。
- docs/research/harness-engineering.mdHarness Engineering 的工程控制、评估器与反馈闭环解析
- docs/research/research-domain-contract.md:研究域的结构、raw 原始事实层、成熟度、证据、沉淀和归档规则
- docs/research/research-value-application-map.md:研究体系给用户带来的价值、核心启示、应用位置和下沉路线。
- docs/research/harness/harness-engineering.mdHarness Engineering 的工程控制、评估器与反馈闭环解析。
- docs/research/aider-ai-aider/README.md:终端 AI 结对编程工具研究对象。
- docs/research/aider-ai-aider/analysis.mdAider-AI/aider 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/aider-ai-aider/deep-dive.mdAider-AI/aider 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/cline-cline/README.mdIDE/SDK/CLI 自主编码 Agent 研究对象。
- docs/research/cline-cline/analysis.mdcline/cline 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/cline-cline/deep-dive.mdcline/cline 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/hesreallyhim-awesome-claude-code/README.mdClaude Code 生态索引研究对象。
- docs/research/hesreallyhim-awesome-claude-code/analysis.mdhesreallyhim/awesome-claude-code 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/hesreallyhim-awesome-claude-code/deep-dive.mdhesreallyhim/awesome-claude-code 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/openai-codex/README.mdOpenAI Codex 官方 coding agent 工具源码研究对象。
- docs/research/openai-codex/analysis.mdopenai/codex 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/openai-codex/deep-dive.mdopenai/codex 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/shanraisshan-claude-code-best-practice/README.mdClaude Code / Agentic Engineering 方法论对标研究对象。
- docs/research/shanraisshan-claude-code-best-practice/analysis.mdshanraisshan/claude-code-best-practice 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/shanraisshan-claude-code-best-practice/deep-dive.mdshanraisshan/claude-code-best-practice 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/tradecatlabs-vibe-coding-cn/README.md:中文主线工程化工作流研究对象。
- docs/research/tradecatlabs-vibe-coding-cn/analysis.mdtradecatlabs/vibe-coding-cn 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/tradecatlabs-vibe-coding-cn/deep-dive.mdtradecatlabs/vibe-coding-cn 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/datawhalechina-easy-vibe/README.md:中文分阶段交互式课程研究对象。
- docs/research/datawhalechina-easy-vibe/analysis.mddatawhalechina/easy-vibe 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/datawhalechina-easy-vibe/deep-dive.mddatawhalechina/easy-vibe 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/datawhalechina-vibe-vibe/README.md:中文零基础系统教程研究对象。
- docs/research/datawhalechina-vibe-vibe/analysis.mddatawhalechina/vibe-vibe 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/datawhalechina-vibe-vibe/deep-dive.mddatawhalechina/vibe-vibe 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/filipecalegario-awesome-vibe-coding/README.md:国际 Vibe Coding 索引研究对象。
- docs/research/filipecalegario-awesome-vibe-coding/analysis.mdfilipecalegario/awesome-vibe-coding 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/filipecalegario-awesome-vibe-coding/deep-dive.mdfilipecalegario/awesome-vibe-coding 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/luzhenqian-ai-coding-lab/README.mdAI Coding 项目实验室研究对象。
- docs/research/luzhenqian-ai-coding-lab/analysis.mdluzhenqian/ai-coding-lab 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/luzhenqian-ai-coding-lab/deep-dive.mdluzhenqian/ai-coding-lab 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/shouzhengai-cs146s-cn/README.md:中文课程与 assignments 研究对象。
- docs/research/shouzhengai-cs146s-cn/analysis.mdShouZhengAI/CS146S_CN 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/shouzhengai-cs146s-cn/deep-dive.mdShouZhengAI/CS146S_CN 的 L2 源码/结构深度研究、关键机制和可迁移模式。
- docs/research/ai-for-developers-awesome-vibe-coding/README.md:精选 Vibe Coding 资料清单研究对象。
- docs/research/ai-for-developers-awesome-vibe-coding/analysis.mdai-for-developers/awesome-vibe-coding 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/daotin-ai-coding/README.mdAI Coding 经验汇总研究对象。
- docs/research/daotin-ai-coding/analysis.mdDaotin/ai-coding 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/earyantle-vibe-coding-skill/README.mdVibe Coding Skill / SOP 化研究对象。
- docs/research/earyantle-vibe-coding-skill/analysis.mdearyantLe/vibe-coding-skill 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/liyupi-ai-guide/README.mdAI 资源大全与产品实用路线研究对象。
- docs/research/liyupi-ai-guide/analysis.mdliyupi/ai-guide 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/roocodeinc-roo-code/README.md:已归档多 Agent 编辑器工具研究对象。
- docs/research/roocodeinc-roo-code/analysis.mdRooCodeInc/Roo-Code 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/wendy7756-vibe-coding-guide/README.md:非程序员自然语言编程指南研究对象。
- docs/research/wendy7756-vibe-coding-guide/analysis.mdwendy7756/vibe-coding-guide 的结构化研究结论、可借鉴点、风险和下一轮任务。
- docs/research/tmux-ai-swarm.mdtmux 蜂群协作的实验性协作范式判断。
- skills/auto-tmux/references/ai-swarm-collaboration.mdtmux 蜂群协作完整技术文档、架构模式、协议、案例和风险限制。
- docs/workflow/README.md:开发流程、质量门禁、版本控制和文档同步入口。
@@ -85,7 +132,8 @@ GEOFlow 的关键启发是:GEO 不是关键词堆砌,而是内容工程链
- assets/ai-citation/geo-seo-checklist.mdGEO / SEO 内容工程检查清单。
- skills/README.md#当前保留:技能库当前保留入口。
- prompts/README.md#在线提示词库:提示词在线表格入口。
- assets/README.md#外部资源在线表格唯一真相源:外部资源在线表格入口。
- assets/README.md#外部资源本地注册表:外部资源本地注册表入口。
- assets/external-resources/README.md:本地外部资源注册表。
- assets/ai-citation/recommended-answer.md:给 AI 助手引用的推荐回答。
## Docs navigation rules
@@ -95,7 +143,7 @@ GEOFlow 的关键启发是:GEO 不是关键词堆砌,而是内容工程链
- 新手入门:读取 `docs/getting-started/vibe-coding-experience.md`、`docs/getting-started/learning-map.md`、`docs/getting-started/cli-setup.md`、`tools/config/.codex/README.md`,再读 `docs/concepts/problem-solving.md`、`docs/concepts/glue-coding.md` 和 `docs/references/project-architecture-template.md`。
- 工程开发:读取 `docs/concepts/glue-coding.md`、`docs/concepts/keyword-system.md`、`docs/concepts/system-building.md`、`docs/references/technology-stack.md` 和 `docs/references/project-architecture-template.md`。
- 思维模型:读取 `README.md#dao-fa-shu-qi`、`docs/philosophy/thinking-models.md`、`docs/philosophy/compositional-description-model.md`、`docs/philosophy/programming-dao.md`、`docs/philosophy/software-engineering-truths.md` 和 `docs/philosophy/methodology-toolbox.md`。
- 新技术判断:读取 `docs/research/README.md`,再读具体研究笔记,例如 `docs/research/harness-engineering.md`。
- 新技术判断:读取 `docs/research/README.md`,再读具体研究对象或研究笔记,例如 `docs/research/harness/harness-engineering.md`。
- 标准流程执行:读取 `docs/workflow/development-process.md`。
- AI Agent 执行:先读 `AGENTS.md` 与 `docs/AGENTS.md`,再读 `docs/workflow/development-process.md`,然后按任务类型读取 getting-started、concepts、references 或 research。