mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-07-27 18:57:50 +00:00
tradecatlabs
f1f0b9fe75
Move the complete research domain from docs/research to root-level research, update indexes and path-aware tooling, and align raw snapshot governance and CODEOWNERS.\n\nVerified with make test and GitHub CI.
357 lines
19 KiB
YAML
357 lines
19 KiB
YAML
sections:
|
|
getting-started:
|
|
path: docs/getting-started
|
|
purpose: 从零开始学习路径、学习地图、环境配置与 AI CLI 配置
|
|
entry: docs/getting-started/README.md
|
|
agent_guide: docs/getting-started/AGENTS.md
|
|
concepts:
|
|
path: docs/concepts
|
|
purpose: 核心概念、问题求解、关键词系统与工程思想
|
|
entry: docs/concepts/README.md
|
|
agent_guide: docs/concepts/AGENTS.md
|
|
philosophy:
|
|
path: docs/philosophy
|
|
purpose: 哲学方法论、思维模型、编程哲学与底层认知模型
|
|
entry: docs/philosophy/README.md
|
|
agent_guide: docs/philosophy/AGENTS.md
|
|
research:
|
|
path: research
|
|
purpose: 新技术、技术栈、优秀 repo、工程范式和工具趋势的短篇研究
|
|
entry: research/README.md
|
|
agent_guide: research/AGENTS.md
|
|
workflow:
|
|
path: docs/workflow
|
|
purpose: 开发流程、质量门禁、版本控制和文档同步的执行顺序
|
|
entry: docs/workflow/README.md
|
|
agent_guide: docs/workflow/AGENTS.md
|
|
references:
|
|
path: docs/references
|
|
purpose: 清单、模板、强约束与常见坑
|
|
entry: docs/references/README.md
|
|
agent_guide: docs/references/AGENTS.md
|
|
reading_paths:
|
|
beginner:
|
|
title: 新手路径
|
|
documents:
|
|
- docs/getting-started/README.md
|
|
- docs/getting-started/vibe-coding-experience.md
|
|
- docs/getting-started/learning-map.md
|
|
- docs/concepts/problem-solving.md
|
|
- docs/concepts/glue-coding.md
|
|
- docs/references/project-architecture-template.md
|
|
- docs/references/quality-gates-and-pitfalls.md
|
|
developer:
|
|
title: 开发者路径
|
|
documents:
|
|
- 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
|
|
- docs/references/quality-gates-and-pitfalls.md
|
|
thinking:
|
|
title: 思维模型路径
|
|
documents:
|
|
- docs/philosophy/thinking-models.md
|
|
- docs/philosophy/compositional-description-model.md
|
|
- docs/philosophy/programming-dao.md
|
|
- docs/philosophy/software-engineering-truths.md
|
|
- docs/concepts/recursive-self-optimizing-system.md
|
|
agent:
|
|
title: AI Agent 读取路径
|
|
documents:
|
|
- AGENTS.md
|
|
- docs/AGENTS.md
|
|
- docs/workflow/development-process.md
|
|
- docs/getting-started/README.md
|
|
- docs/getting-started/vibe-coding-experience.md
|
|
- docs/references/project-architecture-template.md
|
|
- docs/references/quality-gates-and-pitfalls.md
|
|
- assets/ai-citation/README.md
|
|
selection_rules:
|
|
concepts: 需要理解核心概念、术语、问题求解、系统构建或复用优先原则时读取。
|
|
philosophy: 需要思维模型、底层认知框架、编程哲学或复杂系统描述方法时读取。
|
|
references: 需要工程模板、质量门禁、技术栈、常见坑和可执行检查清单时读取。
|
|
research: 需要新技术、新 repo、工程趋势和采用前判断时读取。
|
|
workflow: 需要标准开发顺序、质量门禁、版本控制和文档同步流程时读取。
|
|
getting-started: 需要从零开始配置网络、Codex CLI、开发环境并完成最小闭环时读取。
|
|
documents:
|
|
getting-started:
|
|
- path: docs/getting-started/vibe-coding-experience.md
|
|
title: Vibe Coding 经验
|
|
role: 通用语言能力、人机分工、机器门禁和入门铁律
|
|
- path: docs/getting-started/learning-map.md
|
|
title: 学习地图
|
|
role: 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择
|
|
- path: docs/getting-started/network-environment.md
|
|
title: 网络环境配置
|
|
role: OpenAI、GitHub、文档和依赖源访问
|
|
- path: docs/getting-started/cli-setup.md
|
|
title: CLI 配置
|
|
role: Codex CLI 默认路线与 OpenCode 备选路线
|
|
- path: docs/getting-started/development-environment.md
|
|
title: 开发环境搭建
|
|
role: Agent 主动配置开发依赖、编辑器建议和测试命令
|
|
concepts:
|
|
- path: docs/concepts/problem-solving.md
|
|
title: 问题求解
|
|
role: 目标、现状、差距、标准、约束、对象与路径
|
|
- path: docs/concepts/glue-coding.md
|
|
title: 拼好码
|
|
role: 复用成熟能力、胶水原则、能力编排与业务交付
|
|
- path: docs/concepts/system-building.md
|
|
title: 系统构建方法
|
|
role: 自顶向下、自底向上与分而治之
|
|
- path: docs/concepts/development-paradigms.md
|
|
title: 开发范式演进
|
|
role: 软件工程组织方式演进
|
|
- path: docs/concepts/language-layers.md
|
|
title: 语言层要素
|
|
role: 代码理解所需语言层级
|
|
- path: docs/concepts/keyword-system.md
|
|
title: 关键词系统
|
|
role: Vibe Coding 与工程协作中的高频关键词
|
|
- path: docs/concepts/recursive-self-optimizing-system.md
|
|
title: 递归自优化系统
|
|
role: 递归自优化生成系统的形式化模型
|
|
philosophy:
|
|
- path: docs/philosophy/thinking-models.md
|
|
title: 思维模型
|
|
role: 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具
|
|
- path: docs/philosophy/compositional-description-model.md
|
|
title: 组合描述模型
|
|
role: 对象、状态、快照、序列、过程、变换、同一/差异与关系
|
|
- path: docs/philosophy/programming-dao.md
|
|
title: 编程之道
|
|
role: 编程哲学、结构、状态、复杂度与工程判断
|
|
- path: docs/philosophy/software-engineering-truths.md
|
|
title: 软件工程的朴素真理
|
|
role: 代码、复杂度、需求、维护、质量、架构和团队的工程常识
|
|
- path: docs/philosophy/methodology-toolbox.md
|
|
title: 方法论工具箱
|
|
role: 现象学还原、正反合、可证伪主义、形式化方法等提效工具
|
|
references:
|
|
- path: docs/references/project-architecture-template.md
|
|
title: 项目架构模板
|
|
role: 常见项目结构、架构设计原则、最低门禁和检查清单
|
|
- path: docs/references/python-project-skeleton.md
|
|
title: 通用 Python 项目骨架
|
|
role: Python 应用、服务、脚本工具和库项目的通用骨架
|
|
- path: docs/references/enterprise-architecture-template.md
|
|
title: 企业级 Monorepo / Multi-repo 架构模板
|
|
role: 中大型工程组织、平台工程和多产品线参考模型
|
|
- path: docs/references/modern-enterprise-architecture-template.md
|
|
title: 现代企业数字化平台架构
|
|
role: 面向领域产品网络、微服务容器 GitOps 边界、AI 原生能力、微调治理、AI 事件响应、内部平台、数据产品、供应链安全、FinOps 成本治理、版本治理、版本控制面、基线版本策略、发布通道、兼容性与冻结控制总账、基线生产变更、发布编排、变更冲突与失败恢复总账、基线事故、问题、纠正行动与复发防止总账、基线数据产品质量、契约违约、运行血缘与可观测性总账、基线工程质量、测试证据、缺陷与发布验证总账、基线人员能力、培训、职责履职与职责分离总账、基线业务结果、价值实现与组合收益总账、基线价值流、关键旅程与端到端流程总账、基线架构视图、运行拓扑与依赖影响总账、基线质量属性、架构驱动与权衡决策总账、基线架构原则、约束、反模式与例外执行总账、基线安全配置、加固姿态与配置漂移修复总账、基线漏洞、暴露面与修复验证总账、基线威胁建模、攻击面与安全风险总账、基线容量、性能、弹性伸缩与成本效率总账、基线服务可靠性、SLO、错误预算与可观测性总账、基线备份、恢复、灾备与可恢复性验证总账、基线密码材料、密钥、证书与秘密生命周期总账、基线资产关键性、数据分类与风险分级总账、基线身份权限、特权访问与工作负载身份总账、基线处理活动、个人数据清单与
|
|
RoPA 覆盖总账、基线隐私权利请求、同意偏好与合法基础执行总账、基线记录留存、法律保全与可防御删除总账、基线监管与合规义务可追溯总账、外部标准版本锁定、可执行标准、执行控制面、门禁决策、RACI 决策权、可靠性分级、仓库拓扑、迁移弃用、审计证据、联邦治理和行业对标矩阵的完整说明文档
|
|
- path: docs/references/common-sense.md
|
|
title: 常识
|
|
role: AI 编程和工程交付前的最低判断线
|
|
- path: docs/references/dataset-first-data-service.md
|
|
title: Dataset First 数据服务结构
|
|
role: dataset、contract、registry、runtime 为核心的数据服务模板
|
|
- path: docs/references/code-organization.md
|
|
title: 代码组织
|
|
role: 模块化、命名、注释、格式化、文档和工具
|
|
- path: docs/references/development-experience.md
|
|
title: 开发经验
|
|
role: 变量名、文件结构、编码规范、架构原则和常见基础设施经验
|
|
- path: docs/references/quality-gates-and-pitfalls.md
|
|
title: AI 编程质量门禁与常见坑
|
|
role: 系统提示词、强前置条件、常见坑和硬门禁
|
|
- path: docs/references/low-level-program-logic.md
|
|
title: 底层程序逻辑设计与工程优化项
|
|
role: 运行模型、并发模型、数据模型、性能模型和工程交付检查清单
|
|
- path: docs/references/technology-stack.md
|
|
title: 技术栈
|
|
role: 技术栈选型、组合案例与学习路径
|
|
research:
|
|
- path: research/research-domain-contract.md
|
|
title: 研究域治理契约
|
|
role: 研究域的结构、raw 原始事实层、成熟度、证据、沉淀和归档规则
|
|
- path: research/research-value-application-map.md
|
|
title: 研究价值与应用地图
|
|
role: 研究体系给用户带来的价值、核心启示、应用位置和下沉路线
|
|
- path: research/research-transfer-synthesis.md
|
|
title: 研究迁移综合
|
|
role: 将对标拆解、改良迭代和杂交创新转成可执行研究路线
|
|
- path: research/harness/README.md
|
|
title: Harness 研究对象
|
|
role: 工程控制、评估器、反馈闭环与 AI 生成系统可靠性研究对象
|
|
- path: research/harness/harness-engineering.md
|
|
title: Harness 工程解析
|
|
role: 工程控制、评估器、反馈闭环与 AI 生成系统可靠性
|
|
- path: research/aider-ai-aider/README.md
|
|
title: Aider-AI/aider 研究域
|
|
role: 终端 AI 结对编程工具
|
|
- path: research/aider-ai-aider/analysis.md
|
|
title: Aider-AI/aider 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/aider-ai-aider/deep-dive.md
|
|
title: Aider-AI/aider 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/cline-cline/README.md
|
|
title: cline/cline 研究域
|
|
role: IDE/SDK/CLI 自主编码 Agent
|
|
- path: research/cline-cline/analysis.md
|
|
title: cline/cline 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/cline-cline/deep-dive.md
|
|
title: cline/cline 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/hesreallyhim-awesome-claude-code/README.md
|
|
title: hesreallyhim/awesome-claude-code 研究域
|
|
role: Claude Code 生态索引
|
|
- path: research/hesreallyhim-awesome-claude-code/analysis.md
|
|
title: hesreallyhim/awesome-claude-code 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/hesreallyhim-awesome-claude-code/deep-dive.md
|
|
title: hesreallyhim/awesome-claude-code 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/openai-codex/README.md
|
|
title: openai/codex 研究域
|
|
role: 官方 coding agent 工具源码
|
|
- path: research/openai-codex/analysis.md
|
|
title: openai/codex 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/openai-codex/deep-dive.md
|
|
title: openai/codex 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/shanraisshan-claude-code-best-practice/README.md
|
|
title: shanraisshan/claude-code-best-practice 研究域
|
|
role: Claude Code / Agentic Engineering 最强对标
|
|
- path: research/shanraisshan-claude-code-best-practice/analysis.md
|
|
title: shanraisshan/claude-code-best-practice 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/shanraisshan-claude-code-best-practice/deep-dive.md
|
|
title: shanraisshan/claude-code-best-practice 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/tradecatlabs-vibe-coding-cn/README.md
|
|
title: tradecatlabs/vibe-coding-cn 研究域
|
|
role: 中文主线工程化工作流
|
|
- path: research/tradecatlabs-vibe-coding-cn/analysis.md
|
|
title: tradecatlabs/vibe-coding-cn 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/tradecatlabs-vibe-coding-cn/deep-dive.md
|
|
title: tradecatlabs/vibe-coding-cn 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/datawhalechina-easy-vibe/README.md
|
|
title: datawhalechina/easy-vibe 研究域
|
|
role: 中文分阶段交互式课程
|
|
- path: research/datawhalechina-easy-vibe/analysis.md
|
|
title: datawhalechina/easy-vibe 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/datawhalechina-easy-vibe/deep-dive.md
|
|
title: datawhalechina/easy-vibe 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/datawhalechina-vibe-vibe/README.md
|
|
title: datawhalechina/vibe-vibe 研究域
|
|
role: 中文零基础系统教程
|
|
- path: research/datawhalechina-vibe-vibe/analysis.md
|
|
title: datawhalechina/vibe-vibe 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/datawhalechina-vibe-vibe/deep-dive.md
|
|
title: datawhalechina/vibe-vibe 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/filipecalegario-awesome-vibe-coding/README.md
|
|
title: filipecalegario/awesome-vibe-coding 研究域
|
|
role: 国际 Vibe Coding 索引
|
|
- path: research/filipecalegario-awesome-vibe-coding/analysis.md
|
|
title: filipecalegario/awesome-vibe-coding 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/filipecalegario-awesome-vibe-coding/deep-dive.md
|
|
title: filipecalegario/awesome-vibe-coding 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/luzhenqian-ai-coding-lab/README.md
|
|
title: luzhenqian/ai-coding-lab 研究域
|
|
role: AI Coding 项目实验室
|
|
- path: research/luzhenqian-ai-coding-lab/analysis.md
|
|
title: luzhenqian/ai-coding-lab 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/luzhenqian-ai-coding-lab/deep-dive.md
|
|
title: luzhenqian/ai-coding-lab 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/shouzhengai-cs146s-cn/README.md
|
|
title: ShouZhengAI/CS146S_CN 研究域
|
|
role: 中文课程与 assignments
|
|
- path: research/shouzhengai-cs146s-cn/analysis.md
|
|
title: ShouZhengAI/CS146S_CN 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/shouzhengai-cs146s-cn/deep-dive.md
|
|
title: ShouZhengAI/CS146S_CN 深度研究
|
|
role: L2 源码/结构深度研究、关键机制和可迁移模式
|
|
- path: research/ai-for-developers-awesome-vibe-coding/README.md
|
|
title: ai-for-developers/awesome-vibe-coding 研究域
|
|
role: 精选 Vibe Coding 资料清单
|
|
- path: research/ai-for-developers-awesome-vibe-coding/analysis.md
|
|
title: ai-for-developers/awesome-vibe-coding 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/ai-for-developers-awesome-vibe-coding/deep-dive.md
|
|
title: ai-for-developers/awesome-vibe-coding 深度研究
|
|
role: L2 结构深度研究、关键机制、迁移边界和验证任务
|
|
- path: research/daotin-ai-coding/README.md
|
|
title: Daotin/ai-coding 研究域
|
|
role: AI Coding 经验汇总
|
|
- path: research/daotin-ai-coding/analysis.md
|
|
title: Daotin/ai-coding 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/daotin-ai-coding/deep-dive.md
|
|
title: Daotin/ai-coding 深度研究
|
|
role: L2 结构深度研究、关键机制、迁移边界和验证任务
|
|
- path: research/earyantle-vibe-coding-skill/README.md
|
|
title: earyantLe/vibe-coding-skill 研究域
|
|
role: Vibe Coding Skill / SOP 化
|
|
- path: research/earyantle-vibe-coding-skill/analysis.md
|
|
title: earyantLe/vibe-coding-skill 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/earyantle-vibe-coding-skill/deep-dive.md
|
|
title: earyantLe/vibe-coding-skill 深度研究
|
|
role: L2 结构深度研究、关键机制、迁移边界和验证任务
|
|
- path: research/liyupi-ai-guide/README.md
|
|
title: liyupi/ai-guide 研究域
|
|
role: AI 资源大全与产品实用路线
|
|
- path: research/liyupi-ai-guide/analysis.md
|
|
title: liyupi/ai-guide 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/liyupi-ai-guide/deep-dive.md
|
|
title: liyupi/ai-guide 深度研究
|
|
role: L2 结构深度研究、关键机制、迁移边界和验证任务
|
|
- path: research/roocodeinc-roo-code/README.md
|
|
title: RooCodeInc/Roo-Code 研究域
|
|
role: 已归档多 Agent 编辑器工具
|
|
- path: research/roocodeinc-roo-code/analysis.md
|
|
title: RooCodeInc/Roo-Code 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/roocodeinc-roo-code/deep-dive.md
|
|
title: RooCodeInc/Roo-Code 深度研究
|
|
role: L2 结构深度研究、关键机制、迁移边界和验证任务
|
|
- path: research/wendy7756-vibe-coding-guide/README.md
|
|
title: wendy7756/vibe-coding-guide 研究域
|
|
role: 非程序员自然语言编程指南
|
|
- path: research/wendy7756-vibe-coding-guide/analysis.md
|
|
title: wendy7756/vibe-coding-guide 研究分析
|
|
role: 结构化研究结论、可借鉴点、风险和下一轮任务
|
|
- path: research/wendy7756-vibe-coding-guide/deep-dive.md
|
|
title: wendy7756/vibe-coding-guide 深度研究
|
|
role: L2 结构深度研究、关键机制、迁移边界和验证任务
|
|
- path: research/tmux-ai-swarm.md
|
|
title: tmux 蜂群协作
|
|
role: 用 tmux 让多个 AI 终端可感知、可调度、可救援的实验性协作范式
|
|
workflow:
|
|
- path: docs/workflow/development-process.md
|
|
title: 开发流程
|
|
role: 默认任务推进顺序、质量门禁和交付闭环
|
|
top_level:
|
|
skills:
|
|
path: skills
|
|
purpose: 可复用 AI Skills
|
|
prompts:
|
|
path: prompts
|
|
purpose: 提示词入口与提示词资产
|
|
tools:
|
|
path: tools
|
|
purpose: 辅助工具、外部仓库与工具配置
|
|
assets:
|
|
path: assets
|
|
purpose: 图片、模板、数据文件、外部资源注册表等静态资产
|