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
+4
View File
@@ -4,3 +4,7 @@
# visible in the repository, but do not let their implementation languages
# dominate the main repository language statistics.
tools/external/** linguist-vendored
# Research raw snapshots preserve external source text; do not normalize
# upstream whitespace in these captured artifacts.
docs/research/**/raw/*.raw.* -whitespace
+3
View File
@@ -97,3 +97,6 @@ backups/gz/
# Local-only enterprise architecture evidence kit
assets/templates/modern-enterprise-architecture-private/
# Local research repository clones
docs/research/**/raw/repository/
+11 -3
View File
@@ -9,7 +9,7 @@
### 允许的操作
- 读取、修改顶层文档:`README.md``AGENTS.md``CONTRIBUTING.md`
- 读取、修改 `docs/``prompts/``skills/``tools/config/``tools/external/` 下的文档与代码
- 执行 `make lint``make check-links``make check-details``make check-doc-structure``make check-directory-docs``make check-metadata``make check-ai-citation``make check-wiki``make sync-doc-toc`、prompts-library 转换工具
- 执行 `make lint``make check-links``make check-details``make check-doc-structure``make check-directory-docs``make check-metadata``make check-ai-citation``make check-research-raw``make check-wiki``make fetch-research-raw``make sync-doc-toc`、prompts-library 转换工具
- 新增/修改提示词、技能、文档
- 提交符合规范的 commit
@@ -70,7 +70,10 @@ git push origin develop
| `make check-directory-docs` | 校验仓库自有目录 README/AGENTS 覆盖 | Python 3 |
| `make check-metadata` | 校验 metadata 路径与锚点 | Python 3 |
| `make check-ai-citation` | 校验 llms 与 AI 引用语料路径和锚点 | Python 3 |
| `make check-external-resources` | 校验本地外部资源注册表字段、分类统计、ID 与链接形态 | Python 3、PyYAML |
| `make check-research-raw` | 校验研究域 raw 原始事实层、Git 工作树、来源清单和核心材料文件 | Python 3、Git |
| `make check-wiki WIKI_DIR=/tmp/vibe-coding-cn.wiki` | 校验 GitHub Wiki 独立仓库本地 checkout 的页面覆盖、内链、旧口径和 Markdown | Python 3、Node.js 22+、本地 Wiki checkout |
| `make fetch-research-raw` | 拉取 `docs/research/*/domain.yml` 对应 GitHub 研究对象的 raw 原始事实层和 `repository/` 工作树 | Python 3、Git、GitHub CLI 已认证 |
| `make sync-doc-toc` | 兼容旧线性 README 目录生成;当前拆分结构下通常无变更 | Python 3 |
| `make test` | 执行本地质量门禁 | Node.js 22+、Python 3 |
| `git submodule update --init --recursive` | 初始化外部 Git 仓库指针 | Git |
@@ -99,6 +102,7 @@ git push origin develop
- `docs/` - 中文知识库(方法论/入门/实战/资源)
- `prompts/` - 提示词入口与云端索引
- `skills/` - 可复用技能库(每个子目录一个 Skill)
- `assets/external-resources/` - 本地外部资源注册表
- `tools/config/` - 工具与开发配置(例如 Codex CLI)
- `tools/external/` - 外部工具与依赖(含 Git submodule
@@ -171,8 +175,9 @@ git push origin develop
│ └── claude-official-skills/ # Claude 官方 skills 软链接入口
├── assets/ # 静态资产与外部资源入口
│ ├── README.md # 外部资源在线表格入口
│ ├── README.md # 静态资产与外部资源入口
│ ├── AGENTS.md # assets/ 目录规则
│ ├── external-resources/ # 本地外部资源注册表
│ ├── ai-citation/ # AI 引用语料包与 llms-full
│ ├── images/ # 图片资产
│ ├── templates/ # 模板附件
@@ -234,6 +239,9 @@ git push origin develop
- `scripts/check-directory-docs.py` - 仓库自有目录 README/AGENTS 覆盖检查脚本,供 `make check-directory-docs` 与 CI 使用
- `scripts/check-metadata.py` - metadata 路径与锚点检查脚本,供 `make check-metadata` 与 CI 使用
- `scripts/check-ai-citation.py` - llms 与 AI 引用语料路径和锚点检查脚本,供 `make check-ai-citation` 与 CI 使用
- `scripts/check-external-resources.py` - 本地外部资源注册表检查脚本,供 `make check-external-resources``make test` 使用
- `scripts/check-research-raw.py` - 研究域 raw 原始事实层和 Git 工作树检查脚本,供 `make check-research-raw``make test` 使用
- `scripts/fetch-research-raw.py` - GitHub 研究对象 raw 原始事实层和 `repository/` 工作树拉取脚本,供 `make fetch-research-raw` 手动刷新使用,不纳入 CI
- `scripts/check-wiki.py` - GitHub Wiki 独立仓库本地 checkout 页面覆盖、内链和旧口径检查脚本,供 `make check-wiki` 使用
- `scripts/sync-doc-toc.py` - docs README 细粒度目录兼容脚本,当前拆分结构下通常无变更,供 `make sync-doc-toc` 使用
- `tools/prompts-library/main.py` - 提示词转换工具入口
@@ -345,7 +353,7 @@ make test
- **`prompts/`**: 提示词库入口(指向云端表格)
- **`skills/`**: 扁平化技能库(详见 skills/README.md
- **`docs/`**: 知识库(getting-started、concepts、philosophy、references
- **`assets/`**: 外部资源(在线表格)入口与使用说明
- **`assets/`**: 静态资产、外部资源注册表与 AI 引用资产
- **`assets/ai-citation/`**: AI 引用语料包与 `llms-full.txt`
- **`tools/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`tools/chat-vault/`**: AI 聊天记录保存工具
+18 -3
View File
@@ -1,6 +1,6 @@
# Makefile for Vibe Coding Guide
.PHONY: help lint check-links check-details check-doc-structure check-directory-docs check-metadata check-ai-citation check-wiki sync-doc-toc build test clean clean-deps
.PHONY: help lint check-links check-details check-doc-structure check-directory-docs check-metadata check-ai-citation check-external-resources check-research-raw check-wiki fetch-research-raw sync-doc-toc build test clean clean-deps
MARKDOWNLINT = npx --yes markdownlint-cli@0.48.0
@@ -16,7 +16,10 @@ help:
@echo " check-directory-docs - Check required README/AGENTS pairs"
@echo " check-metadata - Check metadata paths and anchors"
@echo " check-ai-citation - Check llms and AI citation paths and anchors"
@echo " check-external-resources - Check local external resources registry"
@echo " check-research-raw - Check research raw fact snapshots and repository clones"
@echo " check-wiki - Check local GitHub Wiki checkout when present"
@echo " fetch-research-raw - Fetch raw GitHub facts and repository clones for research domains"
@echo " sync-doc-toc - Regenerate docs fine-grained TOC blocks"
@echo " build - Verify knowledge base has no build step"
@echo " test - Run repository quality gates"
@@ -26,7 +29,7 @@ help:
lint:
@echo "Linting markdown files..."
@$(MARKDOWNLINT) --config .github/lint_config.json --ignore .history --ignore tools/external '**/*.md'
@$(MARKDOWNLINT) --config .github/lint_config.json --ignore .history --ignore tools/external --ignore 'docs/research/**/raw/repository/**' '**/*.md'
check-links:
@echo "Checking local markdown links and anchors..."
@@ -52,11 +55,23 @@ check-ai-citation:
@echo "Checking llms and AI citation paths and anchors..."
@python3 scripts/check-ai-citation.py
check-external-resources:
@echo "Checking local external resources registry..."
@python3 scripts/check-external-resources.py
check-research-raw:
@echo "Checking research raw fact snapshots and repository clones..."
@python3 scripts/check-research-raw.py
check-wiki:
@echo "Checking local GitHub Wiki checkout..."
@python3 scripts/check-wiki.py --wiki-dir "$${WIKI_DIR:-/tmp/vibe-coding-cn.wiki}"
@$(MARKDOWNLINT) --config .github/lint_config.json "$${WIKI_DIR:-/tmp/vibe-coding-cn.wiki}"/*.md
fetch-research-raw:
@echo "Fetching raw GitHub facts and repository clones for research domains..."
@python3 scripts/fetch-research-raw.py
sync-doc-toc:
@echo "Regenerating docs fine-grained TOC blocks..."
@python3 scripts/sync-doc-toc.py
@@ -64,7 +79,7 @@ sync-doc-toc:
build:
@echo "No build step: this repository is a documentation and knowledge-base project."
test: lint check-links check-details check-doc-structure check-directory-docs check-metadata check-ai-citation
test: lint check-links check-details check-doc-structure check-directory-docs check-metadata check-ai-citation check-external-resources check-research-raw
@echo "Quality gates complete."
clean: clean-deps
+13 -7
View File
@@ -44,7 +44,7 @@
<a href="./prompts/README.md#在线提示词库"><img src="https://img.shields.io/badge/📋_提示词-在线表格-blue?style=for-the-badge" alt="提示词在线表格"></a>
<a href="./docs/references/common-sense.md"><img src="https://img.shields.io/badge/💡_常识-提示词入门-orange?style=for-the-badge" alt="常识"></a>
<a href="https://github.com/tukuaiai/vibe-coding-cn/wiki"><img src="https://img.shields.io/badge/📚_Wiki-导航入口-slateblue?style=for-the-badge" alt="Wiki 导航入口"></a>
<a href="./assets/README.md#外部资源在线表格唯一真相源"><img src="https://img.shields.io/badge/📡_资源-聚合-teal?style=for-the-badge" alt="资源聚合"></a>
<a href="./assets/README.md#外部资源本地注册表"><img src="https://img.shields.io/badge/📡_资源-聚合-teal?style=for-the-badge" alt="资源聚合"></a>
</p>
[☯️ 道法术器](#dao-fa-shu-qi)
@@ -107,7 +107,7 @@
- 新手先走 [从零开始完整入门](docs/getting-started/learning-map.md):网络环境、CLI 配置、开发环境、Git 闭环。
- 核心框架是 [道法术器](#dao-fa-shu-qi):先固定人与 AI 的协作关系,再用方法、流程、门禁和工具落地。
- 工程主线是 Prompt、Skill、Context、Quality Gate 和 Git,用测试、CI、脚本、类型、schema、清单约束 AI 输出。
- 需要直接使用资源时,进入 [提示词](prompts/README.md#在线提示词库)、[Skills](skills/README.md#当前保留) 和 [外部资源](assets/README.md#外部资源在线表格唯一真相源)。
- 需要直接使用资源时,进入 [提示词](prompts/README.md#在线提示词库)、[Skills](skills/README.md#当前保留) 和 [外部资源](assets/README.md#外部资源本地注册表)。
### 入口关系
@@ -531,16 +531,21 @@
* [**软件工程的朴素真理**](docs/philosophy/software-engineering-truths.md): 代码、复杂度、需求、维护、质量、架构和团队的工程常识。
* [**工程实践**](docs/references/quality-gates-and-pitfalls.md): 项目架构、代码组织、开发经验、AI 编程质量门禁与常见坑的统一入口。
* [**技术栈**](docs/references/technology-stack.md#reference-technology-stack-十四如何选择技术栈): 常见软件系统技术栈、选型维度、组合案例与初学者学习路径。
* [**Harness 工程解析**](docs/research/harness-engineering.md): Harness Engineering 的工程控制、评估器与反馈闭环解析
* [**研究域治理契约**](docs/research/research-domain-contract.md): 研究域的结构、raw 原始事实层、成熟度、证据、沉淀和归档规则
* [**Harness 工程解析**](docs/research/harness/harness-engineering.md): Harness Engineering 的工程控制、评估器与反馈闭环解析。
* [**OpenAI Codex 研究域**](docs/research/openai-codex/README.md): 官方 coding agent 工具源码研究对象。
* [**Claude Code Best Practice 研究域**](docs/research/shanraisshan-claude-code-best-practice/README.md): Agentic Engineering 方法论对标研究对象。
* [**Cline 研究域**](docs/research/cline-cline/README.md): IDE/SDK/CLI 自主编码 Agent 研究对象。
* [**Aider 研究域**](docs/research/aider-ai-aider/README.md): 终端 AI 结对编程工具研究对象。
* [**Skills 技能库**](skills/README.md#当前保留): 当前保留的可复用技能入口。
* [**提示词入口**](prompts/README.md#在线提示词库): 在线提示词库入口。
* [**外部资源入口**](assets/README.md#外部资源在线表格唯一真相源): 外部资源在线表格唯一真相源
* [**外部资源入口**](assets/README.md#外部资源本地注册表): 外部资源本地注册表入口
* [**AI Agent 操作规则**](AGENTS.md): AI Agent 执行任务时必须遵守的项目操作手册。
* [**llms.txt**](llms.txt): 面向 AI 助手的短上下文入口。
* [**llms-full.txt**](assets/ai-citation/llms-full.txt): 面向 AI 助手的完整上下文入口。
* [**编程提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 适用于 Vibe Coding 流程的专用提示词(云端表格)。
* [**系统提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): AI 开发的系统提示词,含多版本开发规范(云端表格)。
* [**外部资源(在线表格)**](./assets/README.md): 外部资源的唯一真相源按类型分表),本地 Markdown 保留为历史参考
* [**外部资源本地注册表**](./assets/external-resources/README.md): 外部资源的本地真相源按类型分类维护
---
@@ -652,7 +657,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
├── tools/ # 辅助工具、外部仓库与工具配置
├── scripts/ # 自动化脚本
├── metadata/ # 机器可读索引
├── assets/ # 静态资产、外部资源入口与 AI 引用资产
├── assets/ # 静态资产、外部资源注册表与 AI 引用资产
├── .github/ # GitHub 配置
│ ├── CODEOWNERS # 路径级 owner 评审基线
@@ -694,7 +699,8 @@ skills/
docs/
getting-started/*, concepts/*, references/* 等知识库
assets/
README.md # 外部资源(在线表格)唯一真相源入口
README.md # 静态资产与外部资源入口
external-resources/ # 本地外部资源注册表
scripts/
check-local-links.py # Markdown 相对链接检查脚本
```
+4 -1
View File
@@ -2,7 +2,8 @@
本目录只维护静态资产与外部资源入口,包含:
- `assets/README.md`外部资源在线表格入口(唯一真相源)
- `assets/README.md`静态资产与外部资源入口
- `assets/external-resources/`:本地外部资源注册表
- `assets/images/`:文档图片、截图、封面等图片资产
- `assets/templates/`:可复用模板附件
- `assets/datasets/`:示例数据、轻量数据集或数据说明
@@ -10,6 +11,7 @@
其中“外部资源”类入口文档的典型形态包括:
- 本地资源注册表(资源库、索引表、分类清单)
- 在线表格(资源库、索引表、清单)
- 远程文档(规范、课程、外部知识库)
- 其它需要在仓库内保留“可追溯入口”的外部资源
@@ -21,3 +23,4 @@
- `tools/external/` 下的第三方镜像/子模块:除非任务明确要求,否则不要做“顺手改动/格式化/批量替换”。
- 尽量只存“入口文档与说明”,不要复制粘贴大段第三方内容。
- 外部资产必须写清:用途、维护者、更新方式、与仓库内文档的关系(谁是唯一真相源)。
- 外部资源注册表变更后运行 `make check-external-resources`
+7 -5
View File
@@ -7,18 +7,20 @@
| `images/` | 文档图片、截图、封面等图片资产 |
| `templates/` | 可复用模板附件 |
| `datasets/` | 示例数据、轻量数据集或数据说明 |
| `external-resources/` | 本地外部资源注册表 |
| `ai-citation/` | 面向 AI 助手、AI 搜索与 GEO/SEO 引用的语料资产 |
| `README.md` | 外部资源在线表格入口 |
| `README.md` | 静态资产与外部资源入口 |
| `AGENTS.md` | 本目录维护规则 |
## 外部资源在线表格(唯一真相源)
## 外部资源本地注册表
- 外部资源(按类型分表):`Google Sheets`
- [外部资源在线表格(Google Sheets](https://docs.google.com/spreadsheets/d/1DY0JfSph_OqaSkVPlrnQrg7OKyPUuhDHsCh-431ot-I/edit?usp=sharing)
- 本地资源注册表:[external-resources/](external-resources/)
- 原始在线表格导入来源:
[外部资源在线表格(Google Sheets](https://docs.google.com/spreadsheets/d/1DY0JfSph_OqaSkVPlrnQrg7OKyPUuhDHsCh-431ot-I/edit?usp=sharing)
## 与仓库文档的关系
- 外部资源的新增/删除/去重/更新,以在线表格为准。
- 外部资源的新增删除去重更新,以 `external-resources/` 的分类资源文件为准。
- 核心知识库位于 `docs/`
- 提示词库入口位于 `prompts/`
- 技能库位于 `skills/`
+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。
+46
View File
@@ -0,0 +1,46 @@
# assets/external-resources/ Agent 指南
本目录维护本地外部资源注册表,是外部资源从在线表格迁入仓库后的结构化真相源。
## 目录职责
```text
external-resources/
├── README.md # 入口说明
├── AGENTS.md # 本目录维护规则
├── resources.yml # 分类索引、导入来源、统计和治理策略
├── schema.yml # 字段契约与枚举
├── quality-report.md # 导入质量与人工复核清单
├── network-payment-services.yml # 网络与支付服务
├── creator-accounts.yml # 博主账号
├── tools-platforms.yml # 工具与平台
├── communities-forums.yml # 社区与论坛
├── repo-rules-scaffolds.yml # 仓库、规则与脚手架
├── docs-courses.yml # 文档与课程
├── books.yml # 书单
└── archive.yml # 下线、失效、废弃或被替代资源
```
## 边界
- 这里保存资源索引,不复制第三方正文、课程内容、书籍内容、仓库源码或二进制附件。
- 外部工具源码、完整第三方仓库、fork 和 submodule 放在 `tools/external/`
- 对单个资源形成研究结论时,放入 `docs/research/`,并从资源记录回链。
- 资源被正式写入教程正文前,必须人工复核可用性、许可证、合规风险和推荐口径。
## 字段规则
- `id` 必须全局唯一,使用小写短横线风格,禁止改已有 ID;重命名资源只改 `name`
- `link.kind=external_url` 时必须填写 `url``domain`
- 非 URL 入口必须使用 `locator`,并保持 `status: needs-review`
- 缺失链接、推广参数、金融服务、访问合法性风险必须写入 `risk_flags`
- `verification_status: imported-unverified` 表示只完成导入,不能当作已推荐资源。
## 更新流程
1. 修改对应分类文件。
2. 必要时更新 `resources.yml` 的分类统计。
3. 对失效、废弃或不再推荐资源,迁入 `archive.yml`,不要直接删除历史。
4. 运行 `make check-external-resources`
5. 如果入口、命令或目录边界变化,同步更新 `assets/README.md`、根 `README.md`
`AGENTS.md``llms.txt` 和相关 metadata。
+43
View File
@@ -0,0 +1,43 @@
# External Resources
本目录存放从外部资源表格本地化后的资源注册表。
这里保存的是资源索引、分类、状态和治理字段,不保存第三方大段内容、工具源码或二进制附件。
## 入口
| 文件 | 用途 |
|:---|:---|
| `resources.yml` | 本地资源注册表总入口,登记分类文件、统计和治理策略 |
| `schema.yml` | 字段契约、枚举值和维护规则 |
| `quality-report.md` | 导入质量报告:缺失链接、非 URL、重复 URL 和风险标记 |
| `network-payment-services.yml` | 网络与支付服务 |
| `creator-accounts.yml` | 博主账号 |
| `tools-platforms.yml` | 工具与平台 |
| `communities-forums.yml` | 社区与论坛 |
| `repo-rules-scaffolds.yml` | 仓库、规则与脚手架 |
| `docs-courses.yml` | 文档与课程 |
| `books.yml` | 书单 |
| `archive.yml` | 下线、废弃或不再推荐的资源 |
## 存储原则
- 分类文件是资源数据的真相源,`resources.yml` 只做总入口和统计。
- 每条资源必须有稳定 `id``name``resource_type``link.kind``status`
`verification_status`
- 导入状态只代表结构化成功,不代表外链可用、内容合法、许可证可用或推荐等级。
- 第三方工具源码、完整仓库和 submodule 仍然放在 `tools/external/`
- 图片、模板、轻量数据集仍然放在 `assets/images/``assets/templates/`
`assets/datasets/`
## 验证
```bash
make check-external-resources
```
修改本目录后,建议运行:
```bash
make test
```
+3
View File
@@ -0,0 +1,3 @@
version: 1
description: 已下线、失效、合规风险过高或被替代的外部资源记录。
resources: []
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,208 @@
# Generated from assets_csv.xlsx. Edit intentionally and keep schema.yml in sync.
version: 1
category:
id: communities-forums
name: 社区与论坛
description: 用于收录 Telegram/Discord/Reddit/X 社群等
default_resource_type: community_or_forum
defaults:
imported_from: assets_csv.xlsx
imported_at: '2026-07-03'
verification_status: imported-unverified
license: unknown
resources:
- id: communities-forums-vibe-coding-dabb300b
name: Vibe Coding 交流群
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://t.me/glue_coding
domain: t.me
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 2
- id: communities-forums-vibe-coding-07437b63
name: Vibe Coding 频道
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://t.me/tradecat_ai_channel
domain: t.me
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 3
- id: communities-forums-aider-discord-376f5185
name: Aider Discord
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://discord.gg/Tv2uQnR88V
domain: discord.gg
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 4
- id: communities-forums-anthropic-discord-432f602b
name: Anthropic Discord
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://discord.gg/anthropic
domain: discord.gg
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 5
- id: communities-forums-cline-discord-037afd01
name: Cline Discord
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://discord.gg/cline
domain: discord.gg
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 6
- id: communities-forums-cursor-discord-0037d399
name: Cursor Discord
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://discord.gg/cursor
domain: discord.gg
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 7
- id: communities-forums-windsurf-discord-03064a7b
name: Windsurf Discord
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://discord.gg/codeium
domain: discord.gg
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 8
- id: communities-forums-r-bard-0a8ddf34
name: r/Bard
description: Gemini 社区
resource_type: community_or_forum
link:
kind: external_url
url: https://www.reddit.com/r/Bard/
domain: www.reddit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 9
- id: communities-forums-r-chatgpt-b9e19d32
name: r/ChatGPT
description: ChatGPT 社区
resource_type: community_or_forum
link:
kind: external_url
url: https://www.reddit.com/r/ChatGPT/
domain: www.reddit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 10
- id: communities-forums-r-chatgptpromptgenius-ab3c10cc
name: r/ChatGPTPromptGenius
description: 提示词分享
resource_type: community_or_forum
link:
kind: external_url
url: https://www.reddit.com/r/ChatGPTPromptGenius/
domain: www.reddit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 11
- id: communities-forums-r-claudeai-ee24f337
name: r/ClaudeAI
description: Claude 社区
resource_type: community_or_forum
link:
kind: external_url
url: https://www.reddit.com/r/ClaudeAI/
domain: www.reddit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 12
- id: communities-forums-r-localllama-7a9aebb6
name: r/LocalLLaMA
description: 本地大模型
resource_type: community_or_forum
link:
kind: external_url
url: https://www.reddit.com/r/LocalLLaMA/
domain: www.reddit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 13
- id: communities-forums-r-promptengineering-371979a8
name: r/PromptEngineering
description: 提示词工程
resource_type: community_or_forum
link:
kind: external_url
url: https://www.reddit.com/r/PromptEngineering/
domain: www.reddit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 14
- id: communities-forums-vibe-coding-68affa2a
name: Vibe Coding 社群
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://x.com/i/communities/1993849457210011871
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 15
- id: communities-forums-x-com-5b4c7a91
name: 社群干货聚合页
description: null
resource_type: community_or_forum
link:
kind: external_url
url: https://x.com/vibeverything/status/1999796188053438687
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 16
@@ -0,0 +1,246 @@
# Generated from assets_csv.xlsx. Edit intentionally and keep schema.yml in sync.
version: 1
category:
id: creator-accounts
name: 博主账号
description: 用于收录个人/账号/频道(X/YouTube/B站/小红书/视频号等)
default_resource_type: creator_account
defaults:
imported_from: assets_csv.xlsx
imported_at: '2026-07-03'
verification_status: imported-unverified
license: unknown
resources:
- id: creator-accounts-0xbard-thomas-036e8441
name: '@0XBard_thomas'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/0XBard_thomas
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 2
- id: creator-accounts-datachaz-1bd163cc
name: '@DataChaz'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/DataChaz
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 3
- id: creator-accounts-github-daily-149e4b9c
name: '@GitHub_Daily'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/GitHub_Daily
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 4
- id: creator-accounts-pluvio9yte-77e75a86
name: '@Pluvio9yte'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/Pluvio9yte
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 5
- id: creator-accounts-geekbb-e05b13a3
name: '@geekbb'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/geekbb
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 6
- id: creator-accounts-rohanpaul-ai-e029af07
name: '@rohanpaul_ai'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/rohanpaul_ai
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 7
- id: creator-accounts-shao-meng-0459bdbb
name: '@shao__meng'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/shao__meng
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 8
- id: creator-accounts-xdinodeer-42da49c8
name: '@xDinoDeer'
description: null
resource_type: creator_account
link:
kind: external_url
url: https://x.com/xDinoDeer
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 9
- id: creator-accounts-www-xiaohongshu-com-04f21547
name: 编程人生
description: 架构师,图解编程知识
resource_type: creator_account
link:
kind: external_url
url: https://www.xiaohongshu.com/user/profile/661913b50000000007006a56
domain: www.xiaohongshu.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 10
- id: creator-accounts-1cab5d79
name: 美国的牛粪博士
description: 来自微信视频号
resource_type: creator_account
link:
kind: missing
status: needs-review
verification_status: imported-unverified
tags: []
risk_flags:
- missing-link
source_row: 11
- id: creator-accounts-coding-e3aacd88
name: 小林coding
description: null
resource_type: creator_account
link:
kind: external_url
url: https://space.bilibili.com/282739748
domain: space.bilibili.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 12
- id: creator-accounts-b23-tv-74a3f2df
name: 雍俊海
description: 入门级软件安装删除
resource_type: creator_account
link:
kind: external_url
url: https://b23.tv/zxptu9g
domain: b23.tv
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 13
- id: creator-accounts-3blue1brown-78ee55af
name: 3Blue1Brown
description: 数学可视化
resource_type: creator_account
link:
kind: external_url
url: https://www.youtube.com/@3blue1brown
domain: www.youtube.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 14
- id: creator-accounts-andrej-karpathy-70ff1399
name: Andrej Karpathy
description: AI/深度学习
resource_type: creator_account
link:
kind: external_url
url: https://www.youtube.com/andrejkarpathy
domain: www.youtube.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 15
- id: creator-accounts-best-partners-765b457e
name: Best Partners
description: null
resource_type: creator_account
link:
kind: external_url
url: https://www.youtube.com/@bestpartners
domain: www.youtube.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 16
- id: creator-accounts-www-youtube-com-6b4f5805
name: 即刻风
description: null
resource_type: creator_account
link:
kind: external_url
url: https://www.youtube.com/@jidifeng
domain: www.youtube.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 17
- id: creator-accounts-www-youtube-com-f5050a03
name: 王路飞
description: null
resource_type: creator_account
link:
kind: external_url
url: https://www.youtube.com/@%E7%8E%8B%E8%B7%AF%E9%A3%9E
domain: www.youtube.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 18
- id: creator-accounts-a057117e
name: 科学小神牛
description: 科普
resource_type: creator_account
link:
kind: search_instruction
locator: 抖音自己搜
status: needs-review
verification_status: imported-unverified
tags: []
risk_flags:
- non-url-locator
source_row: 19
+286
View File
@@ -0,0 +1,286 @@
# Generated from assets_csv.xlsx. Edit intentionally and keep schema.yml in sync.
version: 1
category:
id: docs-courses
name: 文档与课程
description: 用于收录官方文档、教程、课程、学习资料
default_resource_type: documentation_or_course
defaults:
imported_from: assets_csv.xlsx
imported_at: '2026-07-03'
verification_status: imported-unverified
license: unknown
resources:
- id: docs-courses-x-com-314aaccd
name: 思考的框架
description: 123olp 官方
resource_type: documentation_or_course
link:
kind: external_url
url: https://x.com/123olp/status/2035796130676772876?s=20
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 2
- id: docs-courses-github-com-3e756697
name: 系统提示词中文版
description: 系统提示词中文版
resource_type: documentation_or_course
link:
kind: external_url
url: https://github.com/CreatorEdition/system-prompts-and-models-of-ai-tools-chinese/
domain: github.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 3
- id: docs-courses-claude-documentation-fcbf10ac
name: Claude Documentation
description: Anthropic 官方
resource_type: documentation_or_course
link:
kind: external_url
url: https://docs.anthropic.com/
domain: docs.anthropic.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 4
- id: docs-courses-gemini-documentation-d4572af5
name: Gemini Documentation
description: Google 官方
resource_type: documentation_or_course
link:
kind: external_url
url: https://ai.google.dev/docs
domain: ai.google.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 5
- id: docs-courses-openai-documentation-51095fa0
name: OpenAI Documentation
description: OpenAI 官方
resource_type: documentation_or_course
link:
kind: external_url
url: https://platform.openai.com/docs/
domain: platform.openai.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 6
- id: docs-courses-ai-ee860605
name: AI 编程工具对比
description: Cursor/Windsurf/Augment 等对比
resource_type: documentation_or_course
link:
kind: external_url
url: https://x.com/xiaoying_eth/status/2001865097661309260
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 7
- id: docs-courses-claude-code-in-action-8afcae53
name: Claude Code in Action
description: Anthropic 官方 Claude Code 实战课程
resource_type: documentation_or_course
link:
kind: external_url
url: https://anthropic.skilljar.com/claude-code-in-action
domain: anthropic.skilljar.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 8
- id: docs-courses-claude-code-in-action-f34fcda3
name: Claude Code in Action 中文版
description: Anthropic 官方实战课程中文版
resource_type: documentation_or_course
link:
kind: external_url
url: https://qcnernilww58.feishu.cn/wiki/WIKWwO6WXiMjAgkPCTEcVtWHnsh
domain: qcnernilww58.feishu.cn
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 9
- id: docs-courses-conductor-for-gemini-cli-839a8d1b
name: Conductor for Gemini CLI
description: 上下文驱动开发,Gemini CLI 扩展
resource_type: documentation_or_course
link:
kind: external_url
url: https://developers.googleblog.com/conductor-introducing-context-driven-development-for-gemini-cli/
domain: developers.googleblog.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 10
- id: docs-courses-the-modern-software-17e532b3
name: The Modern Software
description: 现代软件开发实践
resource_type: documentation_or_course
link:
kind: external_url
url: https://themodernsoftware.dev/
domain: themodernsoftware.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 11
- id: docs-courses-java-2d3af371
name: 二哥的Java进阶之路
description: 开发工具配置教程
resource_type: documentation_or_course
link:
kind: external_url
url: https://javabetter.cn/
domain: javabetter.cn
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 12
- id: docs-courses-x-com-9df1fcbe
name: 超级个体资源清单
description: null
resource_type: documentation_or_course
link:
kind: external_url
url: https://x.com/BiteyeCN/status/2000856243645157387
domain: x.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 13
- id: docs-courses-docs-google-com-9ba1e1ab
name: 元提示词库
description: null
resource_type: documentation_or_course
link:
kind: external_url
url: https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220
domain: docs.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 14
- id: docs-courses-docs-google-com-370338b0
name: 在线提示词表格
description: 推荐
resource_type: documentation_or_course
link:
kind: external_url
url: https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1
domain: docs.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 15
- id: docs-courses-anthropic-prompt-engineering-0e179ce8
name: Anthropic Prompt Engineering
description: 官方
resource_type: documentation_or_course
link:
kind: external_url
url: https://docs.anthropic.com/claude/docs/prompt-engineering
domain: docs.anthropic.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 16
- id: docs-courses-google-45423a3c
name: Google 提示词最佳实践宝典
description: Google 官方提示词最佳实践导航
resource_type: documentation_or_course
link:
kind: external_url
url: https://youware.app/project/q9yxq74um5?enter_from=share&screen_status=2
domain: youware.app
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 17
- id: docs-courses-learn-prompting-353fb297
name: Learn Prompting
description: 中文版
resource_type: documentation_or_course
link:
kind: external_url
url: https://learnprompting.org/zh-Hans/
domain: learnprompting.org
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 18
- id: docs-courses-openai-prompt-engineering-617ff398
name: OpenAI Prompt Engineering
description: 官方
resource_type: documentation_or_course
link:
kind: external_url
url: https://platform.openai.com/docs/guides/prompt-engineering
domain: platform.openai.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 19
- id: docs-courses-prompt-engineering-guide-ef579d97
name: Prompt Engineering Guide
description: 中文版
resource_type: documentation_or_course
link:
kind: external_url
url: https://www.promptingguide.ai/zh
domain: www.promptingguide.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 20
- id: docs-courses-state-of-the-art-prompting-ca680bd5
name: State-Of-The-Art Prompting
description: YC 顶级技巧
resource_type: documentation_or_course
link:
kind: external_url
url: https://docs.google.com/document/d/11tBoylc5Pvy8wDp9_i2UaAfDi8x02iMNg9mhCNv65cU/
domain: docs.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 21
- id: docs-courses-vibe-coding-101-3b140e25
name: Vibe Coding 101
description: 入门指南
resource_type: documentation_or_course
link:
kind: external_url
url: https://drive.google.com/file/d/1OMiqUviji4aI56E14PLaGVJsbjhOP1L1/view
domain: drive.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 22
@@ -0,0 +1,70 @@
# Generated from assets_csv.xlsx. Edit intentionally and keep schema.yml in sync.
version: 1
category:
id: network-payment-services
name: 网络与支付服务
description: 用于收录网络相关(代理客户端/服务)与支付相关(虚拟卡等)
default_resource_type: network_or_payment_service
defaults:
imported_from: assets_csv.xlsx
imported_at: '2026-07-03'
verification_status: imported-unverified
license: unknown
resources:
- id: network-payment-services-www-bsmkweb-com-0960fe59
name: 币安支付
description: 必备,用于兑换加密货币,充值AI工具订阅
resource_type: network_or_payment_service
link:
kind: external_url
url: https://www.bsmkweb.com/join?ref=123OLP
domain: www.bsmkweb.com
status: active
verification_status: imported-unverified
tags: []
risk_flags:
- referral-or-tracking-link
- financial-service-review
source_row: 2
- id: network-payment-services-flclash-a974428b
name: FlClash
description: 跨平台代理客户端
resource_type: network_or_payment_service
link:
kind: external_url
url: https://github.com/chen08209/FlClash/releases
domain: github.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 3
- id: network-payment-services-xn-9kqz23b19z-com-a271e5a7
name: 网络服务
description: 云服务
resource_type: network_or_payment_service
link:
kind: external_url
url: https://xn--9kqz23b19z.com/#/register?code=35BcnKzl
domain: xn--9kqz23b19z.com
status: active
verification_status: imported-unverified
tags: []
risk_flags:
- referral-or-tracking-link
source_row: 4
- id: network-payment-services-bybit-81d32c91
name: Bybit 虚拟卡
description: 注册云服务等国际支付
resource_type: network_or_payment_service
link:
kind: external_url
url: https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite
domain: www.bybit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags:
- referral-or-tracking-link
- financial-service-review
source_row: 5
+103
View File
@@ -0,0 +1,103 @@
# 外部资源导入质量报告
- 导入日期:2026-07-03
- 导入来源:`assets_csv.xlsx`
- 资源总数:287
- 缺失链接:5
- 非 URL 定位符:2
- 重复 URL 组数:6
## 分类统计
| 分类 | 文件 | 数量 |
|:---|:---|---:|
| 网络与支付服务 | `network-payment-services.yml` | 4 |
| 博主账号 | `creator-accounts.yml` | 18 |
| 工具与平台 | `tools-platforms.yml` | 68 |
| 社区与论坛 | `communities-forums.yml` | 15 |
| 仓库规则脚手架 | `repo-rules-scaffolds.yml` | 72 |
| 文档与课程 | `docs-courses.yml` | 21 |
| 书单 | `books.yml` | 75 |
## 需要人工复核
导入阶段只做结构化和字段归一化,以下项目需要人工复核后再作为推荐资源展示。
### 缺失链接
- `creator-accounts-1cab5d79`:博主账号 / 美国的牛粪博士 / source row 11
- `tools-platforms-gpt-5-1-codex-1ad522a5`:工具与平台 / GPT-5.1 Codex / source row 8
- `tools-platforms-gemini-2-5-pro-0661c69f`:工具与平台 / Gemini 2.5 Pro / source row 9
- `tools-platforms-local-history-2b05b2c1`:工具与平台 / Local History / source row 11
- `tools-platforms-partial-diff-4787875c`:工具与平台 / Partial Diff / source row 13
### 非 URL 定位符
- `creator-accounts-a057117e`:博主账号 / 科学小神牛 / `抖音自己搜`
- `tools-platforms-prompt-jsonl-8e9b2066`:工具与平台 / prompt_jsonl / `prompt_jsonl`
### 重复 URL
- `https://z-lib.fm/`76 项;工具与平台 / Z-Library;书单 / 从零开始大模型开发与微调:基于PyTorch与ChatGLM - 王晓华;书单 / 编程的原则:改善代码质量的101个方法 - 上田勋;书单 / 生成式 AI 设计模式 - Valliappa Lakshmanan & Hannes Hapke;书单 / 人月神话 - 弗雷德里克·布鲁克斯;书单 / 人件(原书第3版) - Tom DeMarco & Timothy Lister;书单 / 高效程序员的45个习惯:敏捷开发修炼之道 - Andy Hunt & Venkat Subramaniam;书单 / 项目管理修炼之道 - 罗斯曼;等 76 项
- `https://chatgpt.com/`2 项;工具与平台 / ChatGPT;工具与平台 / DALL-E 3
- `https://claude.ai/`:2 项;工具与平台 / Claude Opus 4.6;工具与平台 / Claude
- `https://geminicli.com/`:2 项;工具与平台 / Gemini CLI;工具与平台 / Gemini CLI
- `https://github.com/f/awesome-chatgpt-prompts`:2 项;仓库规则脚手架 / awesome-chatgpt-prompts;仓库规则脚手架 / Awesome ChatGPT Prompts
- `https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools`:2 项;仓库规则脚手架 / system-prompts-and-models-of-ai-tools;仓库规则脚手架 / System Prompts 仓库
### 风险标记统计
- `access-legality-review`76
- `financial-service-review`2
- `missing-link`5
- `non-url-locator`2
- `referral-or-tracking-link`3
## 后续治理动作
-`missing-link``non-url-locator` 补齐稳定 URL 或明确保留原因。
-`referral-or-tracking-link` 判断是否保留推广参数,必要时改成 canonical URL。
-`financial-service-review` 标注地区、风险边界和非投资建议。
-`access-legality-review` 资源复核合法性、许可证和公开推荐风险。
- 对重复 URL 判断是同源不同对象,还是应该合并。
## 增量导入:ChatGPT 中文 Vibe Coding 仓库
- 导入日期:2026-07-03
- 导入来源:`ChatGPT-中文Vibe Coding仓库 (2).md`
- 检出仓库资源:17
- 新增仓库资源:13
- 更新既有仓库口径:2
- 跳过已存在仓库:2
- 新增工具资源:1
- 未导入上下文链接:1 个 ChatGPT 对话链接,仅作为来源上下文,不作为资源推荐。
### 新增仓库
- `datawhalechina/easy-vibe`
- `liyupi/ai-guide`
- `wendy7756/vibe-coding-guide`
- `Daotin/ai-coding`
- `earyantLe/vibe-coding-skill`
- `luzhenqian/ai-coding-lab`
- `ShouZhengAI/CS146S_CN`
- `filipecalegario/awesome-vibe-coding`
- `ai-for-developers/awesome-vibe-coding`
- `openai/codex`
- `RooCodeInc/Roo-Code`
- `shanraisshan/claude-code-best-practice`
- `hesreallyhim/awesome-claude-code`
### 更新既有仓库口径
- `tradecatlabs/vibe-coding-cn`
- `aider-ai/aider`
### 跳过已存在仓库
- `datawhalechina/vibe-vibe`
- `cline/cline`
### 新增工具
- `ChatGPT Exporter`
File diff suppressed because it is too large Load Diff
+70
View File
@@ -0,0 +1,70 @@
version: 1
name: external-resources
description: 本地外部资源注册表,分类文件为资源真相源。
source:
current_source_of_truth: assets/external-resources/*.yml
imported_from: assets_csv.xlsx
imported_at: '2026-07-03'
previous_remote_source: https://docs.google.com/spreadsheets/d/1DY0JfSph_OqaSkVPlrnQrg7OKyPUuhDHsCh-431ot-I/edit?usp=sharing
import_note: 从维护者提供的本地 Excel 工作簿导入;未提交原始 .xlsx。
additional_imports:
- imported_from: ChatGPT-中文Vibe Coding仓库 (2).md
imported_at: '2026-07-03'
detected_repositories: 17
added_repositories: 13
updated_existing_repositories: 2
skipped_existing_repositories: 2
added_tools: 1
private_or_context_links_not_imported: 1
governance:
schema: schema.yml
quality_report: quality-report.md
validation_command: make check-external-resources
verification_policy: 导入只证明结构化,不证明外链可用、内容合法、许可证可用或推荐等级。
categories:
- id: network-payment-services
name: 网络与支付服务
file: network-payment-services.yml
count: 4
description: 用于收录网络相关(代理客户端/服务)与支付相关(虚拟卡等)
- id: creator-accounts
name: 博主账号
file: creator-accounts.yml
count: 18
description: 用于收录个人/账号/频道(X/YouTube/B站/小红书/视频号等)
- id: tools-platforms
name: 工具与平台
file: tools-platforms.yml
count: 69
description: 用于收录大模型、AI 对话平台、IDE、CLI、Agent 平台、通用工具网站等
- id: communities-forums
name: 社区与论坛
file: communities-forums.yml
count: 15
description: 用于收录 Telegram/Discord/Reddit/X 社群等
- id: repo-rules-scaffolds
name: 仓库规则脚手架
file: repo-rules-scaffolds.yml
count: 85
description: 用于收录 GitHub 仓库、Rules/规则文件集合、项目脚手架/模板
- id: docs-courses
name: 文档与课程
file: docs-courses.yml
count: 21
description: 用于收录官方文档、教程、课程、学习资料
- id: books
name: 书单
file: books.yml
count: 75
description: 用于收录相关书籍
stats:
total_resources: 287
missing_link_resources: 5
non_url_locator_resources: 2
duplicate_url_count: 6
risk_flags:
access-legality-review: 76
financial-service-review: 2
missing-link: 5
non-url-locator: 2
referral-or-tracking-link: 3
+89
View File
@@ -0,0 +1,89 @@
version: 1
description: 外部资源注册表字段契约。
resource_file:
required_top_level_fields:
- version
- category
- defaults
- resources
category_required_fields:
- id
- name
- description
- default_resource_type
resource:
required_fields:
- id
- name
- resource_type
- link
- status
- verification_status
- tags
- risk_flags
- source_row
optional_fields:
- description
- owner
- notes
- related_docs
- canonical_url
- license
- last_checked_at
- archived_at
- archive_reason
link:
required_fields:
- kind
kinds:
external_url:
required_fields:
- url
- domain
description: 可直接访问的 HTTP/HTTPS URL。
internal_reference:
required_fields:
- locator
description: 仓库内或表格内的内部引用,需要人工补齐。
search_instruction:
required_fields:
- locator
description: 只能通过搜索定位的入口,需要人工补齐。
missing:
required_fields: []
description: 缺失链接,必须保持 needs-review。
enums:
status:
- active
- needs-review
- deprecated
- archived
verification_status:
- imported-unverified
- manually-verified
- broken
- replaced
risk_flags:
- missing-link
- non-url-locator
- referral-or-tracking-link
- financial-service-review
- access-legality-review
resource_type:
- network_or_payment_service
- creator_account
- tool_or_platform
- community_or_forum
- repository_rule_or_scaffold
- documentation_or_course
- book
governance:
import_policy: 导入只证明结构化,不证明外链可用、内容合法、许可证可用或推荐等级。
source_of_truth: 分类资源文件是资源数据真相源,resources.yml 是总入口。
deletion_policy: 默认归档到 archive.yml,不直接删除历史资源。
validation_command: make check-external-resources
@@ -0,0 +1,911 @@
# Generated from assets_csv.xlsx and later curated imports. Edit intentionally and keep schema.yml in sync.
version: 1
category:
id: tools-platforms
name: 工具与平台
description: 用于收录大模型、AI 对话平台、IDE、CLI、Agent 平台、通用工具网站等
default_resource_type: tool_or_platform
defaults:
imported_from: assets_csv.xlsx
imported_at: '2026-07-03'
verification_status: imported-unverified
license: unknown
resources:
- id: tools-platforms-codex-cli-362bc20a
name: Codex CLI
description: 唯一推荐的苹果级工具,世界最强最强大模型(编码任务瞬秒其他全部的安卓级工具,.codex配置文件和系统提示词 https://github.com/tukuaiai/vibe-coding-cn/tree/develop/config/.codex
resource_type: tool_or_platform
link:
kind: external_url
url: https://chatgpt.com/codex
domain: chatgpt.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 2
- id: tools-platforms-prompt-jsonl-8e9b2066
name: prompt_jsonl
description: 超级提示词资产在线表格
resource_type: tool_or_platform
link:
kind: internal_reference
locator: prompt_jsonl
status: needs-review
verification_status: imported-unverified
tags: []
risk_flags:
- non-url-locator
source_row: 3
- id: tools-platforms-apps-script-e6b8bbbb
name: Apps Script
description: Google 脚本
resource_type: tool_or_platform
link:
kind: external_url
url: https://script.google.com/
domain: script.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 4
- id: tools-platforms-bilibili-23287176
name: Bilibili
description: 视频教程
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.bilibili.com/
domain: www.bilibili.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 5
- id: tools-platforms-claude-opus-4-6-f751380c
name: Claude Opus 4.6
description: 工具使用能力强,agent类任务首选
resource_type: tool_or_platform
link:
kind: external_url
url: https://claude.ai/
domain: claude.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 6
- id: tools-platforms-droid-1b66f6e0
name: Droid
description: 多模型 CLI 访问
resource_type: tool_or_platform
link:
kind: external_url
url: https://factory.ai/
domain: factory.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 7
- id: tools-platforms-gpt-5-1-codex-1ad522a5
name: GPT-5.1 Codex
description: 复杂逻辑处理
resource_type: tool_or_platform
link:
kind: missing
status: needs-review
verification_status: imported-unverified
tags: []
risk_flags:
- missing-link
source_row: 8
- id: tools-platforms-gemini-2-5-pro-0661c69f
name: Gemini 2.5 Pro
description: 免费长上下文
resource_type: tool_or_platform
link:
kind: missing
status: needs-review
verification_status: imported-unverified
tags: []
risk_flags:
- missing-link
source_row: 9
- id: tools-platforms-google-sheets-32b827b0
name: Google Sheets
description: 在线表格
resource_type: tool_or_platform
link:
kind: external_url
url: https://docs.google.com/spreadsheets/
domain: docs.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 10
- id: tools-platforms-local-history-2b05b2c1
name: Local History
description: VS Code 本地历史插件
resource_type: tool_or_platform
link:
kind: missing
status: needs-review
verification_status: imported-unverified
tags: []
risk_flags:
- missing-link
source_row: 11
- id: tools-platforms-mermaid-chart-302f49f0
name: Mermaid Chart
description: 文本转图表
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.mermaidchart.com/
domain: www.mermaidchart.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 12
- id: tools-platforms-partial-diff-4787875c
name: Partial Diff
description: VS Code 差异对比插件
resource_type: tool_or_platform
link:
kind: missing
status: needs-review
verification_status: imported-unverified
tags: []
risk_flags:
- missing-link
source_row: 13
- id: tools-platforms-z-library-31b0d982
name: Z-Library
description: 电子书资源
resource_type: tool_or_platform
link:
kind: external_url
url: https://z-lib.fm/
domain: z-lib.fm
access_review: required
status: active
verification_status: imported-unverified
tags: []
risk_flags:
- access-legality-review
source_row: 14
- id: tools-platforms-docusaurus-09c54423
name: Docusaurus
description: Meta 开源文档框架
resource_type: tool_or_platform
link:
kind: external_url
url: https://docusaurus.io/
domain: docusaurus.io
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 15
- id: tools-platforms-mintlify-0f0b6833
name: Mintlify
description: AI 文档生成
resource_type: tool_or_platform
link:
kind: external_url
url: https://mintlify.com/
domain: mintlify.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 16
- id: tools-platforms-vitepress-da10a919
name: VitePress
description: Vue 驱动静态站点
resource_type: tool_or_platform
link:
kind: external_url
url: https://vitepress.dev/
domain: vitepress.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 17
- id: tools-platforms-zread-6c1ee1d6
name: Zread
description: AI 仓库阅读工具
resource_type: tool_or_platform
link:
kind: external_url
url: https://zread.ai/
domain: zread.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 18
- id: tools-platforms-lazyvim-2f22a781
name: LazyVim
description: Neovim 配置框架
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.lazyvim.org/
domain: www.lazyvim.org
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 19
- id: tools-platforms-neovim-a8b85739
name: Neovim
description: 键盘流首选
resource_type: tool_or_platform
link:
kind: external_url
url: https://neovim.io/
domain: neovim.io
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 20
- id: tools-platforms-pearai-0683754c
name: PearAI
description: 开源 AI IDE
resource_type: tool_or_platform
link:
kind: external_url
url: https://trypear.ai/
domain: trypear.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 21
- id: tools-platforms-vs-code-e8f2d385
name: VS Code
description: 主流编辑器
resource_type: tool_or_platform
link:
kind: external_url
url: https://code.visualstudio.com/
domain: code.visualstudio.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 22
- id: tools-platforms-void-b1594346
name: Void
description: 开源 AI 代码编辑器
resource_type: tool_or_platform
link:
kind: external_url
url: https://voideditor.com/
domain: voideditor.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 23
- id: tools-platforms-django-e05156b6
name: Django
description: Python 全栈 Web 框架
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.djangoproject.com/
domain: www.djangoproject.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 24
- id: tools-platforms-excalidraw-02ba0cb2
name: Excalidraw
description: 手绘风格图表
resource_type: tool_or_platform
link:
kind: external_url
url: https://excalidraw.com/
domain: excalidraw.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 25
- id: tools-platforms-mermaid-cc6f6e7e
name: Mermaid
description: 文本转图表
resource_type: tool_or_platform
link:
kind: external_url
url: https://mermaid.js.org/
domain: mermaid.js.org
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 26
- id: tools-platforms-notebooklm-e1b56ba1
name: NotebookLM
description: AI 笔记工具
resource_type: tool_or_platform
link:
kind: external_url
url: https://notebooklm.google.com/
domain: notebooklm.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 27
- id: tools-platforms-dbeaver-aa2fc821
name: DBeaver
description: 通用数据库客户端
resource_type: tool_or_platform
link:
kind: external_url
url: https://dbeaver.io/
domain: dbeaver.io
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 28
- id: tools-platforms-tableplus-9950f31a
name: TablePlus
description: 现代数据库 GUI
resource_type: tool_or_platform
link:
kind: external_url
url: https://tableplus.com/
domain: tableplus.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 29
- id: tools-platforms-warp-14bec77a
name: Warp
description: AI 终端
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.warp.dev/
domain: www.warp.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 30
- id: tools-platforms-zsh-d6d24951
name: zsh
description: Shell 增强
resource_type: tool_or_platform
link:
kind: external_url
url: https://ohmyz.sh/
domain: ohmyz.sh
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 31
- id: tools-platforms-claude-code-11b1e88d
name: Claude Code
description: Anthropic 官方 CLI
resource_type: tool_or_platform
link:
kind: external_url
url: https://code.claude.com/docs/en/overview
domain: code.claude.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 32
- id: tools-platforms-gemini-cli-d077e5cc
name: Gemini CLI
description: Google 官方 CLI
resource_type: tool_or_platform
link:
kind: external_url
url: https://geminicli.com/
domain: geminicli.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 33
- id: tools-platforms-opencode-ada070db
name: OpenCode
description: 开源终端 AI 助手,Go 编写
resource_type: tool_or_platform
link:
kind: external_url
url: https://opencode.ai/
domain: opencode.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 34
- id: tools-platforms-kimi-53c18eae
name: Kimi
description: Kimi K2.5 / 长文本处理强
resource_type: tool_or_platform
link:
kind: external_url
url: https://kimi.moonshot.cn/
domain: kimi.moonshot.cn
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 35
- id: tools-platforms-chatglm-cn-ebc410ba
name: 智谱清言
description: GLM-4 / 智谱 AI 出品
resource_type: tool_or_platform
link:
kind: external_url
url: https://chatglm.cn/
domain: chatglm.cn
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 36
- id: tools-platforms-www-doubao-com-b4d6c78b
name: 豆包
description: 豆包 / 字节出品
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.doubao.com/
domain: www.doubao.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 37
- id: tools-platforms-tongyi-aliyun-com-a528848f
name: 通义千问
description: Qwen / 阿里出品,免费
resource_type: tool_or_platform
link:
kind: external_url
url: https://tongyi.aliyun.com/
domain: tongyi.aliyun.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 38
- id: tools-platforms-ai-studio-2cd869be
name: AI Studio
description: Google 免费 Gemini
resource_type: tool_or_platform
link:
kind: external_url
url: https://aistudio.google.com/
domain: aistudio.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 39
- id: tools-platforms-gemini-cli-row40-d077e5cc
name: Gemini CLI
description: 免费命令行访问
resource_type: tool_or_platform
link:
kind: external_url
url: https://geminicli.com/
domain: geminicli.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 40
- id: tools-platforms-qwen-cli-a1b92a34
name: Qwen CLI
description: 阿里免费 CLI
resource_type: tool_or_platform
link:
kind: external_url
url: https://qwenlm.github.io/qwen-code-docs/zh/cli/
domain: qwenlm.github.io
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 41
- id: tools-platforms-antigravity-528a772a
name: antigravity
description: Google 免费 AI 服务
resource_type: tool_or_platform
link:
kind: external_url
url: https://antigravity.google/
domain: antigravity.google
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 42
- id: tools-platforms-bito-0c0619b5
name: Bito
description: 免费 AI 代码助手
resource_type: tool_or_platform
link:
kind: external_url
url: https://bito.ai/
domain: bito.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 43
- id: tools-platforms-codeium-668488a9
name: Codeium
description: 免费 AI 代码补全
resource_type: tool_or_platform
link:
kind: external_url
url: https://codeium.com/
domain: codeium.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 44
- id: tools-platforms-continue-edb7b3bf
name: Continue
description: 开源 AI 代码助手
resource_type: tool_or_platform
link:
kind: external_url
url: https://continue.dev/
domain: continue.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 45
- id: tools-platforms-tabnine-0b2c09aa
name: Tabnine
description: 免费基础版
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.tabnine.com/
domain: www.tabnine.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 46
- id: tools-platforms-chatgpt-935111f5
name: ChatGPT
description: GPT-5.1 / 综合能力强,支持 Codex
resource_type: tool_or_platform
link:
kind: external_url
url: https://chatgpt.com/
domain: chatgpt.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 47
- id: tools-platforms-claude-13dd5e3a
name: Claude
description: Claude Opus 4.6 / 代码能力强,支持 Artifacts
resource_type: tool_or_platform
link:
kind: external_url
url: https://claude.ai/
domain: claude.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 48
- id: tools-platforms-gemini-dc8a36f7
name: Gemini
description: Gemini 3.0 Pro / 免费额度大,支持长上下文
resource_type: tool_or_platform
link:
kind: external_url
url: https://gemini.google.com/
domain: gemini.google.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 49
- id: tools-platforms-dall-e-3-26dc583b
name: DALL-E 3
description: DALL-E 3
resource_type: tool_or_platform
link:
kind: external_url
url: https://chatgpt.com/
domain: chatgpt.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 50
- id: tools-platforms-elevenlabs-5a58d635
name: ElevenLabs
description: ElevenLabs
resource_type: tool_or_platform
link:
kind: external_url
url: https://elevenlabs.io/
domain: elevenlabs.io
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 51
- id: tools-platforms-ideogram-efb6a3b8
name: Ideogram
description: Ideogram
resource_type: tool_or_platform
link:
kind: external_url
url: https://ideogram.ai/
domain: ideogram.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 52
- id: tools-platforms-kling-253d44f3
name: Kling
description: Kling
resource_type: tool_or_platform
link:
kind: external_url
url: https://klingai.com/
domain: klingai.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 53
- id: tools-platforms-leonardo-ai-26816634
name: Leonardo AI
description: Leonardo AI
resource_type: tool_or_platform
link:
kind: external_url
url: https://leonardo.ai/
domain: leonardo.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 54
- id: tools-platforms-meshy-549051bc
name: Meshy
description: Meshy
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.meshy.ai/
domain: www.meshy.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 55
- id: tools-platforms-midjourney-976ad67d
name: Midjourney
description: Midjourney
resource_type: tool_or_platform
link:
kind: external_url
url: https://midjourney.com/
domain: midjourney.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 56
- id: tools-platforms-runway-6c8ab136
name: Runway
description: Runway
resource_type: tool_or_platform
link:
kind: external_url
url: https://runwayml.com/
domain: runwayml.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 57
- id: tools-platforms-sora-3b1d49f7
name: Sora
description: Sora
resource_type: tool_or_platform
link:
kind: external_url
url: https://sora.com/
domain: sora.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 58
- id: tools-platforms-suno-fb9344c5
name: Suno
description: Suno
resource_type: tool_or_platform
link:
kind: external_url
url: https://suno.ai/
domain: suno.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 59
- id: tools-platforms-udio-0d39f909
name: Udio
description: Udio
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.udio.com/
domain: www.udio.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 60
- id: tools-platforms-cursor-8ebf3977
name: Cursor
description: AI 原生编辑器,基于 VS Code
resource_type: tool_or_platform
link:
kind: external_url
url: https://cursor.com/
domain: cursor.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 61
- id: tools-platforms-kiro-47d2b0fc
name: Kiro
description: AWS 出品,免费 Claude Opus
resource_type: tool_or_platform
link:
kind: external_url
url: https://kiro.dev/
domain: kiro.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 62
- id: tools-platforms-windsurf-fdd489a7
name: Windsurf
description: Codeium 出品
resource_type: tool_or_platform
link:
kind: external_url
url: https://windsurf.com/
domain: windsurf.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 63
- id: tools-platforms-zed-07b4820e
name: Zed
description: 高性能编辑器,支持 AI
resource_type: tool_or_platform
link:
kind: external_url
url: https://zed.dev/
domain: zed.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 64
- id: tools-platforms-bolt-new-06379d16
name: Bolt.new
description: 浏览器内全栈应用构建
resource_type: tool_or_platform
link:
kind: external_url
url: https://bolt.new/
domain: bolt.new
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 65
- id: tools-platforms-devin-f5a69caf
name: Devin
description: 自主 AI 软件工程师,$20/月
resource_type: tool_or_platform
link:
kind: external_url
url: https://devin.ai/
domain: devin.ai
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 66
- id: tools-platforms-lovable-5eb584a1
name: Lovable
description: 原 GPT Engineer,自然语言建应用
resource_type: tool_or_platform
link:
kind: external_url
url: https://lovable.dev/
domain: lovable.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 67
- id: tools-platforms-replit-agent-bbd1c2ac
name: Replit Agent
description: 端到端应用构建 Agent
resource_type: tool_or_platform
link:
kind: external_url
url: https://replit.com/
domain: replit.com
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 68
- id: tools-platforms-v0-by-vercel-fe818ef0
name: v0 by Vercel
description: AI UI 生成,React + Tailwind
resource_type: tool_or_platform
link:
kind: external_url
url: https://v0.dev/
domain: v0.dev
status: active
verification_status: imported-unverified
tags: []
risk_flags: []
source_row: 69
- id: tools-platforms-chatgpt-exporter-a03efe97
name: ChatGPT Exporter
description: ChatGPT 对话导出工具;本次 Markdown 导出文件的来源工具。
resource_type: tool_or_platform
link:
kind: external_url
url: https://www.chatgptexporter.com
domain: www.chatgptexporter.com
status: active
verification_status: imported-unverified
tags:
- chatgpt
- export
risk_flags: []
source_row: 166
notes: Imported from ChatGPT-中文Vibe Coding仓库 (2).md.
+51 -2
View File
@@ -17,7 +17,7 @@
| [concepts](./concepts/) | 核心概念、问题求解、关键词系统与工程思想 | [问题求解](./concepts/problem-solving.md) / [拼好码](./concepts/glue-coding.md) / [关键词系统](./concepts/keyword-system.md) |
| [philosophy](./philosophy/) | 哲学方法论、思维模型与底层认知模型 | [思维模型](./philosophy/thinking-models.md) / [方法论工具箱](./philosophy/methodology-toolbox.md) |
| [references](./references/) | 工程实践、技术栈、模板和检查清单 | [项目架构模板](./references/project-architecture-template.md) / [质量门禁](./references/quality-gates-and-pitfalls.md) |
| [research](./research/) | 新技术、优秀 repo 与工程范式研究 | [Harness 工程解析](./research/harness-engineering.md) / [tmux 蜂群协作](./research/tmux-ai-swarm.md) |
| [research](./research/) | 新技术、优秀 repo 与工程范式研究 | [研究域治理契约](./research/research-domain-contract.md) / [Harness 研究对象](./research/harness/) |
| [workflow](./workflow/) | 开发流程、质量门禁和交付闭环 | [开发流程](./workflow/development-process.md) |
<details>
@@ -76,10 +76,59 @@
### research
- [README](./research/README.md) - 研究笔记索引。
- [Harness 工程解析](./research/harness-engineering.md) - Harness Engineering 的工程控制、评估器与反馈闭环解析
- [研究域治理契约](./research/research-domain-contract.md) - 研究域的结构、raw 原始事实层、成熟度、证据、沉淀和归档规则
- [研究价值与应用地图](./research/research-value-application-map.md) - 研究体系给用户带来的价值、核心启示、应用位置和下沉路线。
- [Harness 研究对象](./research/harness/README.md) - Harness Engineering 的工程控制、评估器与反馈闭环研究对象。
- [Harness 工程解析](./research/harness/harness-engineering.md) - Harness Engineering 的工程控制、评估器与反馈闭环解析。
- [tmux 蜂群协作](./research/tmux-ai-swarm.md) - 用 tmux 让多个 AI 终端可感知、可调度、可救援的实验性协作范式。
- [Aider-AI/aider 研究域](./research/aider-ai-aider/README.md) - 终端 AI 结对编程工具。
- [Aider-AI/aider 研究分析](./research/aider-ai-aider/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [Aider-AI/aider 深度研究](./research/aider-ai-aider/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [cline/cline 研究域](./research/cline-cline/README.md) - IDE/SDK/CLI 自主编码 Agent。
- [cline/cline 研究分析](./research/cline-cline/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [cline/cline 深度研究](./research/cline-cline/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [hesreallyhim/awesome-claude-code 研究域](./research/hesreallyhim-awesome-claude-code/README.md) - Claude Code 生态索引。
- [hesreallyhim/awesome-claude-code 研究分析](./research/hesreallyhim-awesome-claude-code/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [hesreallyhim/awesome-claude-code 深度研究](./research/hesreallyhim-awesome-claude-code/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [openai/codex 研究域](./research/openai-codex/README.md) - 官方 coding agent 工具源码。
- [openai/codex 研究分析](./research/openai-codex/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [openai/codex 深度研究](./research/openai-codex/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [shanraisshan/claude-code-best-practice 研究域](./research/shanraisshan-claude-code-best-practice/README.md) - Claude Code / Agentic Engineering 最强对标。
- [shanraisshan/claude-code-best-practice 研究分析](./research/shanraisshan-claude-code-best-practice/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [shanraisshan/claude-code-best-practice 深度研究](./research/shanraisshan-claude-code-best-practice/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [tradecatlabs/vibe-coding-cn 研究域](./research/tradecatlabs-vibe-coding-cn/README.md) - 中文主线工程化工作流。
- [tradecatlabs/vibe-coding-cn 研究分析](./research/tradecatlabs-vibe-coding-cn/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [tradecatlabs/vibe-coding-cn 深度研究](./research/tradecatlabs-vibe-coding-cn/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [datawhalechina/easy-vibe 研究域](./research/datawhalechina-easy-vibe/README.md) - 中文分阶段交互式课程。
- [datawhalechina/easy-vibe 研究分析](./research/datawhalechina-easy-vibe/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [datawhalechina/easy-vibe 深度研究](./research/datawhalechina-easy-vibe/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [datawhalechina/vibe-vibe 研究域](./research/datawhalechina-vibe-vibe/README.md) - 中文零基础系统教程。
- [datawhalechina/vibe-vibe 研究分析](./research/datawhalechina-vibe-vibe/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [datawhalechina/vibe-vibe 深度研究](./research/datawhalechina-vibe-vibe/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [filipecalegario/awesome-vibe-coding 研究域](./research/filipecalegario-awesome-vibe-coding/README.md) - 国际 Vibe Coding 索引。
- [filipecalegario/awesome-vibe-coding 研究分析](./research/filipecalegario-awesome-vibe-coding/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [filipecalegario/awesome-vibe-coding 深度研究](./research/filipecalegario-awesome-vibe-coding/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [luzhenqian/ai-coding-lab 研究域](./research/luzhenqian-ai-coding-lab/README.md) - AI Coding 项目实验室。
- [luzhenqian/ai-coding-lab 研究分析](./research/luzhenqian-ai-coding-lab/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [luzhenqian/ai-coding-lab 深度研究](./research/luzhenqian-ai-coding-lab/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [ShouZhengAI/CS146S_CN 研究域](./research/shouzhengai-cs146s-cn/README.md) - 中文课程与 assignments。
- [ShouZhengAI/CS146S_CN 研究分析](./research/shouzhengai-cs146s-cn/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [ShouZhengAI/CS146S_CN 深度研究](./research/shouzhengai-cs146s-cn/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [ai-for-developers/awesome-vibe-coding 研究域](./research/ai-for-developers-awesome-vibe-coding/README.md) - 精选 Vibe Coding 资料清单。
- [ai-for-developers/awesome-vibe-coding 研究分析](./research/ai-for-developers-awesome-vibe-coding/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [Daotin/ai-coding 研究域](./research/daotin-ai-coding/README.md) - AI Coding 经验汇总。
- [Daotin/ai-coding 研究分析](./research/daotin-ai-coding/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [earyantLe/vibe-coding-skill 研究域](./research/earyantle-vibe-coding-skill/README.md) - Vibe Coding Skill / SOP 化。
- [earyantLe/vibe-coding-skill 研究分析](./research/earyantle-vibe-coding-skill/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [liyupi/ai-guide 研究域](./research/liyupi-ai-guide/README.md) - AI 资源大全与产品实用路线。
- [liyupi/ai-guide 研究分析](./research/liyupi-ai-guide/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [RooCodeInc/Roo-Code 研究域](./research/roocodeinc-roo-code/README.md) - 已归档多 Agent 编辑器工具。
- [RooCodeInc/Roo-Code 研究分析](./research/roocodeinc-roo-code/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [wendy7756/vibe-coding-guide 研究域](./research/wendy7756-vibe-coding-guide/README.md) - 非程序员自然语言编程指南。
- [wendy7756/vibe-coding-guide 研究分析](./research/wendy7756-vibe-coding-guide/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [AGENTS](./research/AGENTS.md) - 研究笔记目录操作规则。
### workflow
- [README](./workflow/README.md) - 开发流程索引。
+89 -5
View File
@@ -2,7 +2,7 @@
## 目录职责
`docs/research/` 存放新技术、新技术栈、优秀 repo、工程范式和工具趋势的短篇研究。
`docs/research/` 存放新技术、新技术栈、优秀 repo、工程范式和工具趋势的研究对象与短篇研究。
这里的文档回答:
@@ -16,17 +16,101 @@
```text
research/
├── README.md # 索引入口:研究笔记导航
├── harness-engineering.md
├── README.md # 索引入口:研究对象与研究笔记导航
├── research-domain-contract.md # 研究域治理契约:结构、分层、成熟度、证据和归档规则
├── research-value-application-map.md # 研究价值与应用地图:用户价值、核心启示和下沉路线
├── harness/
│ ├── README.md
│ ├── harness-engineering.md
│ └── AGENTS.md
├── ai-for-developers-awesome-vibe-coding/
│ ├── README.md
│ ├── domain.yml
│ ├── analysis.md
│ ├── raw/
│ └── AGENTS.md
├── aider-ai-aider/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── cline-cline/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── daotin-ai-coding/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── datawhalechina-easy-vibe/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── datawhalechina-vibe-vibe/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── earyantle-vibe-coding-skill/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── filipecalegario-awesome-vibe-coding/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── hesreallyhim-awesome-claude-code/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── liyupi-ai-guide/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── luzhenqian-ai-coding-lab/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── openai-codex/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── roocodeinc-roo-code/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── shanraisshan-claude-code-best-practice/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── shouzhengai-cs146s-cn/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── tradecatlabs-vibe-coding-cn/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── wendy7756-vibe-coding-guide/
│ ├── README.md
│ ├── domain.yml
│ └── AGENTS.md
├── tmux-ai-swarm.md
└── AGENTS.md # 本目录操作规则
```
上方只展开了第一个外部仓库研究域的基础形态;所有外部仓库研究域都必须包含同样的原始事实层。
`deep-dive.md` 是 L2 产物,P1/P2 必须优先补齐,P3 可停留在 L1 观察状态。
## 修改规则
- 继承 `docs/AGENTS.md` 的 README 结构契约:H1 后直接进入 `## 字多不看`,再按 `快速导航 -> 完整细粒度目录 -> 使用方式 -> 正文` 排列。
- 每篇研究笔记聚焦一个技术、repo、范式或工具,并写入独立 `.md` 文档
- 新增研究 `.md` 文件时,必须同步更新 `README.md``metadata/taxonomy.yml` 和必要的 `redirects.yml`
- 长期研究域必须遵循 `research-domain-contract.md`;外部仓库研究域至少包含 `README.md``AGENTS.md``domain.yml``raw/`
- 长期研究对象优先使用独立目录;目录内必须包含 `README.md``AGENTS.md`
- 外部仓库研究对象采用“一仓库一研究域”,目录名使用 `<owner>-<repo>` 的小写短横线形式。
- `raw/` 是原始事实层,只保存拉取到本地的一手材料;分析判断写入上一级 `README.md``analysis.md``decisions.md`
- `research-value-application-map.md` 是研究体系的转化入口,用于说明研究给用户带来的价值、启示、应用位置和下沉路线。
- GitHub 仓库 raw 层通过 `python3 scripts/fetch-research-raw.py` 刷新;不要手工改写 `*.raw.*` 文件。
- 单次短篇观察可以先写成独立 `.md` 文档;如果对象会持续演化,应迁入对象目录。
- 新增研究对象目录或研究 `.md` 文件时,必须同步更新 `README.md``metadata/taxonomy.yml` 和必要的 `redirects.yml`
- 研究内容稳定后,放入 `docs/concepts/``docs/references/``docs/philosophy/` 的对应章节。
- 外部项目、模型、工具、版本和事实状态可能变化,涉及最新信息时必须核验来源。
- 不在 README 正文中写 `和其他目录的边界``维护规则`;维护者规则只写本文件。
+77 -5
View File
@@ -2,30 +2,102 @@
## 字多不看
- 本目录记录新技术、优秀 repo、工程范式和工具趋势的短篇研究。
- 研究文档用于判断是否采用,不作为稳定操作手册
- 本目录记录新技术、优秀 repo、工程范式和工具趋势的研究对象
- 新增或重构长期研究对象时,先遵循研究域治理契约,并拉取 raw 原始事实层
- 长期研究对象优先使用独立目录,短篇观察可先用单文件承载。
- 外部仓库研究对象采用“一仓库一研究域”,不再使用聚合目录承载多个仓库。
- 成熟后可沉淀到 concepts、references、workflow 或 skills。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| <a id="research-harness-engineering"></a>[Harness 工程解析](harness-engineering.md) | 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。 |
| <a id="research-domain-contract"></a>[研究域治理契约](research-domain-contract.md) | 研究域的结构、raw 原始事实层、成熟度、证据、沉淀和归档规则。 |
| <a id="research-value-application-map"></a>[研究价值与应用地图](research-value-application-map.md) | 研究体系给用户带来的价值、核心启示、应用位置和下沉路线。 |
| <a id="research-harness-engineering"></a>[Harness 研究对象](harness/) | 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。 |
| <a id="research-tmux-ai-swarm"></a>[tmux 蜂群协作](tmux-ai-swarm.md) | 用 tmux 让多个 AI 终端可感知、可调度、可救援的实验性协作范式。 |
| <a id="research-aider-ai-aider"></a>[Aider-AI/aider 研究域](aider-ai-aider/) | 终端 AI 结对编程工具。 |
| <a id="research-cline-cline"></a>[cline/cline 研究域](cline-cline/) | IDE/SDK/CLI 自主编码 Agent。 |
| <a id="research-hesreallyhim-awesome-claude-code"></a>[hesreallyhim/awesome-claude-code 研究域](hesreallyhim-awesome-claude-code/) | Claude Code 生态索引。 |
| <a id="research-openai-codex"></a>[openai/codex 研究域](openai-codex/) | 官方 coding agent 工具源码。 |
| <a id="research-shanraisshan-claude-code-best-practice"></a>[shanraisshan/claude-code-best-practice 研究域](shanraisshan-claude-code-best-practice/) | Claude Code / Agentic Engineering 最强对标。 |
| <a id="research-tradecatlabs-vibe-coding-cn"></a>[tradecatlabs/vibe-coding-cn 研究域](tradecatlabs-vibe-coding-cn/) | 中文主线工程化工作流。 |
| <a id="research-datawhalechina-easy-vibe"></a>[datawhalechina/easy-vibe 研究域](datawhalechina-easy-vibe/) | 中文分阶段交互式课程。 |
| <a id="research-datawhalechina-vibe-vibe"></a>[datawhalechina/vibe-vibe 研究域](datawhalechina-vibe-vibe/) | 中文零基础系统教程。 |
| <a id="research-filipecalegario-awesome-vibe-coding"></a>[filipecalegario/awesome-vibe-coding 研究域](filipecalegario-awesome-vibe-coding/) | 国际 Vibe Coding 索引。 |
| <a id="research-luzhenqian-ai-coding-lab"></a>[luzhenqian/ai-coding-lab 研究域](luzhenqian-ai-coding-lab/) | AI Coding 项目实验室。 |
| <a id="research-shouzhengai-cs146s-cn"></a>[ShouZhengAI/CS146S_CN 研究域](shouzhengai-cs146s-cn/) | 中文课程与 assignments。 |
| <a id="research-ai-for-developers-awesome-vibe-coding"></a>[ai-for-developers/awesome-vibe-coding 研究域](ai-for-developers-awesome-vibe-coding/) | 精选 Vibe Coding 资料清单。 |
| <a id="research-daotin-ai-coding"></a>[Daotin/ai-coding 研究域](daotin-ai-coding/) | AI Coding 经验汇总。 |
| <a id="research-earyantle-vibe-coding-skill"></a>[earyantLe/vibe-coding-skill 研究域](earyantle-vibe-coding-skill/) | Vibe Coding Skill / SOP 化。 |
| <a id="research-liyupi-ai-guide"></a>[liyupi/ai-guide 研究域](liyupi-ai-guide/) | AI 资源大全与产品实用路线。 |
| <a id="research-roocodeinc-roo-code"></a>[RooCodeInc/Roo-Code 研究域](roocodeinc-roo-code/) | 已归档多 Agent 编辑器工具;当前已归档,仅作参考。 |
| <a id="research-wendy7756-vibe-coding-guide"></a>[wendy7756/vibe-coding-guide 研究域](wendy7756-vibe-coding-guide/) | 非程序员自然语言编程指南。 |
<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>
### 细粒度目录
- [Harness 工程解析](harness-engineering.md) - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性
- [研究域治理契约](research-domain-contract.md) - 研究域的结构、raw 原始事实层、成熟度、证据、沉淀和归档规则
- [研究价值与应用地图](research-value-application-map.md) - 研究体系给用户带来的价值、核心启示、应用位置和下沉路线。
- [Harness 研究对象](harness/README.md) - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。
- [Harness 工程解析](harness/harness-engineering.md) - Harness Engineering 的工程控制、评估器与反馈闭环解析。
- [tmux 蜂群协作](tmux-ai-swarm.md) - 用 tmux 让多个 AI 终端可感知、可调度、可救援的实验性协作范式。
- [Aider-AI/aider 研究域](aider-ai-aider/README.md) - 终端 AI 结对编程工具。
- [Aider-AI/aider 研究分析](aider-ai-aider/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [Aider-AI/aider 深度研究](aider-ai-aider/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [cline/cline 研究域](cline-cline/README.md) - IDE/SDK/CLI 自主编码 Agent。
- [cline/cline 研究分析](cline-cline/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [cline/cline 深度研究](cline-cline/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [hesreallyhim/awesome-claude-code 研究域](hesreallyhim-awesome-claude-code/README.md) - Claude Code 生态索引。
- [hesreallyhim/awesome-claude-code 研究分析](hesreallyhim-awesome-claude-code/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [hesreallyhim/awesome-claude-code 深度研究](hesreallyhim-awesome-claude-code/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [openai/codex 研究域](openai-codex/README.md) - 官方 coding agent 工具源码。
- [openai/codex 研究分析](openai-codex/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [openai/codex 深度研究](openai-codex/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [shanraisshan/claude-code-best-practice 研究域](shanraisshan-claude-code-best-practice/README.md) - Claude Code / Agentic Engineering 最强对标。
- [shanraisshan/claude-code-best-practice 研究分析](shanraisshan-claude-code-best-practice/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [shanraisshan/claude-code-best-practice 深度研究](shanraisshan-claude-code-best-practice/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [tradecatlabs/vibe-coding-cn 研究域](tradecatlabs-vibe-coding-cn/README.md) - 中文主线工程化工作流。
- [tradecatlabs/vibe-coding-cn 研究分析](tradecatlabs-vibe-coding-cn/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [tradecatlabs/vibe-coding-cn 深度研究](tradecatlabs-vibe-coding-cn/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [datawhalechina/easy-vibe 研究域](datawhalechina-easy-vibe/README.md) - 中文分阶段交互式课程。
- [datawhalechina/easy-vibe 研究分析](datawhalechina-easy-vibe/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [datawhalechina/easy-vibe 深度研究](datawhalechina-easy-vibe/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [datawhalechina/vibe-vibe 研究域](datawhalechina-vibe-vibe/README.md) - 中文零基础系统教程。
- [datawhalechina/vibe-vibe 研究分析](datawhalechina-vibe-vibe/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [datawhalechina/vibe-vibe 深度研究](datawhalechina-vibe-vibe/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [filipecalegario/awesome-vibe-coding 研究域](filipecalegario-awesome-vibe-coding/README.md) - 国际 Vibe Coding 索引。
- [filipecalegario/awesome-vibe-coding 研究分析](filipecalegario-awesome-vibe-coding/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [filipecalegario/awesome-vibe-coding 深度研究](filipecalegario-awesome-vibe-coding/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [luzhenqian/ai-coding-lab 研究域](luzhenqian-ai-coding-lab/README.md) - AI Coding 项目实验室。
- [luzhenqian/ai-coding-lab 研究分析](luzhenqian-ai-coding-lab/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [luzhenqian/ai-coding-lab 深度研究](luzhenqian-ai-coding-lab/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [ShouZhengAI/CS146S_CN 研究域](shouzhengai-cs146s-cn/README.md) - 中文课程与 assignments。
- [ShouZhengAI/CS146S_CN 研究分析](shouzhengai-cs146s-cn/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [ShouZhengAI/CS146S_CN 深度研究](shouzhengai-cs146s-cn/deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [ai-for-developers/awesome-vibe-coding 研究域](ai-for-developers-awesome-vibe-coding/README.md) - 精选 Vibe Coding 资料清单。
- [ai-for-developers/awesome-vibe-coding 研究分析](ai-for-developers-awesome-vibe-coding/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [Daotin/ai-coding 研究域](daotin-ai-coding/README.md) - AI Coding 经验汇总。
- [Daotin/ai-coding 研究分析](daotin-ai-coding/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [earyantLe/vibe-coding-skill 研究域](earyantle-vibe-coding-skill/README.md) - Vibe Coding Skill / SOP 化。
- [earyantLe/vibe-coding-skill 研究分析](earyantle-vibe-coding-skill/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [liyupi/ai-guide 研究域](liyupi-ai-guide/README.md) - AI 资源大全与产品实用路线。
- [liyupi/ai-guide 研究分析](liyupi-ai-guide/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [RooCodeInc/Roo-Code 研究域](roocodeinc-roo-code/README.md) - 已归档多 Agent 编辑器工具;当前已归档,仅作参考。
- [RooCodeInc/Roo-Code 研究分析](roocodeinc-roo-code/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
- [wendy7756/vibe-coding-guide 研究域](wendy7756-vibe-coding-guide/README.md) - 非程序员自然语言编程指南。
- [wendy7756/vibe-coding-guide 研究分析](wendy7756-vibe-coding-guide/analysis.md) - 结构化研究结论、可借鉴点、风险和下一轮任务。
</details>
## 使用方式
- 评估新技术优秀 repo 时,先写 research。
- 评估新技术优秀 repo 或工程范式时,先写 research。
- 新增长期研究对象前,先按研究域治理契约判断它是否应该成为独立研究域,并用 `scripts/fetch-research-raw.py` 拉取原始材料。
- 外部仓库默认一仓库一研究域;横向比较只能放在索引或单独对比文档中。
- 对象会持续演化时,优先放入独立对象目录。
- 确认成熟后,再迁入更稳定的概念、参考或技能文档。
## 正文
@@ -0,0 +1,23 @@
# ai-for-developers/awesome-vibe-coding 研究域 Agent 指南
本目录维护 `ai-for-developers/awesome-vibe-coding` 的独立研究域。
## 目录职责
```text
ai-for-developers-awesome-vibe-coding/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层:仓库元数据、研究角色、来源证据
└── raw/ # 原始事实层:拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `ai-for-developers/awesome-vibe-coding`,不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`,并更新 `observed_at`
- `raw/` 保存原始事实层,必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件;稳定事实摘要再同步到 `domain.yml`
- README 只写判断、定位、使用方式和后续观察点,不堆外部 README 全文。
- 如果需要横向比较,在 `docs/research/README.md` 或新的对比文档中处理,不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc``make test`
@@ -0,0 +1,56 @@
# ai-for-developers/awesome-vibe-coding 研究域
## 字多不看
- 本目录研究 `ai-for-developers/awesome-vibe-coding` 这个外部仓库。
- 当前优先级:P3;研究角色:精选 Vibe Coding 资料清单。
- GitHub 动态事实放在 `domain.yml`,观测日期为 2026-07-03。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>
### 细粒度目录
- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
</details>
## 使用方式
- 先读本 README 的判断,再读 `analysis.md` 的结构化研究结论,最后读 `domain.yml` 的事实字段。
- 需要引用 stars、forks、release、归档状态时,先重新核验 GitHub。
- 如果形成稳定方法论,再迁入 concepts、references、workflow 或 skills。
## 正文
### 研究定位
`ai-for-developers/awesome-vibe-coding` 的当前研究定位是:精选 Vibe Coding 资料清单。
### 当前判断
适合作为 awesome-vibe-coding 的补充索引。
### 观察字段
- GitHub URLhttps://github.com/ai-for-developers/awesome-vibe-coding
- 当前研究方向:`ecosystem-index`
- 当前优先级:P3
- 当前归档状态:`false`
- 主要语言:`None`
### 后续观察
- 是否有稳定文档结构、命令入口和可复用工作流。
- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。
@@ -0,0 +1,44 @@
# ai-for-developers/awesome-vibe-coding 研究分析
## 本轮结论
- 这是轻量级 awesome list,价值在于补充 Vibe Coding 工具和资料的横向发现,不适合作为方法论主线。
- 仓库本体几乎只有 `readme.md`,说明它的核心资产是人工维护的分类索引,而不是可运行系统。
- 更适合作为外部资源发现源和分类词表来源,后续应把稳定条目沉淀到 `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 工作流定义。
## 可借鉴点
- 可借鉴它对 Vibe Coding 工具生态的分类标签,用于补充本仓外部资源注册表的 category 体系。
- 适合作为低频巡检对象:只提取新增高质量工具,不跟随每个条目做深度研究。
- 可用它校验本仓是否遗漏 Web builder、IDE、CLI、local app、plugin 等工具族。
## 风险和边界
- 没有机器可读数据源,质量依赖维护者手工更新。
- 缺少采用判断和风险说明,不能直接作为推荐清单。
- 条目多但深度浅,进入本仓前必须二次筛选。
## 下一轮研究任务
- 抽取其分类体系,与 `assets/external-resources/categories.yml` 做对照。
- 只选择与 coding agent、CLI、IDE agent 强相关的条目进入深度研究候选。
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
@@ -0,0 +1,46 @@
version: 1
repo:
name: ai-for-developers/awesome-vibe-coding
source_name: ai-for-developers/awesome-vibe-coding
url: https://github.com/ai-for-developers/awesome-vibe-coding
research:
domain_id: ai-for-developers-awesome-vibe-coding
domain_name: ai-for-developers/awesome-vibe-coding 研究域
primary_direction: ecosystem-index
role: 精选 Vibe Coding 资料清单
priority: 3
why_study: 适合作为 awesome-vibe-coding 的补充索引。
github_observed:
observed_at: '2026-07-03'
source: gh repo view
stars: 767
forks: 166
archived: false
language: null
license: null
default_branch: main
pushed_at: '2026-04-18T13:36:43Z'
updated_at: '2026-07-02T14:24:51Z'
latest_release: null
homepage: ''
topics:
- ai
- ai-app-builder
- ai-ide
- vibe
- vibe-coding
- vibecoding
- awesome-vibe-coding
- ai-agents
- ai-tools
- awesome-ai
- awesome-ai-tools
- awesome-list
- vibecode
- vibecoding-tool
source_evidence:
file: ChatGPT-中文Vibe Coding仓库 (2).md
line: 50
maintenance:
fact_policy: GitHub 动态字段只代表 observed_at 当日快照,更新结论前必须重新核验。
split_policy: 本目录已经是一等研究域;更深分析放入本目录新增文档。
@@ -0,0 +1,12 @@
# raw/ Agent 指南
本目录是 `ai-for-developers/awesome-vibe-coding` 的原始事实层。
## 维护规则
- 只保存从研究对象拉取的一手材料,不写分析判断。
- `repository/` 是本地 Git 工作树,刷新时由脚本 clone 或 fast-forward pull。
- 不手工改写 `*.raw.*` 文件内容;需要刷新时运行 `python3 scripts/fetch-research-raw.py`
- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
- 外部 README 原文必须保存为 `.txt`,避免本仓库 Markdown 链接检查误判。
- 分析、判断、采用建议和沉淀路径写回上一级 `README.md``analysis.md``decisions.md`
@@ -0,0 +1,16 @@
# raw 事实层
本目录保存 `ai-for-developers/awesome-vibe-coding` 的本地原始材料快照。
这里不写分析结论,只保存可复查的一手资料:
- `sources.yml`:来源清单、拉取时间、命令和文件状态。
- `repository/`Git 仓库工作树;本目录由 `.gitignore` 忽略,只作为本地研究材料。
- `github-repo.raw.json`GitHub 仓库元数据。
- `github-readme.raw.md.txt`GitHub README 原文快照。
- `github-license.raw.txt`GitHub license 原文快照;仓库无 license 时可能不存在。
- `github-root-contents.raw.json`:默认分支根目录内容快照。
- `github-languages.raw.json`GitHub language 统计快照。
- `github-latest-release.raw.json`:最新 release 快照;无 release 时可能不存在。
`repository/` 是外部源码快照,不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存,避免其中的外部相对链接被本仓库 Markdown 链接检查误判。
@@ -0,0 +1,177 @@
# Awesome Vibe Coding [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
> A hand-picked collection of tools and references for building software with the help of AI—through prompts, iterations, and exploration.
## Overview
This list focuses on tools and workflows where AI plays a central role in the development process. Instead of traditional coding, this approach emphasizes describing ideas, iterating quickly, and trusting the process—even when youre not sure where its headed.
*You can find a searchable, more detailed list on [AI For Developers](https://aifordevelopers.org)*
----
**Reach thousands of developers building with AI by sponsoring this list, our [newsletter](https://aifordevelopers.substack.com/) and [AI For Developers](https://aifordevelopers.org/). Contact us at [aifordevelopers.org/advertise](https://aifordevelopers.org/advertise)**
----
## Table of Contents
* [What is](#what-is)
* [Web-Based Builders](#web-based-builders)
* [Editors and IDEs](#editors-and-ides)
* [Mobile Tools](#mobile-tools)
* [Extensions & Plugins](#extensions--plugins)
* [Desktop & Local Apps](#desktop--local-apps)
* [CLI Tools](#cli-tools)
* [AI-Driven Task Management](#ai-driven-task-management)
* [Monitoring & Cost Tracking](#monitoring--cost-tracking)
* [Project Documentation](#project-documentation)
* [Articles & Updates](#articles--updates)
* [Contributing](#contributing)
---
## What is
* [Karpathy on the "vibe coding" mindset](https://x.com/karpathy/status/1886192184808149383) — Not traditional coding. More like shaping software through language and intuition.
* [AI Coding Guide by Automata](https://github.com/automata/aicodeguide) — A structured starting point for newcomers using AI-first development approaches.
---
## Web-Based Builders
* [Bolt.new](https://bolt.new/) — Rapidly prototype and launch web and mobile apps by prompting.
* [Lovable](https://lovable.dev/) — Full-stack applications from simple ideas.
* [Vercels v0](https://v0.dev/chat) — Helps design and implement UIs from natural language.
* [Capacity](https://capacity.so/) — Create production-ready web apps in minutes.
* [CHAI.new](https://chai.new) — Code and deploy AI agents with prompts.
* [Replit](https://replit.com/) — Type what you want and let the AI construct it.
* [Create](https://www.create.xyz/) — Converts text prompts into usable tools or websites.
* [Trickle](https://www.trickle.so/) — AI-based visual builder for websites and apps.
* [Tempo](https://www.tempo.new/) — Build React projects much faster through AI assistance.
* [Softgen](https://softgen.ai/) — Describe a concept and generate a working full-stack app.
* [Lazy AI](https://getlazy.ai/) — Enterprise-focused prompt-based application builder.
* [HeyBoss](https://www.heyboss.xyz/) — Generate functional websites quickly.
* [Creatr](https://getcreatr.com/) — Build landing pages and simple apps instantly.
* [Rork](https://rork.app/) — A tool focused on generating mobile apps.
* [Firebase Studio](https://studio.firebase.google.com/) — Google's take on agent-driven full-stack development.
* [Napkins](https://www.napkins.dev/) — Converts mockups or screenshots into working code.
* [HeroUI Chat](https://heroui.chat/) — Build interfaces without design expertise.
* [Rocket.new](https://www.rocket.new/) — Low-code experience for shipping apps.
* [embedible.io](https://embedible.io/) - AI that transforms your electronics ideas into working projects.
* [FlyPloy](https://flyploy.com/en) — A modern application deployment platform that simplifies global delivery with one-click deploys, Docker, and Kubernetes support. Ideal for launching AI-assisted applications in seconds.
* [MyVibe](https://myvibe.so/) — Instant deployment for AI-generated web apps. Publish via Claude Code skills or direct upload.
* [Rosebud AI](https://rosebud.ai) — Vibe coding platform for creating 3D games and interactive web apps with AI.
* [Forge](https://forge-web.rebaselabs.online/) — AI-powered full-stack app creator with BYOK (bring your own API key). Multi-stage pipeline: planning, architecture, code generation, and verification.
---
## Editors and IDEs
* [Windsurf](https://codeium.com/windsurf) — AI-focused development environment by Codeium.
* [Cursor](https://www.cursor.com/) — One of the most advanced AI-first code editors.
* [Zed](https://zed.dev/) — Built for real-time team collaboration with AI assistance.
* [Amazon Kiro](https://kiro.dev) — An AI-powered IDE from prototype to production.
---
## Mobile Tools
* [VibeCode](https://www.vibecodeapp.com/) — A mobile-first app creator powered by AI.
* [IM.codes](https://github.com/im4codes/imcodes) — Mobile/web control layer for Claude Code, Codex, Gemini CLI, and other terminal-based coding agents.
---
## Extensions & Plugins
* [Cline](https://cline.bot/) — Connects to your CLI and editor, interprets natural commands.
* [Roo Code](https://github.com/RooVetGit/Roo-Code) — An enhanced version of Cline.
* [avante.nvim](https://github.com/yetone/avante.nvim) — Neovim integration modeled after Cursors AI features.
* [Prompt Tower](https://github.com/backnotprop/prompt-tower) — A prompt creation interface supporting complex code blocks.
* [Augment Code](https://www.augmentcode.com/) — Tailored for navigating and working with large repositories.
* [Continue](https://github.com/continuedev/continue) — Build your own in-editor AI agents using plugins and rules.
* [GitHub Copilot](https://github.com/features/copilot) — Integrated assistant offering code suggestions, chats, and context-aware actions.
* [Amazon Q](https://aws.amazon.com/q/developer) — AWSs generative AI solution for developers.
* [Superdesign](https://www.superdesign.dev/) — AI design agent for fast UI iterations.
* [toprank](https://github.com/nowork-studio/toprank) — Open-source Claude Code plugin with 9 SEO and Google Ads skills. Connects Google Search Console, PageSpeed Insights, and Google Ads API; ships meta tag and schema markup fixes to WordPress/Strapi/Contentful/Ghost. MIT, 107⭐.
* [dbForge AI Assistant](https://www.devart.com/dbforge/ai-assistant/) - Integrated AI tool that generates, optimizes, explains, and fixes SQL queries.
* [Frontman](https://github.com/frontman-ai/frontman) — Open-source AI agent that lives in your browser — click any element, describe changes in plain English, and get real code edits with hot reload. Works with Next.js, Vite, and Astro.
* [Mysti](https://github.com/DeepMyst/Mysti) - Multi-agent AI coding assistant for VS Code with brainstorm mode. Supports Claude Code, Codex, Gemini, Cline, and GitHub Copilot.
* [AgentLint](https://github.com/0xmariowu/AgentLint) — 33 evidence-backed checks for AI-friendly repos — file structure, instruction quality, build setup, session continuity, security posture. Claude Code plugin.
---
## Desktop & Local Apps
* [Dyad](https://www.dyad.sh/) — A lightweight, local platform for creating AI-driven apps without depending on the cloud.
* [ClaudeCode Launchpad CLI](https://github.com/noambrand/kivun-terminal) — Windows & macOS installer and launcher for Claude Code. 2-minute setup: auto-installs Node.js, Git & Claude Code; adds a live two-line status bar (model, context %, usage limits), desktop shortcut with folder picker, and right-click "Open with ClaudeCode Launchpad CLI" context menu on Windows folders.
---
## CLI Tools
* [claude-code](https://github.com/anthropics/claude-code) — Works across codebases, provides explanations, automates tasks.
* [memov](https://github.com/memovai/memov) — Git-based, traceable memory layer for Claude Code.
* [aider](https://aider.chat/) — Code side-by-side with AI from your terminal.
* [Goose](https://block.github.io/goose/) — Local agent framework compatible with multiple models.
* [MyCoder.ai](https://github.com/drivecore/mycoder) — Modular agent with GitHub integration.
* [RA.Aid](https://github.com/ai-christianson/RA.Aid) — Task-based AI built with LangGraph.
* [CodeSelect](https://github.com/maynetee/codeselect) — Sends structured source context to LLMs.
* [OpenAI Codex CLI](https://github.com/openai/codex) — Experimental terminal assistant.
* [Gemini CLI](https://github.com/google-gemini/gemini-cli) — Terminal assistant built around Google Gemini.
* [ReviewCerberus](https://github.com/Kirill89/reviewcerberus) - Open-source AI code review tool for analyzing git branch differences with comprehensive security, performance, and quality analysis.
* [OpenPaw](https://github.com/daxaur/openpaw) — Turns Claude Code into a personal assistant with 38 skills for email, calendar, Spotify, smart home, and more.
* [Autohand Code CLI](https://github.com/autohandai/code-cli) — Self-evolving autonomous coding agent for the terminal with 40+ tools, multi-LLM support, and a modular skills system.
* [Bernstein](https://github.com/chernistry/bernstein) — Deterministic orchestrator for vibe coding at scale. Spawns parallel AI coding agents from a single goal, verifies with tests, auto-commits.
* [sober-coding](https://github.com/voidborne-d/sober-coding) — Vibe code quality analyzer. 27 checks across security, architecture, duplication, error handling, dependencies, testing, and dead code. Language-agnostic with fix suggestions and CI mode.
* [VibeGrid](https://github.com/jcanizalez/vibegrid) — Multi-agent terminal manager with task queues, workflow automation, and inline diff review.
---
## AI-Driven Task Management
* [Boomerang Tasks](https://docs.roocode.com/features/boomerang-tasks) — Automatically turns big ideas into task queues.
* [Claude Task Master](https://github.com/eyaltoledano/claude-task-master) — Compatible with popular AI IDEs, breaks down work into subtasks.
* [agent-hub](https://github.com/Dominic789654/agent-hub) — Local-first multitask board for routing, sequencing, and observing repo-local coding agents across projects.
---
## Monitoring & Cost Tracking
* [Budi](https://github.com/siropkin/budi) — Local-first cost analytics for AI coding agents. Tracks token usage and spend across Claude Code and Cursor.
---
## Project Documentation
* [CodeGuide](https://www.codeguide.dev/) — Tool that builds documentation for AI-built projects.
* [LynxPrompt](https://github.com/GeiserX/LynxPrompt) — Self-hostable AI config management platform for teams. Manages AGENTS.md, CLAUDE.md, .cursor/rules/, slash commands, and 30+ formats.
* [Claude Code Mastery](https://github.com/ShipWithAI/claude-code-mastery) — Structured course for mastering Claude Code workflows, including security, automation, and multi-agent patterns.
---
## Articles & Updates
* [Prompt Engineering for Developers](https://addyo.substack.com/p/the-prompt-engineering-playbook-for)
* [What Vibe Coding Actually Means](https://theconversation.com/what-is-vibe-coding-a-computer-scientist-explains-what-it-means-to-have-ai-write-computer-code-and-what-risks-that-can-entail-257172)
* [LLM Pair Programming](https://pmbanugo.me/blog/peer-programming-with-llms)
* [The Way of Code](https://www.thewayofcode.com/)
* [2025 Tooling Overview on LinkedIn](https://www.linkedin.com/pulse/state-vibe-coding-tools-may-2025-nufar-gaspar-x1znf)
* [Karpathy on Menus and Vibes](https://karpathy.bearblog.dev/vibe-coding-menugen/)
* [Fireship: Mindset Video](https://www.youtube.com/watch?v=Tw18-4U7mts)
* [Ars Technica on AI Development Futures](https://arstechnica.com/ai/2025/03/is-vibe-coding-with-ai-gnarly-or-reckless-maybe-some-of-both/)
* [The New Stack Everyone Can Program](https://thenewstack.io/vibe-coding-where-everyone-can-speak-computer-programming/)
* [NYTimes: Personal Vibe Coding Experience](https://www.nytimes.com/2025/02/27/technology/personaltech/vibecoding-ai-software-programming.html)
* [CodingButVibes What Is Vibe Coding](https://www.codingbutvibes.com/what-is-vibe-coding) — Practical breakdown of the vibe coding approach, with tool comparisons and real developer workflows.
* [Reddit: /r/vibecoding](https://www.reddit.com/r/vibecoding/)
* [Reddit: /r/ChatGPTCoding](https://www.reddit.com/r/ChatGPTCoding/)
* [Vibe Engineering](https://www.manning.com/books/vibe-engineering)
---
## Contributing
Found something interesting or built your own tool? Contributions are encouraged—see the [contribution guide](CONTRIBUTING.md) for details.
@@ -0,0 +1,67 @@
{
"createdAt": "2023-08-28T16:37:06Z",
"defaultBranchRef": {
"name": "main"
},
"description": "A hand-picked collection of tools and resources for Vibe Coding",
"forkCount": 166,
"homepageUrl": "",
"isArchived": false,
"isFork": false,
"isMirror": false,
"latestRelease": null,
"licenseInfo": null,
"nameWithOwner": "ai-for-developers/awesome-vibe-coding",
"primaryLanguage": null,
"pushedAt": "2026-04-18T13:36:43Z",
"repositoryTopics": [
{
"name": "ai"
},
{
"name": "ai-app-builder"
},
{
"name": "ai-ide"
},
{
"name": "vibe"
},
{
"name": "vibe-coding"
},
{
"name": "vibecoding"
},
{
"name": "awesome-vibe-coding"
},
{
"name": "ai-agents"
},
{
"name": "ai-tools"
},
{
"name": "awesome-ai"
},
{
"name": "awesome-ai-tools"
},
{
"name": "awesome-list"
},
{
"name": "vibecode"
},
{
"name": "vibecoding-tool"
}
],
"stargazerCount": 767,
"updatedAt": "2026-07-02T14:24:51Z",
"url": "https://github.com/ai-for-developers/awesome-vibe-coding",
"watchers": {
"totalCount": 17
}
}
@@ -0,0 +1,18 @@
[
{
"name": "readme.md",
"path": "readme.md",
"sha": "08caecc9ebbae72b39858e8b75913fa2299481a2",
"size": 12435,
"url": "https://api.github.com/repos/ai-for-developers/awesome-vibe-coding/contents/readme.md?ref=main",
"html_url": "https://github.com/ai-for-developers/awesome-vibe-coding/blob/main/readme.md",
"git_url": "https://api.github.com/repos/ai-for-developers/awesome-vibe-coding/git/blobs/08caecc9ebbae72b39858e8b75913fa2299481a2",
"download_url": "https://raw.githubusercontent.com/ai-for-developers/awesome-vibe-coding/main/readme.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/ai-for-developers/awesome-vibe-coding/contents/readme.md?ref=main",
"git": "https://api.github.com/repos/ai-for-developers/awesome-vibe-coding/git/blobs/08caecc9ebbae72b39858e8b75913fa2299481a2",
"html": "https://github.com/ai-for-developers/awesome-vibe-coding/blob/main/readme.md"
}
}
]
@@ -0,0 +1,39 @@
version: 1
domain_id: ai-for-developers-awesome-vibe-coding
object:
type: github_repository
name: ai-for-developers/awesome-vibe-coding
url: https://github.com/ai-for-developers/awesome-vibe-coding
pulled_at: '2026-07-02T22:47:14+00:00'
puller: scripts/fetch-research-raw.py
files:
- path: repository/
kind: git-working-tree
status: ok
source: 'git clone --depth=1 --single-branch --no-tags https://github.com/ai-for-developers/awesome-vibe-coding.git docs/research/ai-for-developers-awesome-vibe-coding/raw/repository'
- path: github-repo.raw.json
kind: repository-metadata
status: ok
source: 'gh repo view ai-for-developers/awesome-vibe-coding --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
- path: github-readme.raw.md.txt
kind: readme
status: ok
source: 'gh api repos/ai-for-developers/awesome-vibe-coding/readme -H Accept: application/vnd.github.raw'
- path: github-license.raw.txt
kind: license
status: missing_or_error
source: 'gh api repos/ai-for-developers/awesome-vibe-coding/license -H Accept: application/vnd.github.raw'
message: 'gh: Not Found (HTTP 404)'
- path: github-root-contents.raw.json
kind: root-contents
status: ok
source: 'gh api repos/ai-for-developers/awesome-vibe-coding/contents'
- path: github-languages.raw.json
kind: languages
status: ok
source: 'gh api repos/ai-for-developers/awesome-vibe-coding/languages'
- path: github-latest-release.raw.json
kind: latest-release
status: missing_or_error
source: 'gh api repos/ai-for-developers/awesome-vibe-coding/releases/latest'
message: 'gh: Not Found (HTTP 404)'
+26
View File
@@ -0,0 +1,26 @@
# Aider-AI/aider 研究域 Agent 指南
本目录维护 `Aider-AI/aider` 的独立研究域。
## 目录职责
```text
aider-ai-aider/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层:仓库元数据、研究角色、来源证据
├── analysis.md # L1 结构化研究结论、可借鉴点、风险和下一轮任务
├── deep-dive.md # L2 源码/结构深度研究、关键机制和可迁移模式
└── raw/ # 原始事实层:拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `Aider-AI/aider`,不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`,并更新 `observed_at`
- `raw/` 保存原始事实层,必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件;稳定事实摘要再同步到 `domain.yml`
- README 只写判断、定位、使用方式和后续观察点,不堆外部 README 全文。
- `analysis.md` 写 L1 结构化理解;`deep-dive.md` 写 L2 源码证据、关键机制和可迁移模式。
- 如果需要横向比较,在 `docs/research/README.md` 或新的对比文档中处理,不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc``make test`
+58
View File
@@ -0,0 +1,58 @@
# Aider-AI/aider 研究域
## 字多不看
- 本目录研究 `Aider-AI/aider` 这个外部仓库。
- 当前优先级:P1;研究角色:终端 AI 结对编程工具。
- GitHub 动态事实放在 `domain.yml`,观测日期为 2026-07-03。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
| [deep-dive.md](deep-dive.md) | L2 源码/结构深度研究、关键机制和可迁移模式。 |
| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>
### 细粒度目录
- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
- [deep-dive.md](deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
</details>
## 使用方式
- 先读本 README 的判断,再读 `analysis.md``deep-dive.md` 的研究结论,最后读 `domain.yml`
- 需要引用 stars、forks、release、归档状态时,先重新核验 GitHub。
- 如果形成稳定方法论,再迁入 concepts、references、workflow 或 skills。
## 正文
### 研究定位
`Aider-AI/aider` 的当前研究定位是:终端 AI 结对编程工具。
### 当前判断
适合研究 Git 友好、模型无关、终端工作流和真实 repo 修改。
### 观察字段
- GitHub URLhttps://github.com/Aider-AI/aider
- 当前研究方向:`coding-agent-tooling`
- 当前优先级:P1
- 当前归档状态:`false`
- 主要语言:`Python`
### 后续观察
- 是否有稳定文档结构、命令入口和可复用工作流。
- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。
+44
View File
@@ -0,0 +1,44 @@
# Aider-AI/aider 研究分析
## 本轮结论
- Aider 是成熟的终端 AI 结对编程工具,核心价值在 Git 友好、本地仓库理解、多模型适配和测试/提交闭环。
- 它不是 IDE 产品,而是 terminal-first 的 repo editing loop;这让它特别适合研究“AI 如何安全修改真实仓库”。
- 本仓应重点吸收它的 Git 工作流、repo map、lint/test 反馈循环和命令行交互边界。
## 本地证据
- 研究对象:`Aider-AI/aider`
- 当前研究角色:终端 AI 结对编程工具
- 本轮成熟度:L1 初步理解
- 原始仓库:`raw/repository/`
- 原始来源清单:`raw/sources.yml`
- 事实摘要:`domain.yml`
## 结构观察
- 根目录包含 `aider/``benchmark/``tests/``scripts/``requirements/``pyproject.toml`
- `aider/` 是主实现目录,`tests/``benchmark/` 说明它不仅是演示工具,而是有持续验证和性能/能力评估意识。
- README 强调 cloud/local LLM、codebase map、Git integration、linting/testing、copy/paste to web chat 等能力。
## 可借鉴点
- 把 Git 状态作为 AI 修改的核心护栏:每轮修改都能被 diff、commit、回滚和审查。
- 把测试和 lint 作为对话内反馈,而不是任务结束后的附属动作。
- 终端工具可以避免复杂 UI,但必须把 repo context、命令回显和失败恢复做扎实。
## 风险和边界
- 终端优先意味着非程序员上手门槛高于 IDE 插件。
- 多模型和多语言支持会带来配置面复杂度。
- 其很多文档在官网侧,研究时要同步看本地源码和外部文档。
## 下一轮研究任务
- 重点阅读 `aider/` 的 repo map、Git 操作和 test/lint 调用路径。
- 把 Aider 的 terminal loop 抽象为本仓 `workflow/` 可复用闭环。
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
+88
View File
@@ -0,0 +1,88 @@
# Aider-AI/aider 深度研究
## 研究级别
- 当前级别:L2 源码/结构深度研究。
- 研究对象:`Aider-AI/aider`
- 证据来源:本目录 `raw/` 下的 GitHub 元数据、README 快照和本地仓库工作树。
- 观察日期:2026-07-03。
## L2 结论
`Aider-AI/aider` 的核心不是“聊天式写代码”,而是终端里的 Git 驱动编辑循环。它把仓库状态、
代码上下文、编辑格式、命令执行、lint/test、模型配置和用户交互拆成独立模块,让 agent 的每次
修改都尽量落在可 diff、可回滚、可验证的 Git 工作流中。
对本仓最重要的启发是:AI 编码工具的质量边界,主要由编辑协议、仓库上下文选择、验证门禁和
Git 状态管理决定,而不是由提示词长短决定。
## 源码证据
- `raw/repository/aider/main.py`:CLI 主入口,负责把参数、模型、仓库和交互流程组装起来。
- `raw/repository/aider/args.py`:参数层,说明用户可控配置是产品接口的一部分。
- `raw/repository/aider/repo.py`:Git 仓库状态层,承载 diff、commit、dirty state 等行为。
- `raw/repository/aider/repomap.py`:仓库地图层,负责从代码库中压缩可用上下文。
- `raw/repository/aider/commands.py`:命令系统,承载终端内的人机交互入口。
- `raw/repository/aider/run_cmd.py`:本地命令执行层,连接 AI 建议和真实环境。
- `raw/repository/aider/linter.py`:lint 反馈层,把工具结果变成修复循环的一部分。
- `raw/repository/aider/models.py`:模型配置层,说明多模型支持需要独立治理。
- `raw/repository/aider/sendchat.py`:模型调用层,连接上下文、消息和模型响应。
- `raw/repository/aider/coders/base_coder.py`:coder 抽象基类,定义编辑策略共同边界。
- `raw/repository/aider/coders/architect_coder.py`:架构/规划型 coder。
- `raw/repository/aider/coders/editblock_coder.py`:基于 edit block 的局部编辑策略。
- `raw/repository/aider/coders/udiff_coder.py`:基于 unified diff 的编辑策略。
- `raw/repository/aider/coders/patch_coder.py`:基于 patch 的编辑策略。
- `raw/repository/tests/`:测试层,覆盖命令、仓库、lint、repo map 和核心工作流。
## 关键机制
### Git 是工作流中心
Aider 把 Git 状态放在核心位置。它不是让 AI 随意改文件,而是围绕当前仓库、diff、commit、
脏工作树和可回滚状态组织工作。这一点适合所有 coding agent:写代码只是动作,Git 才是
工程协作的事实边界。
### 编辑格式是产品接口
`coders/` 中存在多种 coderwhole file、edit block、unified diff、patch、architect 等。
这说明“AI 如何表达修改”不是实现细节,而是影响可靠性、可审查性和失败模式的产品接口。
### repo map 是上下文压缩层
`repomap.py` 体现了一个关键设计:大仓库不能简单把所有文件塞进上下文,必须有面向任务的结构化
摘要和检索策略。上下文质量决定修改质量,垃圾上下文会直接制造垃圾结果。
### lint/test 是反馈回路
`linter.py``run_cmd.py` 和测试目录说明 Aider 将工具反馈接入循环。成熟 agent 不只是生成补丁,
还要能读取失败、缩小范围、再次修复。
## 可迁移模式
- 将“编辑格式”视为正式协议:全文件、diff、patch、结构化 block 的适用边界要写清楚。
- 将 Git 状态作为 AI 修改的事实源:修改前检查 dirty state,修改后保留 diff 和验证证据。
- 为大文档/大仓库建立 repo map 或文档 map,而不是让 AI 盲读整个仓库。
- 把 lint、test、link check 和脚本校验结果作为修复循环输入。
- 对不同任务区分规划型、编辑型、审查型和问答型 agent 行为。
## 对本仓的影响
本仓现在已经有 Markdown 门禁、链接检查、raw 研究域和 AI 引用入口。Aider 的模式提醒我们:
- 文档修改也需要 Git 状态意识,避免把用户未提交修改误当作自己的改动。
- 大量 Markdown 文档需要“文档地图”,否则索引和引用会漂移。
- 研究域 L2/L3 产物应当可 diff、可审查、可回滚,而不是只在对话里口头总结。
- 提交前门禁应继续保持 `make test` 的统一入口。
## 风险和待验证项
- 本轮只做源码结构研究,没有运行 Aider 的测试套件或交互流程。
- Aider 的 Python 实现细节不应被本仓直接复制;本仓主要迁移工作流和治理边界。
- 不同编辑格式的真实成功率需要通过任务集 benchmark 验证,不能只靠结构判断。
## 下一步 L3 验证任务
- 为本仓建立“文档地图/研究地图”的生成或校验机制,降低长文档索引漂移。
- 把 Git dirty state、门禁命令和验证证据纳入研究域 closeout 模板。
-`docs/workflow/` 沉淀“AI 修改 -> diff 审查 -> 门禁 -> 提交”的最小闭环。
- 对本仓常见 Markdown 修改任务设计小型 benchmark,比较全文件编辑和局部 patch 的稳定性。
+45
View File
@@ -0,0 +1,45 @@
version: 1
repo:
name: Aider-AI/aider
source_name: aider-ai/aider
url: https://github.com/Aider-AI/aider
research:
domain_id: aider-ai-aider
domain_name: Aider-AI/aider 研究域
primary_direction: coding-agent-tooling
role: 终端 AI 结对编程工具
priority: 1
why_study: 适合研究 Git 友好、模型无关、终端工作流和真实 repo 修改。
github_observed:
observed_at: '2026-07-03'
source: gh repo view
stars: 46962
forks: 4680
archived: false
language: Python
license: apache-2.0
default_branch: main
pushed_at: '2026-05-22T14:02:20Z'
updated_at: '2026-07-02T21:52:05Z'
latest_release: v0.86.0
homepage: https://aider.chat/
topics:
- chatgpt
- cli
- command-line
- gpt-4
- openai
- gpt-3
- gpt-35-turbo
- claude-3
- gpt-4o
- anthropic
- gemini
- llama
- sonnet
source_evidence:
file: ChatGPT-中文Vibe Coding仓库 (2).md
line: 57
maintenance:
fact_policy: GitHub 动态字段只代表 observed_at 当日快照,更新结论前必须重新核验。
split_policy: 本目录已经是一等研究域;更深分析放入本目录新增文档。
@@ -0,0 +1,12 @@
# raw/ Agent 指南
本目录是 `Aider-AI/aider` 的原始事实层。
## 维护规则
- 只保存从研究对象拉取的一手材料,不写分析判断。
- `repository/` 是本地 Git 工作树,刷新时由脚本 clone 或 fast-forward pull。
- 不手工改写 `*.raw.*` 文件内容;需要刷新时运行 `python3 scripts/fetch-research-raw.py`
- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
- 外部 README 原文必须保存为 `.txt`,避免本仓库 Markdown 链接检查误判。
- 分析、判断、采用建议和沉淀路径写回上一级 `README.md``analysis.md``decisions.md`
@@ -0,0 +1,16 @@
# raw 事实层
本目录保存 `Aider-AI/aider` 的本地原始材料快照。
这里不写分析结论,只保存可复查的一手资料:
- `sources.yml`:来源清单、拉取时间、命令和文件状态。
- `repository/`Git 仓库工作树;本目录由 `.gitignore` 忽略,只作为本地研究材料。
- `github-repo.raw.json`GitHub 仓库元数据。
- `github-readme.raw.md.txt`GitHub README 原文快照。
- `github-license.raw.txt`GitHub license 原文快照;仓库无 license 时可能不存在。
- `github-root-contents.raw.json`:默认分支根目录内容快照。
- `github-languages.raw.json`GitHub language 统计快照。
- `github-latest-release.raw.json`:最新 release 快照;无 release 时可能不存在。
`repository/` 是外部源码快照,不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存,避免其中的外部相对链接被本仓库 Markdown 链接检查误判。
@@ -0,0 +1,12 @@
{
"Python": 1333453,
"CSS": 67532,
"Shell": 66537,
"Tree-sitter Query": 64845,
"JavaScript": 60909,
"HTML": 44976,
"PowerShell": 19648,
"Dockerfile": 4405,
"SCSS": 1957,
"Ruby": 196
}
@@ -0,0 +1,54 @@
{
"url": "https://api.github.com/repos/Aider-AI/aider/releases/238790002",
"assets_url": "https://api.github.com/repos/Aider-AI/aider/releases/238790002/assets",
"upload_url": "https://uploads.github.com/repos/Aider-AI/aider/releases/238790002/assets{?name,label}",
"html_url": "https://github.com/Aider-AI/aider/releases/tag/v0.86.0",
"id": 238790002,
"author": {
"login": "paul-gauthier",
"id": 69695708,
"node_id": "MDQ6VXNlcjY5Njk1NzA4",
"avatar_url": "https://avatars.githubusercontent.com/u/69695708?v=4",
"gravatar_id": "",
"url": "https://api.github.com/users/paul-gauthier",
"html_url": "https://github.com/paul-gauthier",
"followers_url": "https://api.github.com/users/paul-gauthier/followers",
"following_url": "https://api.github.com/users/paul-gauthier/following{/other_user}",
"gists_url": "https://api.github.com/users/paul-gauthier/gists{/gist_id}",
"starred_url": "https://api.github.com/users/paul-gauthier/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/paul-gauthier/subscriptions",
"organizations_url": "https://api.github.com/users/paul-gauthier/orgs",
"repos_url": "https://api.github.com/users/paul-gauthier/repos",
"events_url": "https://api.github.com/users/paul-gauthier/events{/privacy}",
"received_events_url": "https://api.github.com/users/paul-gauthier/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false
},
"node_id": "RE_kwDOJhC06c4OO6Vy",
"tag_name": "v0.86.0",
"target_commitish": "main",
"name": "Aider v0.86.0",
"draft": false,
"immutable": false,
"prerelease": false,
"created_at": "2025-08-09T15:54:51Z",
"updated_at": "2025-08-09T17:42:19Z",
"published_at": "2025-08-09T17:42:19Z",
"assets": [],
"tarball_url": "https://api.github.com/repos/Aider-AI/aider/tarball/v0.86.0",
"zipball_url": "https://api.github.com/repos/Aider-AI/aider/zipball/v0.86.0",
"body": "- Added support for all GPT-5 models.\r\n- Added support for Grok-4 via `xai/grok-4` and `openrouter/x-ai/grok-4` model names.\r\n- Added support for `gemini/gemini-2.5-flash-lite-preview-06-17` model, by Tamir Zahavi-Brunner.\r\n- `/clear` now prints “All chat history cleared.” so you know it worked, by Zexin Yuan.\r\n- `/undo` output now shows only the first line of each commit message, making it easier to read.\r\n- Added support for `openrouter/moonshotai/kimi-k2` model, by Jack Harrington.\r\n- Display model announcements with no-arg `/model` command.\r\n- Fixed an issue where new settings for an existing model didn't replace the old ones, by Andrew Grigorev.\r\n- Fixed analytics to support the latest PostHog SDK event-capture API.\r\n- Bumped dependencies to pick up latest litellm==1.75.0.\r\n\r\n- Aider wrote 88% of the code in this release.",
"reactions": {
"url": "https://api.github.com/repos/Aider-AI/aider/releases/238790002/reactions",
"total_count": 51,
"+1": 0,
"-1": 0,
"laugh": 0,
"hooray": 0,
"confused": 0,
"heart": 2,
"rocket": 46,
"eyes": 3
}
}
@@ -0,0 +1,202 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
@@ -0,0 +1,180 @@
<p align="center">
<a href="https://aider.chat/"><img src="https://aider.chat/assets/logo.svg" alt="Aider Logo" width="300"></a>
</p>
<h1 align="center">
AI Pair Programming in Your Terminal
</h1>
<p align="center">
Aider lets you pair program with LLMs to start a new project or build on your existing codebase.
</p>
<p align="center">
<img
src="https://aider.chat/assets/screencast.svg"
alt="aider screencast"
>
</p>
<p align="center">
<!--[[[cog
from scripts.homepage import get_badges_md
text = get_badges_md()
cog.out(text)
]]]-->
<a href="https://github.com/Aider-AI/aider/stargazers"><img alt="GitHub Stars" title="Total number of GitHub stars the Aider project has received"
src="https://img.shields.io/github/stars/Aider-AI/aider?style=flat-square&logo=github&color=f1c40f&labelColor=555555"/></a>
<a href="https://pypi.org/project/aider-chat/"><img alt="PyPI Downloads" title="Total number of installations via pip from PyPI"
src="https://img.shields.io/badge/📦%20Installs-6.8M-2ecc71?style=flat-square&labelColor=555555"/></a>
<img alt="Tokens per week" title="Number of tokens processed weekly by Aider users"
src="https://img.shields.io/badge/📈%20Tokens%2Fweek-15B-3498db?style=flat-square&labelColor=555555"/>
<a href="https://openrouter.ai/#options-menu"><img alt="OpenRouter Ranking" title="Aider's ranking among applications on the OpenRouter platform"
src="https://img.shields.io/badge/🏆%20OpenRouter-Top%2020-9b59b6?style=flat-square&labelColor=555555"/></a>
<a href="https://aider.chat/HISTORY.html"><img alt="Singularity" title="Percentage of the new code in Aider's last release written by Aider itself"
src="https://img.shields.io/badge/🔄%20Singularity-88%25-e74c3c?style=flat-square&labelColor=555555"/></a>
<!--[[[end]]]-->
</p>
## Features
### [Cloud and local LLMs](https://aider.chat/docs/llms.html)
<a href="https://aider.chat/docs/llms.html"><img src="https://aider.chat/assets/icons/brain.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Aider works best with Claude 3.7 Sonnet, DeepSeek R1 & Chat V3, OpenAI o1, o3-mini & GPT-4o, but can connect to almost any LLM, including local models.
<br>
### [Maps your codebase](https://aider.chat/docs/repomap.html)
<a href="https://aider.chat/docs/repomap.html"><img src="https://aider.chat/assets/icons/map-outline.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Aider makes a map of your entire codebase, which helps it work well in larger projects.
<br>
### [100+ code languages](https://aider.chat/docs/languages.html)
<a href="https://aider.chat/docs/languages.html"><img src="https://aider.chat/assets/icons/code-tags.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Aider works with most popular programming languages: python, javascript, rust, ruby, go, cpp, php, html, css, and dozens more.
<br>
### [Git integration](https://aider.chat/docs/git.html)
<a href="https://aider.chat/docs/git.html"><img src="https://aider.chat/assets/icons/source-branch.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Aider automatically commits changes with sensible commit messages. Use familiar git tools to easily diff, manage and undo AI changes.
<br>
### [Use in your IDE](https://aider.chat/docs/usage/watch.html)
<a href="https://aider.chat/docs/usage/watch.html"><img src="https://aider.chat/assets/icons/monitor.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Use aider from within your favorite IDE or editor. Ask for changes by adding comments to your code and aider will get to work.
<br>
### [Images & web pages](https://aider.chat/docs/usage/images-urls.html)
<a href="https://aider.chat/docs/usage/images-urls.html"><img src="https://aider.chat/assets/icons/image-multiple.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Add images and web pages to the chat to provide visual context, screenshots, reference docs, etc.
<br>
### [Voice-to-code](https://aider.chat/docs/usage/voice.html)
<a href="https://aider.chat/docs/usage/voice.html"><img src="https://aider.chat/assets/icons/microphone.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Speak with aider about your code! Request new features, test cases or bug fixes using your voice and let aider implement the changes.
<br>
### [Linting & testing](https://aider.chat/docs/usage/lint-test.html)
<a href="https://aider.chat/docs/usage/lint-test.html"><img src="https://aider.chat/assets/icons/check-all.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Automatically lint and test your code every time aider makes changes. Aider can fix problems detected by your linters and test suites.
<br>
### [Copy/paste to web chat](https://aider.chat/docs/usage/copypaste.html)
<a href="https://aider.chat/docs/usage/copypaste.html"><img src="https://aider.chat/assets/icons/content-copy.svg" width="32" height="32" align="left" valign="middle" style="margin-right:10px"></a>
Work with any LLM via its web chat interface. Aider streamlines copy/pasting code context and edits back and forth with a browser.
## Getting Started
```bash
python -m pip install aider-install
aider-install
# Change directory into your codebase
cd /to/your/project
# DeepSeek
aider --model deepseek --api-key deepseek=<key>
# Claude 3.7 Sonnet
aider --model sonnet --api-key anthropic=<key>
# o3-mini
aider --model o3-mini --api-key openai=<key>
```
See the [installation instructions](https://aider.chat/docs/install.html) and [usage documentation](https://aider.chat/docs/usage.html) for more details.
## More Information
### Documentation
- [Installation Guide](https://aider.chat/docs/install.html)
- [Usage Guide](https://aider.chat/docs/usage.html)
- [Tutorial Videos](https://aider.chat/docs/usage/tutorials.html)
- [Connecting to LLMs](https://aider.chat/docs/llms.html)
- [Configuration Options](https://aider.chat/docs/config.html)
- [Troubleshooting](https://aider.chat/docs/troubleshooting.html)
- [FAQ](https://aider.chat/docs/faq.html)
### Community & Resources
- [LLM Leaderboards](https://aider.chat/docs/leaderboards/)
- [GitHub Repository](https://github.com/Aider-AI/aider)
- [Discord Community](https://discord.gg/Y7X7bhMQFV)
- [Release notes](https://aider.chat/HISTORY.html)
- [Blog](https://aider.chat/blog/)
## Kind Words From Users
- *"My life has changed... Aider... It's going to rock your world."* — [Eric S. Raymond on X](https://x.com/esrtweet/status/1910809356381413593)
- *"The best free open source AI coding assistant."* — [IndyDevDan on YouTube](https://youtu.be/YALpX8oOn78)
- *"The best AI coding assistant so far."* — [Matthew Berman on YouTube](https://www.youtube.com/watch?v=df8afeb1FY8)
- *"Aider ... has easily quadrupled my coding productivity."* — [SOLAR_FIELDS on Hacker News](https://news.ycombinator.com/item?id=36212100)
- *"It's a cool workflow... Aider's ergonomics are perfect for me."* — [qup on Hacker News](https://news.ycombinator.com/item?id=38185326)
- *"It's really like having your senior developer live right in your Git repo - truly amazing!"* — [rappster on GitHub](https://github.com/Aider-AI/aider/issues/124)
- *"What an amazing tool. It's incredible."* — [valyagolev on GitHub](https://github.com/Aider-AI/aider/issues/6#issue-1722897858)
- *"Aider is such an astounding thing!"* — [cgrothaus on GitHub](https://github.com/Aider-AI/aider/issues/82#issuecomment-1631876700)
- *"It was WAY faster than I would be getting off the ground and making the first few working versions."* — [Daniel Feldman on X](https://twitter.com/d_feldman/status/1662295077387923456)
- *"THANK YOU for Aider! It really feels like a glimpse into the future of coding."* — [derwiki on Hacker News](https://news.ycombinator.com/item?id=38205643)
- *"It's just amazing. It is freeing me to do things I felt were out my comfort zone before."* — [Dougie on Discord](https://discord.com/channels/1131200896827654144/1174002618058678323/1174084556257775656)
- *"This project is stellar."* — [funkytaco on GitHub](https://github.com/Aider-AI/aider/issues/112#issuecomment-1637429008)
- *"Amazing project, definitely the best AI coding assistant I've used."* — [joshuavial on GitHub](https://github.com/Aider-AI/aider/issues/84)
- *"I absolutely love using Aider ... It makes software development feel so much lighter as an experience."* — [principalideal0 on Discord](https://discord.com/channels/1131200896827654144/1133421607499595858/1229689636012691468)
- *"I have been recovering from ... surgeries ... aider ... has allowed me to continue productivity."* — [codeninja on Reddit](https://www.reddit.com/r/OpenAI/s/nmNwkHy1zG)
- *"I am an aider addict. I'm getting so much more work done, but in less time."* — [dandandan on Discord](https://discord.com/channels/1131200896827654144/1131200896827654149/1135913253483069470)
- *"Aider... blows everything else out of the water hands down, there's no competition whatsoever."* — [SystemSculpt on Discord](https://discord.com/channels/1131200896827654144/1131200896827654149/1178736602797846548)
- *"Aider is amazing, coupled with Sonnet 3.5 it's quite mind blowing."* — [Josh Dingus on Discord](https://discord.com/channels/1131200896827654144/1133060684540813372/1262374225298198548)
- *"Hands down, this is the best AI coding assistant tool so far."* — [IndyDevDan on YouTube](https://www.youtube.com/watch?v=MPYFPvxfGZs)
- *"[Aider] changed my daily coding workflows. It's mind-blowing how ...(it)... can change your life."* — [maledorak on Discord](https://discord.com/channels/1131200896827654144/1131200896827654149/1258453375620747264)
- *"Best agent for actual dev work in existing codebases."* — [Nick Dobos on X](https://twitter.com/NickADobos/status/1690408967963652097?s=20)
- *"One of my favorite pieces of software. Blazing trails on new paradigms!"* — [Chris Wall on X](https://x.com/chris65536/status/1905053299251798432)
- *"Aider has been revolutionary for me and my work."* — [Starry Hope on X](https://x.com/starryhopeblog/status/1904985812137132056)
- *"Try aider! One of the best ways to vibe code."* — [Chris Wall on X](https://x.com/Chris65536/status/1905053418961391929)
- *"Freaking love Aider."* — [hztar on Hacker News](https://news.ycombinator.com/item?id=44035015)
- *"Aider is hands down the best. And it's free and opensource."* — [AriyaSavakaLurker on Reddit](https://www.reddit.com/r/ChatGPTCoding/comments/1ik16y6/whats_your_take_on_aider/mbip39n/)
- *"Aider is also my best friend."* — [jzn21 on Reddit](https://www.reddit.com/r/ChatGPTCoding/comments/1heuvuo/aider_vs_cline_vs_windsurf_vs_cursor/m27dcnb/)
- *"Try Aider, it's worth it."* — [jorgejhms on Reddit](https://www.reddit.com/r/ChatGPTCoding/comments/1heuvuo/aider_vs_cline_vs_windsurf_vs_cursor/m27cp99/)
- *"I like aider :)"* — [Chenwei Cui on X](https://x.com/ccui42/status/1904965344999145698)
- *"Aider is the precision tool of LLM code gen... Minimal, thoughtful and capable of surgical changes ... while keeping the developer in control."* — [Reilly Sweetland on X](https://x.com/rsweetland/status/1904963807237259586)
- *"Cannot believe aider vibe coded a 650 LOC feature across service and cli today in 1 shot."* - [autopoietist on Discord](https://discord.com/channels/1131200896827654144/1131200896827654149/1355675042259796101)
- *"Oh no the secret is out! Yes, Aider is the best coding tool around. I highly, highly recommend it to anyone."* — [Joshua D Vander Hook on X](https://x.com/jodavaho/status/1911154899057795218)
- *"thanks to aider, i have started and finished three personal projects within the last two days"* — [joseph stalzyn on X](https://x.com/anitaheeder/status/1908338609645904160)
- *"Been using aider as my daily driver for over a year ... I absolutely love the tool, like beyond words."* — [koleok on Discord](https://discord.com/channels/1131200896827654144/1273248471394291754/1356727448372252783)
- *"Aider ... is the tool to benchmark against."* — [BeetleB on Hacker News](https://news.ycombinator.com/item?id=43930201)
- *"aider is really cool"* — [kache on X](https://x.com/yacineMTB/status/1911224442430124387)
@@ -0,0 +1,75 @@
{
"createdAt": "2023-05-09T18:57:49Z",
"defaultBranchRef": {
"name": "main"
},
"description": "aider is AI pair programming in your terminal",
"forkCount": 4680,
"homepageUrl": "https://aider.chat/",
"isArchived": false,
"isFork": false,
"isMirror": false,
"latestRelease": {
"name": "Aider v0.86.0",
"publishedAt": "2025-08-09T17:42:19Z",
"tagName": "v0.86.0",
"url": "https://github.com/Aider-AI/aider/releases/tag/v0.86.0"
},
"licenseInfo": {
"key": "apache-2.0",
"name": "Apache License 2.0",
"nickname": ""
},
"nameWithOwner": "Aider-AI/aider",
"primaryLanguage": {
"name": "Python"
},
"pushedAt": "2026-05-22T14:02:20Z",
"repositoryTopics": [
{
"name": "chatgpt"
},
{
"name": "cli"
},
{
"name": "command-line"
},
{
"name": "gpt-4"
},
{
"name": "openai"
},
{
"name": "gpt-3"
},
{
"name": "gpt-35-turbo"
},
{
"name": "claude-3"
},
{
"name": "gpt-4o"
},
{
"name": "anthropic"
},
{
"name": "gemini"
},
{
"name": "llama"
},
{
"name": "sonnet"
}
],
"stargazerCount": 46962,
"updatedAt": "2026-07-02T21:52:05Z",
"url": "https://github.com/Aider-AI/aider",
"watchers": {
"totalCount": 255
}
}
@@ -0,0 +1,322 @@
[
{
"name": ".dockerignore",
"path": ".dockerignore",
"sha": "830cf8498c3b82005ac8c599502f838ed190e0f0",
"size": 61,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/.dockerignore?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/.dockerignore",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/830cf8498c3b82005ac8c599502f838ed190e0f0",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/.dockerignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/.dockerignore?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/830cf8498c3b82005ac8c599502f838ed190e0f0",
"html": "https://github.com/Aider-AI/aider/blob/main/.dockerignore"
}
},
{
"name": ".flake8",
"path": ".flake8",
"sha": "3963261f7b7c8706945140ca6891638e51980353",
"size": 50,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/.flake8?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/.flake8",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/3963261f7b7c8706945140ca6891638e51980353",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/.flake8",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/.flake8?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/3963261f7b7c8706945140ca6891638e51980353",
"html": "https://github.com/Aider-AI/aider/blob/main/.flake8"
}
},
{
"name": ".github",
"path": ".github",
"sha": "30b8800114cd6523ecfd9ff7809de59b385e0631",
"size": 0,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/.github?ref=main",
"html_url": "https://github.com/Aider-AI/aider/tree/main/.github",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/trees/30b8800114cd6523ecfd9ff7809de59b385e0631",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/.github?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/trees/30b8800114cd6523ecfd9ff7809de59b385e0631",
"html": "https://github.com/Aider-AI/aider/tree/main/.github"
}
},
{
"name": ".gitignore",
"path": ".gitignore",
"sha": "fd1fa9a4da7f765e7a9c3515d329d9e7860b552c",
"size": 239,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/.gitignore?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/.gitignore",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/fd1fa9a4da7f765e7a9c3515d329d9e7860b552c",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/.gitignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/.gitignore?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/fd1fa9a4da7f765e7a9c3515d329d9e7860b552c",
"html": "https://github.com/Aider-AI/aider/blob/main/.gitignore"
}
},
{
"name": ".pre-commit-config.yaml",
"path": ".pre-commit-config.yaml",
"sha": "ca81b8a7339e47023be3ddac1babed2006f95fd6",
"size": 602,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/.pre-commit-config.yaml?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/.pre-commit-config.yaml",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/ca81b8a7339e47023be3ddac1babed2006f95fd6",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/.pre-commit-config.yaml",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/.pre-commit-config.yaml?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/ca81b8a7339e47023be3ddac1babed2006f95fd6",
"html": "https://github.com/Aider-AI/aider/blob/main/.pre-commit-config.yaml"
}
},
{
"name": "CNAME",
"path": "CNAME",
"sha": "83254ef2d2bd88ccafab3613c8c312d551b37ef3",
"size": 10,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/CNAME?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/CNAME",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/83254ef2d2bd88ccafab3613c8c312d551b37ef3",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/CNAME",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/CNAME?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/83254ef2d2bd88ccafab3613c8c312d551b37ef3",
"html": "https://github.com/Aider-AI/aider/blob/main/CNAME"
}
},
{
"name": "CONTRIBUTING.md",
"path": "CONTRIBUTING.md",
"sha": "abe35a1c0ee51421144b4513149c63068ade2af0",
"size": 7863,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/CONTRIBUTING.md?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/CONTRIBUTING.md",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/abe35a1c0ee51421144b4513149c63068ade2af0",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/CONTRIBUTING.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/CONTRIBUTING.md?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/abe35a1c0ee51421144b4513149c63068ade2af0",
"html": "https://github.com/Aider-AI/aider/blob/main/CONTRIBUTING.md"
}
},
{
"name": "HISTORY.md",
"path": "HISTORY.md",
"sha": "3d523bdccde17e21b8a5f466a7f8b58b56ca5ad1",
"size": 77044,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/HISTORY.md?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/HISTORY.md",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/3d523bdccde17e21b8a5f466a7f8b58b56ca5ad1",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/HISTORY.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/HISTORY.md?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/3d523bdccde17e21b8a5f466a7f8b58b56ca5ad1",
"html": "https://github.com/Aider-AI/aider/blob/main/HISTORY.md"
}
},
{
"name": "LICENSE.txt",
"path": "LICENSE.txt",
"sha": "d645695673349e3947e8e5ae42332d0ac3164cd7",
"size": 11358,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/LICENSE.txt?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/LICENSE.txt",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/d645695673349e3947e8e5ae42332d0ac3164cd7",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/LICENSE.txt",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/LICENSE.txt?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/d645695673349e3947e8e5ae42332d0ac3164cd7",
"html": "https://github.com/Aider-AI/aider/blob/main/LICENSE.txt"
}
},
{
"name": "MANIFEST.in",
"path": "MANIFEST.in",
"sha": "9ab273215b7a269aacce50c21dd746cdb6700b70",
"size": 588,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/MANIFEST.in?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/MANIFEST.in",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/9ab273215b7a269aacce50c21dd746cdb6700b70",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/MANIFEST.in",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/MANIFEST.in?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/9ab273215b7a269aacce50c21dd746cdb6700b70",
"html": "https://github.com/Aider-AI/aider/blob/main/MANIFEST.in"
}
},
{
"name": "README.md",
"path": "README.md",
"sha": "816c876cb67021fa9f8d37267c8e57923eabdb07",
"size": 12406,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/README.md?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/README.md",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/816c876cb67021fa9f8d37267c8e57923eabdb07",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/README.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/README.md?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/816c876cb67021fa9f8d37267c8e57923eabdb07",
"html": "https://github.com/Aider-AI/aider/blob/main/README.md"
}
},
{
"name": "aider",
"path": "aider",
"sha": "38f181379921560c25c44d3c73ed45f7c6a08b4e",
"size": 0,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/aider?ref=main",
"html_url": "https://github.com/Aider-AI/aider/tree/main/aider",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/trees/38f181379921560c25c44d3c73ed45f7c6a08b4e",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/aider?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/trees/38f181379921560c25c44d3c73ed45f7c6a08b4e",
"html": "https://github.com/Aider-AI/aider/tree/main/aider"
}
},
{
"name": "benchmark",
"path": "benchmark",
"sha": "9545fafb919a443b3840f0eb9efe1ded5a9fd773",
"size": 0,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/benchmark?ref=main",
"html_url": "https://github.com/Aider-AI/aider/tree/main/benchmark",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/trees/9545fafb919a443b3840f0eb9efe1ded5a9fd773",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/benchmark?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/trees/9545fafb919a443b3840f0eb9efe1ded5a9fd773",
"html": "https://github.com/Aider-AI/aider/tree/main/benchmark"
}
},
{
"name": "docker",
"path": "docker",
"sha": "75183fa5fbe4f545bf585479137a9e23de28bb30",
"size": 0,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/docker?ref=main",
"html_url": "https://github.com/Aider-AI/aider/tree/main/docker",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/trees/75183fa5fbe4f545bf585479137a9e23de28bb30",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/docker?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/trees/75183fa5fbe4f545bf585479137a9e23de28bb30",
"html": "https://github.com/Aider-AI/aider/tree/main/docker"
}
},
{
"name": "pyproject.toml",
"path": "pyproject.toml",
"sha": "653fc2175129b0298c6fc9d46a1279b66ba36aa1",
"size": 1580,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/pyproject.toml?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/pyproject.toml",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/653fc2175129b0298c6fc9d46a1279b66ba36aa1",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/pyproject.toml",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/pyproject.toml?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/653fc2175129b0298c6fc9d46a1279b66ba36aa1",
"html": "https://github.com/Aider-AI/aider/blob/main/pyproject.toml"
}
},
{
"name": "pytest.ini",
"path": "pytest.ini",
"sha": "7e37e17793017b32db7fe57a76de907ef0bd41df",
"size": 194,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/pytest.ini?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/pytest.ini",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/7e37e17793017b32db7fe57a76de907ef0bd41df",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/pytest.ini",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/pytest.ini?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/7e37e17793017b32db7fe57a76de907ef0bd41df",
"html": "https://github.com/Aider-AI/aider/blob/main/pytest.ini"
}
},
{
"name": "requirements.txt",
"path": "requirements.txt",
"sha": "cddf41382622a5348e84fb1cb1cd8dfddde6e64c",
"size": 12329,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/requirements.txt?ref=main",
"html_url": "https://github.com/Aider-AI/aider/blob/main/requirements.txt",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/blobs/cddf41382622a5348e84fb1cb1cd8dfddde6e64c",
"download_url": "https://raw.githubusercontent.com/Aider-AI/aider/main/requirements.txt",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/requirements.txt?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/blobs/cddf41382622a5348e84fb1cb1cd8dfddde6e64c",
"html": "https://github.com/Aider-AI/aider/blob/main/requirements.txt"
}
},
{
"name": "requirements",
"path": "requirements",
"sha": "dbf88363c16feca71c88d79b129a0965310b3c86",
"size": 0,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/requirements?ref=main",
"html_url": "https://github.com/Aider-AI/aider/tree/main/requirements",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/trees/dbf88363c16feca71c88d79b129a0965310b3c86",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/requirements?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/trees/dbf88363c16feca71c88d79b129a0965310b3c86",
"html": "https://github.com/Aider-AI/aider/tree/main/requirements"
}
},
{
"name": "scripts",
"path": "scripts",
"sha": "4afed1d082a5a4e16d64c1a4e5b8421b7dc07b3a",
"size": 0,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/scripts?ref=main",
"html_url": "https://github.com/Aider-AI/aider/tree/main/scripts",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/trees/4afed1d082a5a4e16d64c1a4e5b8421b7dc07b3a",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/scripts?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/trees/4afed1d082a5a4e16d64c1a4e5b8421b7dc07b3a",
"html": "https://github.com/Aider-AI/aider/tree/main/scripts"
}
},
{
"name": "tests",
"path": "tests",
"sha": "2259b1114fc3ef34139f5ed04079ba49fe5c8f13",
"size": 0,
"url": "https://api.github.com/repos/Aider-AI/aider/contents/tests?ref=main",
"html_url": "https://github.com/Aider-AI/aider/tree/main/tests",
"git_url": "https://api.github.com/repos/Aider-AI/aider/git/trees/2259b1114fc3ef34139f5ed04079ba49fe5c8f13",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Aider-AI/aider/contents/tests?ref=main",
"git": "https://api.github.com/repos/Aider-AI/aider/git/trees/2259b1114fc3ef34139f5ed04079ba49fe5c8f13",
"html": "https://github.com/Aider-AI/aider/tree/main/tests"
}
}
]
@@ -0,0 +1,37 @@
version: 1
domain_id: aider-ai-aider
object:
type: github_repository
name: Aider-AI/aider
url: https://github.com/Aider-AI/aider
pulled_at: '2026-07-02T22:47:14+00:00'
puller: scripts/fetch-research-raw.py
files:
- path: repository/
kind: git-working-tree
status: ok
source: 'git clone --depth=1 --single-branch --no-tags https://github.com/Aider-AI/aider.git docs/research/aider-ai-aider/raw/repository'
- path: github-repo.raw.json
kind: repository-metadata
status: ok
source: 'gh repo view Aider-AI/aider --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
- path: github-readme.raw.md.txt
kind: readme
status: ok
source: 'gh api repos/Aider-AI/aider/readme -H Accept: application/vnd.github.raw'
- path: github-license.raw.txt
kind: license
status: ok
source: 'gh api repos/Aider-AI/aider/license -H Accept: application/vnd.github.raw'
- path: github-root-contents.raw.json
kind: root-contents
status: ok
source: 'gh api repos/Aider-AI/aider/contents'
- path: github-languages.raw.json
kind: languages
status: ok
source: 'gh api repos/Aider-AI/aider/languages'
- path: github-latest-release.raw.json
kind: latest-release
status: ok
source: 'gh api repos/Aider-AI/aider/releases/latest'
+26
View File
@@ -0,0 +1,26 @@
# cline/cline 研究域 Agent 指南
本目录维护 `cline/cline` 的独立研究域。
## 目录职责
```text
cline-cline/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层:仓库元数据、研究角色、来源证据
├── analysis.md # L1 结构化研究结论、可借鉴点、风险和下一轮任务
├── deep-dive.md # L2 源码/结构深度研究、关键机制和可迁移模式
└── raw/ # 原始事实层:拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `cline/cline`,不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`,并更新 `observed_at`
- `raw/` 保存原始事实层,必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件;稳定事实摘要再同步到 `domain.yml`
- README 只写判断、定位、使用方式和后续观察点,不堆外部 README 全文。
- `analysis.md` 写 L1 结构化理解;`deep-dive.md` 写 L2 源码证据、关键机制和可迁移模式。
- 如果需要横向比较,在 `docs/research/README.md` 或新的对比文档中处理,不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc``make test`
+58
View File
@@ -0,0 +1,58 @@
# cline/cline 研究域
## 字多不看
- 本目录研究 `cline/cline` 这个外部仓库。
- 当前优先级:P1;研究角色:IDE/SDK/CLI 自主编码 Agent。
- GitHub 动态事实放在 `domain.yml`,观测日期为 2026-07-03。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
| [deep-dive.md](deep-dive.md) | L2 源码/结构深度研究、关键机制和可迁移模式。 |
| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>
### 细粒度目录
- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
- [deep-dive.md](deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
</details>
## 使用方式
- 先读本 README 的判断,再读 `analysis.md``deep-dive.md` 的研究结论,最后读 `domain.yml`
- 需要引用 stars、forks、release、归档状态时,先重新核验 GitHub。
- 如果形成稳定方法论,再迁入 concepts、references、workflow 或 skills。
## 正文
### 研究定位
`cline/cline` 的当前研究定位是:IDE/SDK/CLI 自主编码 Agent。
### 当前判断
适合研究 IDE 内 agent、跨文件修改、工具调用和错误反馈闭环。
### 观察字段
- GitHub URLhttps://github.com/cline/cline
- 当前研究方向:`coding-agent-tooling`
- 当前优先级:P1
- 当前归档状态:`false`
- 主要语言:`TypeScript`
### 后续观察
- 是否有稳定文档结构、命令入口和可复用工作流。
- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。
+44
View File
@@ -0,0 +1,44 @@
# cline/cline 研究分析
## 本轮结论
- Cline 是多表面 coding agent 产品,覆盖 VS Code Extension、CLI、Kanban、SDK 和 JetBrains Plugin。
- 它的研究重点不是单一模型调用,而是 agent 工具面、编辑器集成、规则/技能、评估和产品化分层。
- 本仓应重点吸收它的多入口架构、规则文件约定、evals 目录和 extension/webview 分离。
## 本地证据
- 研究对象:`cline/cline`
- 当前研究角色:IDE/SDK/CLI 自主编码 Agent
- 本轮成熟度:L1 初步理解
- 原始仓库:`raw/repository/`
- 原始来源清单:`raw/sources.yml`
- 事实摘要:`domain.yml`
## 结构观察
- 根目录包含 `.agents/``.claude/``.cline/``.clinerules/``apps/``sdk/``evals/``package.json`
- `apps/``sdk/` 表明它已经从单一 VS Code 插件演化成多产品面。
- README 明确列出 CLI、Kanban、VS Code Extension、JetBrains Plugin、SDK、Plan and Act、Rules and Skills。
## 可借鉴点
- 把 Agent 能力拆成产品表面、SDK、规则、技能和评估,而不是把所有逻辑塞进一个入口。
- 规则文件和技能目录是让用户控制 agent 行为的关键资产。
- IDE agent 需要 plan/act 分离,降低自动执行的不可控风险。
## 风险和边界
- 产品面很多,架构复杂度高,直接模仿会带来过高维护成本。
- 前端、扩展宿主、模型工具调用和评估同时演进,研究需要分层拆解。
- 作为快速迭代项目,某些目录和命令可能频繁变化。
## 下一轮研究任务
- 拆读 `apps/``sdk/``evals/` 的边界,形成 IDE agent 架构图。
- 提炼 Cline 的 rules/skills 模式,和本仓 `skills/` 体系对照。
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
+88
View File
@@ -0,0 +1,88 @@
# cline/cline 深度研究
## 研究级别
- 当前级别:L2 源码/结构深度研究。
- 研究对象:`cline/cline`
- 证据来源:本目录 `raw/` 下的 GitHub 元数据、README 快照和本地仓库工作树。
- 观察日期:2026-07-03。
## L2 结论
`cline/cline` 已经不是单一 VS Code 插件,而是向多入口 agent 平台演化的代码库。它同时包含
VS Code 扩展、CLI、hub 服务、SDK、示例应用、规则系统、技能入口、测试平台和发布脚本。
对本仓最重要的启发是:当 AI coding 工具成熟后,产品边界会从“一个插件”扩展为
IDE、CLI、SDK、hooks、规则、技能、示例和测试平台组成的系统。也就是说,agent 能力必须被
平台化和契约化,不能只依赖单个入口。
## 源码证据
- `raw/repository/apps/vscode/src/extension.ts`VS Code 扩展入口。
- `raw/repository/apps/vscode/webview-ui/`:前端交互界面。
- `raw/repository/apps/cli/src/main.ts`CLI 入口。
- `raw/repository/apps/cli/src/index.ts`CLI 对外模块入口。
- `raw/repository/apps/cline-hub/src/server.ts`hub 服务入口。
- `raw/repository/apps/cline-hub/src/webview-protocol.ts`webview 协议边界。
- `raw/repository/sdk/ARCHITECTURE.md`SDK 架构说明。
- `raw/repository/sdk/AGENTS.md`:SDK 目录的 Agent 维护规则。
- `raw/repository/apps/examples/multi-agent/README.md`:多 agent 示例。
- `raw/repository/apps/examples/code-review-bot/README.md`:代码审查机器人示例。
- `raw/repository/.clinerules/general.md`:项目级规则示例。
- `raw/repository/.agents/skills/cline-sdk/SKILL.md`:技能化能力入口。
## 关键机制
### 多入口产品结构
Cline 同时维护 IDE、CLI、hub 和 SDK。这个结构说明 agent 产品的用户入口会多样化:
开发者可能在编辑器里交互,也可能在终端、自动化服务或自定义应用里调用同一套能力。
### SDK 化是生态扩展前提
`sdk/` 和 examples 表明 Cline 不只服务自己的 UI,还希望让外部开发者复用能力。成熟 agent
生态需要 SDK、示例、协议和测试,而不是只暴露一个不可组合的插件。
### 规则、技能和 hooks 承载操作边界
`.clinerules/``.agents/skills/` 和相关配置说明,agent 的行为边界需要显式文件承载。
这与本仓的 `AGENTS.md``skills/` 和治理文档方向一致。
### 测试平台和发布脚本是产品能力
当 agent 工具跨 IDE、CLI 和 SDK 后,测试与发布不再是附属流程,而是维持平台一致性的必要
控制面。没有测试平台,多入口很快会出现行为漂移。
## 可迁移模式
- 把本仓能力区分为人类阅读入口、AI 上下文入口、脚本入口和 skill 入口。
- 对每个入口说明协议、输入、输出、风险和验证方式。
- 为重要工作流提供 examples,而不是只写抽象原则。
- 把规则文件、skills、hooks、CLI 和文档索引视为同一套 agent 平台的不同表面。
- 长期考虑为本仓沉淀可复用 SDK/CLI 风格的读取与校验工具。
## 对本仓的影响
本仓已经有 `docs/``prompts/``skills/``scripts/``metadata/``assets/ai-citation/` 等多个入口。
Cline 的结构提醒我们:这些入口不能各自为政,应该用统一契约说明它们如何协同。
当前最值得推进的是:
- `metadata/` 继续作为机器索引事实源。
- `llms.txt``assets/ai-citation/llms-full.txt` 继续作为 AI 读取入口。
- `scripts/` 继续作为仓库控制面。
- `skills/` 继续作为 Agent 可复用能力层。
- `docs/research/` 继续作为研究对象网络。
## 风险和待验证项
- Cline 代码库较大,且产品线较多;本轮没有验证所有 package 的构建和测试。
- 多入口平台化会带来复杂度,本仓不应为了“看起来平台化”提前增加不必要代码。
- 本仓当前仍以文档知识库为主,迁移时应优先吸收契约和治理模式,而非复制应用结构。
## 下一步 L3 验证任务
- 梳理本仓所有入口:人类入口、AI 入口、脚本入口、skill 入口、资源入口。
- 为每类入口写清输入、输出、owner、验证命令和更新策略。
-`docs/references/` 中沉淀“多入口 agent 仓库结构模板”。
- 用 Cline examples 的思路,为本仓关键工作流增加最小可运行示例。
+32
View File
@@ -0,0 +1,32 @@
version: 1
repo:
name: cline/cline
source_name: cline/cline
url: https://github.com/cline/cline
research:
domain_id: cline-cline
domain_name: cline/cline 研究域
primary_direction: coding-agent-tooling
role: IDE/SDK/CLI 自主编码 Agent
priority: 1
why_study: 适合研究 IDE 内 agent、跨文件修改、工具调用和错误反馈闭环。
github_observed:
observed_at: '2026-07-03'
source: gh repo view
stars: 64218
forks: 6822
archived: false
language: TypeScript
license: apache-2.0
default_branch: main
pushed_at: '2026-07-02T21:53:59Z'
updated_at: '2026-07-02T20:47:18Z'
latest_release: v4.0.6
homepage: https://cline.bot
topics: []
source_evidence:
file: ChatGPT-中文Vibe Coding仓库 (2).md
line: 58
maintenance:
fact_policy: GitHub 动态字段只代表 observed_at 当日快照,更新结论前必须重新核验。
split_policy: 本目录已经是一等研究域;更深分析放入本目录新增文档。
+12
View File
@@ -0,0 +1,12 @@
# raw/ Agent 指南
本目录是 `cline/cline` 的原始事实层。
## 维护规则
- 只保存从研究对象拉取的一手材料,不写分析判断。
- `repository/` 是本地 Git 工作树,刷新时由脚本 clone 或 fast-forward pull。
- 不手工改写 `*.raw.*` 文件内容;需要刷新时运行 `python3 scripts/fetch-research-raw.py`
- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
- 外部 README 原文必须保存为 `.txt`,避免本仓库 Markdown 链接检查误判。
- 分析、判断、采用建议和沉淀路径写回上一级 `README.md``analysis.md``decisions.md`
+16
View File
@@ -0,0 +1,16 @@
# raw 事实层
本目录保存 `cline/cline` 的本地原始材料快照。
这里不写分析结论,只保存可复查的一手资料:
- `sources.yml`:来源清单、拉取时间、命令和文件状态。
- `repository/`Git 仓库工作树;本目录由 `.gitignore` 忽略,只作为本地研究材料。
- `github-repo.raw.json`GitHub 仓库元数据。
- `github-readme.raw.md.txt`GitHub README 原文快照。
- `github-license.raw.txt`GitHub license 原文快照;仓库无 license 时可能不存在。
- `github-root-contents.raw.json`:默认分支根目录内容快照。
- `github-languages.raw.json`GitHub language 统计快照。
- `github-latest-release.raw.json`:最新 release 快照;无 release 时可能不存在。
`repository/` 是外部源码快照,不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存,避免其中的外部相对链接被本仓库 Markdown 链接检查误判。
@@ -0,0 +1,9 @@
{
"TypeScript": 15526503,
"JavaScript": 262022,
"Rust": 43944,
"CSS": 43921,
"HTML": 35842,
"Shell": 19413,
"Python": 7735
}
@@ -0,0 +1,79 @@
{
"url": "https://api.github.com/repos/cline/cline/releases/348214539",
"assets_url": "https://api.github.com/repos/cline/cline/releases/348214539/assets",
"upload_url": "https://uploads.github.com/repos/cline/cline/releases/348214539/assets{?name,label}",
"html_url": "https://github.com/cline/cline/releases/tag/v4.0.6",
"id": 348214539,
"author": {
"login": "github-actions[bot]",
"id": 41898282,
"node_id": "MDM6Qm90NDE4OTgyODI=",
"avatar_url": "https://avatars.githubusercontent.com/in/15368?v=4",
"gravatar_id": "",
"url": "https://api.github.com/users/github-actions%5Bbot%5D",
"html_url": "https://github.com/apps/github-actions",
"followers_url": "https://api.github.com/users/github-actions%5Bbot%5D/followers",
"following_url": "https://api.github.com/users/github-actions%5Bbot%5D/following{/other_user}",
"gists_url": "https://api.github.com/users/github-actions%5Bbot%5D/gists{/gist_id}",
"starred_url": "https://api.github.com/users/github-actions%5Bbot%5D/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/github-actions%5Bbot%5D/subscriptions",
"organizations_url": "https://api.github.com/users/github-actions%5Bbot%5D/orgs",
"repos_url": "https://api.github.com/users/github-actions%5Bbot%5D/repos",
"events_url": "https://api.github.com/users/github-actions%5Bbot%5D/events{/privacy}",
"received_events_url": "https://api.github.com/users/github-actions%5Bbot%5D/received_events",
"type": "Bot",
"user_view_type": "public",
"site_admin": false
},
"node_id": "RE_kwDOMSqWwc4UwVUL",
"tag_name": "v4.0.6",
"target_commitish": "main",
"name": "v4.0.6",
"draft": false,
"immutable": false,
"prerelease": false,
"created_at": "2026-07-02T17:43:54Z",
"updated_at": "2026-07-02T18:12:44Z",
"published_at": "2026-07-02T18:12:42Z",
"assets": [
{
"url": "https://api.github.com/repos/cline/cline/releases/assets/464582381",
"id": 464582381,
"node_id": "RA_kwDOMSqWwc4bsPbt",
"name": "cline-4.0.6.vsix",
"label": "",
"uploader": {
"login": "github-actions[bot]",
"id": 41898282,
"node_id": "MDM6Qm90NDE4OTgyODI=",
"avatar_url": "https://avatars.githubusercontent.com/in/15368?v=4",
"gravatar_id": "",
"url": "https://api.github.com/users/github-actions%5Bbot%5D",
"html_url": "https://github.com/apps/github-actions",
"followers_url": "https://api.github.com/users/github-actions%5Bbot%5D/followers",
"following_url": "https://api.github.com/users/github-actions%5Bbot%5D/following{/other_user}",
"gists_url": "https://api.github.com/users/github-actions%5Bbot%5D/gists{/gist_id}",
"starred_url": "https://api.github.com/users/github-actions%5Bbot%5D/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/github-actions%5Bbot%5D/subscriptions",
"organizations_url": "https://api.github.com/users/github-actions%5Bbot%5D/orgs",
"repos_url": "https://api.github.com/users/github-actions%5Bbot%5D/repos",
"events_url": "https://api.github.com/users/github-actions%5Bbot%5D/events{/privacy}",
"received_events_url": "https://api.github.com/users/github-actions%5Bbot%5D/received_events",
"type": "Bot",
"user_view_type": "public",
"site_admin": false
},
"content_type": "application/octet-stream",
"state": "uploaded",
"size": 10424642,
"digest": "sha256:b622aff22c6b99397cde8341720364d935a38dbaea5be0e8c93529b4c052bf81",
"download_count": 8,
"created_at": "2026-07-02T18:12:43Z",
"updated_at": "2026-07-02T18:12:44Z",
"browser_download_url": "https://github.com/cline/cline/releases/download/v4.0.6/cline-4.0.6.vsix"
}
],
"tarball_url": "https://api.github.com/repos/cline/cline/tarball/v4.0.6",
"zipball_url": "https://api.github.com/repos/cline/cline/zipball/v4.0.6",
"body": "\n### Fixed\n\n- Generalize the model capability warning so it applies more broadly.\n\n**Full Changelog**: https://github.com/cline/cline/compare/v4.0.5...v4.0.6\n"
}
@@ -0,0 +1,201 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright 2026 Cline Bot Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
@@ -0,0 +1,239 @@
<p align="center">
<img src="assets/icons/icon.png" width="80" alt="Cline" />
</p>
<h1 align="center">Cline</h1>
<p align="center">
The open source coding agent in your IDE and terminal.
</p>
<div align="center">
<div align="center">
<table>
<tbody>
<td align="center">
<a href="https://docs.cline.bot" target="_blank"><strong>Docs</strong></a>
</td>
<td align="center">
<a href="https://discord.gg/cline" target="_blank"><strong>Discord</strong></a>
</td>
<td align="center">
<a href="https://www.reddit.com/r/cline/" target="_blank"><strong>r/cline</strong></a>
</td>
<td align="center">
<a href="https://github.com/cline/cline/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop" target="_blank"><strong>Feature Requests</strong></a>
</td>
<td align="center">
<a href="https://cline.bot/join-us" target="_blank"><strong>Join us!</strong></a>
</td>
</tbody>
</table>
</div>
</div>
<br>
<div align="center">
<table>
<tr>
<td align="center" width="50%">
### CLI
Run Cline in your terminal.
Interactive chat or fully headless
for CI/CD and scripting.
```
npm i -g cline
```
<a href="./apps/cli/README.md">Learn more</a>
<br><br>
</td>
<td align="center" width="50%">
### Kanban
Run many agents in parallel from a
web-based task board. Each card gets its own
worktree, auto-commit, and dependency chains.
```
npm i -g kanban
```
<a href="https://github.com/cline/kanban">Learn more</a>
<br><br>
</td>
</tr>
<tr>
<td align="center" width="50%">
### VS Code Extension
AI coding assistant in your editor.
Create files, run commands, browse the web,
and use tools with human-in-the-loop approval.
<a href="https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev">Install from VS Marketplace</a>
<br><br>
</td>
<td align="center" width="50%">
### JetBrains Plugin
The same Cline experience in IntelliJ IDEA,
PyCharm, WebStorm, GoLand, and the rest of
the JetBrains family.
<a href="https://plugins.jetbrains.com/plugin/28247-cline">Install from JetBrains Marketplace</a>
<br><br>
</td>
</tr>
</table>
</div>
<div align="center">
<table>
<tr>
<td align="center">
### SDK
Build your own AI agents and integrations powered by the same engine that runs the CLI, Kanban, VS Code extension, and JetBrains plugin. Custom tools, multi-agent teams, connectors, scheduled automations, and more.
```
npm install @cline/sdk
```
<a href="https://docs.cline.bot/cline-sdk/overview">Documentation</a>
<br><br>
</td>
</tr>
</table>
</div>
---
## Index
| Product | Description | Location | CHANGELOG |
|---------|------------|--------------|--------------|
| **SDK** | Node.js programmatic agent API and extension exports. | [`sdk/`](https://github.com/cline/cline/tree/main/sdk) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/sdk/CHANGELOG.md) |
| **CLI** | Terminal UI, headless mode, shell commands, and CLI-specific flows. | [`apps/cli/`](https://github.com/cline/cline/tree/main/apps/cli) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md) |
| **VS Code Extension** | The Marketplace extension and extension host integration. | [`/`](https://github.com/cline/cline/tree/main) (WIP migrating) | [CHANGELOG.md](https://github.com/cline/cline/blob/main/CHANGELOG.md) |
| **JetBrains Plugin** | JetBrains-hosted client that talks to the shared agent core. | Currently we are not open-sourcing JetBrains plugins | - |
| **Kanban** | Web-based multi-agent task board. | [`cline/kanban`](https://github.com/cline/kanban) | [CHANGELOG.md](https://github.com/cline/kanban/blob/main/CHANGELOG.md) |
| **Docs site** | Public documentation pages. | [`docs/`](https://docs.cline.bot/) | - |
## Edits Code Across Your Project
Cline reads your project structure, understands the relationships between files, and makes coordinated changes across your codebase. It monitors linter and compiler errors as it works, fixing issues like missing imports, type mismatches, and syntax errors before you even see them. In VS Code and JetBrains, every edit shows up as a diff you can review, modify, or revert. All changes are tracked with checkpoints, so you can easily undo the agent's work.
## Runs Bash Commands
Cline executes commands directly in your terminal and watches the output in real time. Install packages, run build scripts, execute tests, deploy applications, manage databases. For long-running processes like dev servers, Cline continues working in the background and reacts to new output as it appears, catching compile errors, test failures, and server crashes as they happen.
## Plan and Act
Toggle between Plan mode and Act mode. In Plan mode, Cline explores your codebase, asks clarifying questions, and lays out a strategy. Once you're aligned, switch to Act mode and Cline executes the plan. Every file edit and terminal command requires your approval, so you stay in control of what actually changes. Or toggle auto-approve and let Cline run autonomously.
## Rules and Skills
Define project-specific rules in `.clinerules` files that guide how Cline works in your codebase: coding standards, architecture conventions, deployment procedures, testing requirements. Rules are picked up automatically by the CLI, VS Code extension, and JetBrains plugin. Use skills to let the model load specific rules when needed.
## Works With Every Model
Cline is not locked to a single AI provider. Use whichever model fits your workflow:
| Provider | Models |
|----------|--------|
| Anthropic | Claude Opus, Sonnet, Haiku |
| OpenAI | GPT series model |
| Google | Gemini series model |
| OpenRouter | 200+ models from any provider |
| Vercel AI Gateway | Models through Vercel AI Gateway |
| AWS Bedrock | Claude, Llama, and more |
| Azure / GCP Vertex | All hosted models |
| Cerebras / Groq | Fast inference models |
| Ollama / LM Studio | Run local models on your machine |
| Any OpenAI-compatible API | Self-hosted or third-party endpoints |
## Extend With Plugins or MCP Servers
Extend Cline's capabilities with plugins. Using the SDK, register tools and lifecycle hooks programmatically through the plugin system for logging, auditing, policy enforcement, or adding domain-specific capabilities. Simple plugin example below.
```typescript
import { Agent, createTool } from "@cline/sdk"
const deployTool = createTool({
name: "deploy",
description: "Deploy the current branch to staging.",
inputSchema: { type: "object", properties: { env: { type: "string" } }, required: ["env"] },
execute: async (input) => {
// your deployment logic
},
})
const agent = new Agent({ tools: [deployTool], /* ... */ })
```
...or use [MCP servers](https://github.com/modelcontextprotocol) to connect to databases, query APIs, manage cloud infrastructure, and interact with external systems. Use [community-built servers](https://github.com/modelcontextprotocol/servers) or ask Cline to create custom tools on the fly. In the CLI, manage servers with `cline mcp`.
## Multi-Agent Teams
Coordinate multiple agents working together on complex tasks. A coordinator agent breaks the work into subtasks and delegates to specialist agents, each with their own tools and context. Team state persists across sessions so you can pick up where you left off.
```bash
cline --team-name auth-sprint "Plan and implement user authentication with tests"
```
## Scheduled Agents
Run agents on cron schedules for recurring automations. Daily PR summaries, weekly dependency checks, codebase health reports. Schedules persist across restarts and run independently of any terminal session.
```bash
cline schedule create "PR summary" \
--cron "0 9 * * MON-FRI" \
--prompt "List all open PRs and their review status" \
--workspace /path/to/repo
```
## Connect to Slack, Telegram, Discord, and More
Chat with your agent from any messaging platform: Telegram, Slack, Discord, Google Chat, WhatsApp, and Linear. Each conversation thread maps to an agent session with full context. Set up access control to restrict who can interact with your agent.
```bash
# Connect to Telegram
cline connect telegram -k $BOT_TOKEN
# Connect to Slack through webhook
cline connect slack --bot-token $SLACK_TOKEN --signing-secret $SECRET --base-url $URL
# Connect to Slack using socket mode
cline connect slack --bot-token $SLACK_TOKEN --app-token $SLACK_APP_TOKEN
```
## Headless CLI for CI/CD
Run Cline with zero interaction for scripting and automation. Pipe input, get JSON output, chain commands, integrate into CI/CD pipelines.
```bash
cline "Run tests and fix any failures"
git diff origin/main | cline "Review these changes for issues"
cline --json "List all TODO comments" | jq -r 'select(.type == "agent_event" and .event.text) | .event.text'
```
## Contributing
Start with the [Contributing Guide](CONTRIBUTING.md). Join our [Discord](https://discord.gg/cline) and head to the `#contributors` channel to connect with other contributors. Check our [careers page](https://cline.bot/join-us) for full-time roles.
## License
[Apache 2.0 © 2026 Cline Bot Inc.](./LICENSE)
@@ -0,0 +1,35 @@
{
"createdAt": "2024-07-06T07:28:10Z",
"defaultBranchRef": {
"name": "main"
},
"description": "Autonomous coding agent as an SDK, IDE extension, or CLI assistant.",
"forkCount": 6822,
"homepageUrl": "https://cline.bot",
"isArchived": false,
"isFork": false,
"isMirror": false,
"latestRelease": {
"name": "v4.0.6",
"publishedAt": "2026-07-02T18:12:42Z",
"tagName": "v4.0.6",
"url": "https://github.com/cline/cline/releases/tag/v4.0.6"
},
"licenseInfo": {
"key": "apache-2.0",
"name": "Apache License 2.0",
"nickname": ""
},
"nameWithOwner": "cline/cline",
"primaryLanguage": {
"name": "TypeScript"
},
"pushedAt": "2026-07-02T22:41:08Z",
"repositoryTopics": null,
"stargazerCount": 64219,
"updatedAt": "2026-07-02T22:40:29Z",
"url": "https://github.com/cline/cline",
"watchers": {
"totalCount": 276
}
}
@@ -0,0 +1,530 @@
[
{
"name": ".agents",
"path": ".agents",
"sha": "7a3eeb9b5e2b8e29b7e4b78257a4d41d144e71b7",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.agents?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.agents",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/7a3eeb9b5e2b8e29b7e4b78257a4d41d144e71b7",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.agents?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/7a3eeb9b5e2b8e29b7e4b78257a4d41d144e71b7",
"html": "https://github.com/cline/cline/tree/main/.agents"
}
},
{
"name": ".changeset",
"path": ".changeset",
"sha": "18bbe48482fb8a2cf664875fd5b0974ec6a77bf2",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.changeset?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.changeset",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/18bbe48482fb8a2cf664875fd5b0974ec6a77bf2",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.changeset?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/18bbe48482fb8a2cf664875fd5b0974ec6a77bf2",
"html": "https://github.com/cline/cline/tree/main/.changeset"
}
},
{
"name": ".claude",
"path": ".claude",
"sha": "df764f7f42d7530eebf9cd485d1d660117b8b147",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.claude?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.claude",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/df764f7f42d7530eebf9cd485d1d660117b8b147",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.claude?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/df764f7f42d7530eebf9cd485d1d660117b8b147",
"html": "https://github.com/cline/cline/tree/main/.claude"
}
},
{
"name": ".cline",
"path": ".cline",
"sha": "af750cd904b3b860efa07741c0f99a022b708ce3",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.cline?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.cline",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/af750cd904b3b860efa07741c0f99a022b708ce3",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.cline?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/af750cd904b3b860efa07741c0f99a022b708ce3",
"html": "https://github.com/cline/cline/tree/main/.cline"
}
},
{
"name": ".clinerules",
"path": ".clinerules",
"sha": "d7161894935d400d7b0122ee5a553da3f9950545",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.clinerules?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.clinerules",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/d7161894935d400d7b0122ee5a553da3f9950545",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.clinerules?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/d7161894935d400d7b0122ee5a553da3f9950545",
"html": "https://github.com/cline/cline/tree/main/.clinerules"
}
},
{
"name": ".codex",
"path": ".codex",
"sha": "81c2f677f7d89b8e04f7df77d2a3099f4f168550",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.codex?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.codex",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/81c2f677f7d89b8e04f7df77d2a3099f4f168550",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.codex?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/81c2f677f7d89b8e04f7df77d2a3099f4f168550",
"html": "https://github.com/cline/cline/tree/main/.codex"
}
},
{
"name": ".gitattributes",
"path": ".gitattributes",
"sha": "9f1ff5fcce328496fed06f20d53b4e767f7a39ab",
"size": 122,
"url": "https://api.github.com/repos/cline/cline/contents/.gitattributes?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/.gitattributes",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/9f1ff5fcce328496fed06f20d53b4e767f7a39ab",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/.gitattributes",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.gitattributes?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/9f1ff5fcce328496fed06f20d53b4e767f7a39ab",
"html": "https://github.com/cline/cline/blob/main/.gitattributes"
}
},
{
"name": ".github",
"path": ".github",
"sha": "a1485c6bd07ad193f2437ee762886d9dd8e575cd",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.github?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.github",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/a1485c6bd07ad193f2437ee762886d9dd8e575cd",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.github?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/a1485c6bd07ad193f2437ee762886d9dd8e575cd",
"html": "https://github.com/cline/cline/tree/main/.github"
}
},
{
"name": ".gitignore",
"path": ".gitignore",
"sha": "5f967a7308e09d6238ce6e74e9128695f591099f",
"size": 1441,
"url": "https://api.github.com/repos/cline/cline/contents/.gitignore?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/.gitignore",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/5f967a7308e09d6238ce6e74e9128695f591099f",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/.gitignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.gitignore?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/5f967a7308e09d6238ce6e74e9128695f591099f",
"html": "https://github.com/cline/cline/blob/main/.gitignore"
}
},
{
"name": ".gitleaks.toml",
"path": ".gitleaks.toml",
"sha": "c0626f558c147f1ae9028dbdfda9e0a9be8ea564",
"size": 64,
"url": "https://api.github.com/repos/cline/cline/contents/.gitleaks.toml?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/.gitleaks.toml",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/c0626f558c147f1ae9028dbdfda9e0a9be8ea564",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/.gitleaks.toml",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.gitleaks.toml?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/c0626f558c147f1ae9028dbdfda9e0a9be8ea564",
"html": "https://github.com/cline/cline/blob/main/.gitleaks.toml"
}
},
{
"name": ".gitmodules",
"path": ".gitmodules",
"sha": "929ec96242e4546878c3d5bc8f6a2b07cae567cd",
"size": 106,
"url": "https://api.github.com/repos/cline/cline/contents/.gitmodules?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/.gitmodules",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/929ec96242e4546878c3d5bc8f6a2b07cae567cd",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/.gitmodules",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.gitmodules?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/929ec96242e4546878c3d5bc8f6a2b07cae567cd",
"html": "https://github.com/cline/cline/blob/main/.gitmodules"
}
},
{
"name": ".greptile",
"path": ".greptile",
"sha": "2abebbd25ee4b05dada72123e38784f3f8d132de",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.greptile?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.greptile",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/2abebbd25ee4b05dada72123e38784f3f8d132de",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.greptile?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/2abebbd25ee4b05dada72123e38784f3f8d132de",
"html": "https://github.com/cline/cline/tree/main/.greptile"
}
},
{
"name": ".husky",
"path": ".husky",
"sha": "42900e6fd2e9843f66373a466f7e99284afc2325",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.husky?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.husky",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/42900e6fd2e9843f66373a466f7e99284afc2325",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.husky?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/42900e6fd2e9843f66373a466f7e99284afc2325",
"html": "https://github.com/cline/cline/tree/main/.husky"
}
},
{
"name": ".kanban",
"path": ".kanban",
"sha": "3b3fefa11ee0ba6e6b4421776f362bb65bdbd8b6",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.kanban?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.kanban",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/3b3fefa11ee0ba6e6b4421776f362bb65bdbd8b6",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.kanban?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/3b3fefa11ee0ba6e6b4421776f362bb65bdbd8b6",
"html": "https://github.com/cline/cline/tree/main/.kanban"
}
},
{
"name": ".nvmrc",
"path": ".nvmrc",
"sha": "8fdd954df9831dfd29ceec0d74829b02f3f5d8c3",
"size": 2,
"url": "https://api.github.com/repos/cline/cline/contents/.nvmrc?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/.nvmrc",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/8fdd954df9831dfd29ceec0d74829b02f3f5d8c3",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/.nvmrc",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.nvmrc?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/8fdd954df9831dfd29ceec0d74829b02f3f5d8c3",
"html": "https://github.com/cline/cline/blob/main/.nvmrc"
}
},
{
"name": ".tool-versions",
"path": ".tool-versions",
"sha": "05b561a70e3cbd8f9b8ef0dab234b8b3e97754f2",
"size": 19,
"url": "https://api.github.com/repos/cline/cline/contents/.tool-versions?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/.tool-versions",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/05b561a70e3cbd8f9b8ef0dab234b8b3e97754f2",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/.tool-versions",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.tool-versions?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/05b561a70e3cbd8f9b8ef0dab234b8b3e97754f2",
"html": "https://github.com/cline/cline/blob/main/.tool-versions"
}
},
{
"name": ".vscode",
"path": ".vscode",
"sha": "6bcafa31e9a3de82744eb25dcd9e48b54ce77d8d",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/.vscode?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/.vscode",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/6bcafa31e9a3de82744eb25dcd9e48b54ce77d8d",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.vscode?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/6bcafa31e9a3de82744eb25dcd9e48b54ce77d8d",
"html": "https://github.com/cline/cline/tree/main/.vscode"
}
},
{
"name": ".worktreeinclude",
"path": ".worktreeinclude",
"sha": "3e4e48b0b5fe6b468434d6767749b399319f2da2",
"size": 10,
"url": "https://api.github.com/repos/cline/cline/contents/.worktreeinclude?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/.worktreeinclude",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/3e4e48b0b5fe6b468434d6767749b399319f2da2",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/.worktreeinclude",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/.worktreeinclude?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/3e4e48b0b5fe6b468434d6767749b399319f2da2",
"html": "https://github.com/cline/cline/blob/main/.worktreeinclude"
}
},
{
"name": "CHANGELOG.md",
"path": "CHANGELOG.md",
"sha": "ef03a66620bf98bd60af5061ec3d8b18ad3fee67",
"size": 98472,
"url": "https://api.github.com/repos/cline/cline/contents/CHANGELOG.md?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/CHANGELOG.md",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/ef03a66620bf98bd60af5061ec3d8b18ad3fee67",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/CHANGELOG.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/CHANGELOG.md?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/ef03a66620bf98bd60af5061ec3d8b18ad3fee67",
"html": "https://github.com/cline/cline/blob/main/CHANGELOG.md"
}
},
{
"name": "CODE_OF_CONDUCT.md",
"path": "CODE_OF_CONDUCT.md",
"sha": "3547e4628bbecb535306117ce22a9ae54ec83ae0",
"size": 3373,
"url": "https://api.github.com/repos/cline/cline/contents/CODE_OF_CONDUCT.md?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/CODE_OF_CONDUCT.md",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/3547e4628bbecb535306117ce22a9ae54ec83ae0",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/CODE_OF_CONDUCT.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/CODE_OF_CONDUCT.md?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/3547e4628bbecb535306117ce22a9ae54ec83ae0",
"html": "https://github.com/cline/cline/blob/main/CODE_OF_CONDUCT.md"
}
},
{
"name": "CONTRIBUTING.md",
"path": "CONTRIBUTING.md",
"sha": "f823b6833ac4a55f8c62b6c5357e2f900f4e8859",
"size": 8764,
"url": "https://api.github.com/repos/cline/cline/contents/CONTRIBUTING.md?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/CONTRIBUTING.md",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/f823b6833ac4a55f8c62b6c5357e2f900f4e8859",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/CONTRIBUTING.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/CONTRIBUTING.md?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/f823b6833ac4a55f8c62b6c5357e2f900f4e8859",
"html": "https://github.com/cline/cline/blob/main/CONTRIBUTING.md"
}
},
{
"name": "LICENSE",
"path": "LICENSE",
"sha": "05ae14a377caf4df24e26edde0c4f7b22ef3ef30",
"size": 11344,
"url": "https://api.github.com/repos/cline/cline/contents/LICENSE?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/LICENSE",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/05ae14a377caf4df24e26edde0c4f7b22ef3ef30",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/LICENSE",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/LICENSE?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/05ae14a377caf4df24e26edde0c4f7b22ef3ef30",
"html": "https://github.com/cline/cline/blob/main/LICENSE"
}
},
{
"name": "README.md",
"path": "README.md",
"sha": "328181237cd8d95b8e3a25850236d576e930c884",
"size": 9094,
"url": "https://api.github.com/repos/cline/cline/contents/README.md?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/README.md",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/328181237cd8d95b8e3a25850236d576e930c884",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/README.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/README.md?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/328181237cd8d95b8e3a25850236d576e930c884",
"html": "https://github.com/cline/cline/blob/main/README.md"
}
},
{
"name": "SECURITY.md",
"path": "SECURITY.md",
"sha": "4807686929f85d6e15eb364a303b857c3af0103b",
"size": 952,
"url": "https://api.github.com/repos/cline/cline/contents/SECURITY.md?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/SECURITY.md",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/4807686929f85d6e15eb364a303b857c3af0103b",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/SECURITY.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/SECURITY.md?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/4807686929f85d6e15eb364a303b857c3af0103b",
"html": "https://github.com/cline/cline/blob/main/SECURITY.md"
}
},
{
"name": "apps",
"path": "apps",
"sha": "3b76387f10e79e95031b636996178ba675814393",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/apps?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/apps",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/3b76387f10e79e95031b636996178ba675814393",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/apps?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/3b76387f10e79e95031b636996178ba675814393",
"html": "https://github.com/cline/cline/tree/main/apps"
}
},
{
"name": "assets",
"path": "assets",
"sha": "e4bf38205adcc40200a9cb8abb3acf3b66e489af",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/assets?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/assets",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/e4bf38205adcc40200a9cb8abb3acf3b66e489af",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/assets?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/e4bf38205adcc40200a9cb8abb3acf3b66e489af",
"html": "https://github.com/cline/cline/tree/main/assets"
}
},
{
"name": "biome.json",
"path": "biome.json",
"sha": "d3f6055e801b6b344c369608e342e1fdf1c36380",
"size": 4598,
"url": "https://api.github.com/repos/cline/cline/contents/biome.json?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/biome.json",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/d3f6055e801b6b344c369608e342e1fdf1c36380",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/biome.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/biome.json?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/d3f6055e801b6b344c369608e342e1fdf1c36380",
"html": "https://github.com/cline/cline/blob/main/biome.json"
}
},
{
"name": "bun.lock",
"path": "bun.lock",
"sha": "0039da676352591a02649dc8b977295c3fafbb56",
"size": 977222,
"url": "https://api.github.com/repos/cline/cline/contents/bun.lock?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/bun.lock",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/0039da676352591a02649dc8b977295c3fafbb56",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/bun.lock",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/bun.lock?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/0039da676352591a02649dc8b977295c3fafbb56",
"html": "https://github.com/cline/cline/blob/main/bun.lock"
}
},
{
"name": "docs",
"path": "docs",
"sha": "938f719bb649c6f4b6fc27bc35bbaf30c798ee70",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/docs?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/docs",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/938f719bb649c6f4b6fc27bc35bbaf30c798ee70",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/docs?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/938f719bb649c6f4b6fc27bc35bbaf30c798ee70",
"html": "https://github.com/cline/cline/tree/main/docs"
}
},
{
"name": "evals",
"path": "evals",
"sha": "2dfc0234caaee3f637e152f781533981c498ef54",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/evals?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/evals",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/2dfc0234caaee3f637e152f781533981c498ef54",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/evals?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/2dfc0234caaee3f637e152f781533981c498ef54",
"html": "https://github.com/cline/cline/tree/main/evals"
}
},
{
"name": "package.json",
"path": "package.json",
"sha": "5687bf7bd86a98da4b623e4588904ded82f06dc2",
"size": 3932,
"url": "https://api.github.com/repos/cline/cline/contents/package.json?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/package.json",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/5687bf7bd86a98da4b623e4588904ded82f06dc2",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/package.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/package.json?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/5687bf7bd86a98da4b623e4588904ded82f06dc2",
"html": "https://github.com/cline/cline/blob/main/package.json"
}
},
{
"name": "sdk",
"path": "sdk",
"sha": "5efb73aa9e074dd9da1c33a9fdb84ed3c28e2cb4",
"size": 0,
"url": "https://api.github.com/repos/cline/cline/contents/sdk?ref=main",
"html_url": "https://github.com/cline/cline/tree/main/sdk",
"git_url": "https://api.github.com/repos/cline/cline/git/trees/5efb73aa9e074dd9da1c33a9fdb84ed3c28e2cb4",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/sdk?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/trees/5efb73aa9e074dd9da1c33a9fdb84ed3c28e2cb4",
"html": "https://github.com/cline/cline/tree/main/sdk"
}
},
{
"name": "vitest.config.ts",
"path": "vitest.config.ts",
"sha": "f798e90e73bcbe76f08d362f89a1337fd66b9b8d",
"size": 312,
"url": "https://api.github.com/repos/cline/cline/contents/vitest.config.ts?ref=main",
"html_url": "https://github.com/cline/cline/blob/main/vitest.config.ts",
"git_url": "https://api.github.com/repos/cline/cline/git/blobs/f798e90e73bcbe76f08d362f89a1337fd66b9b8d",
"download_url": "https://raw.githubusercontent.com/cline/cline/main/vitest.config.ts",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/cline/cline/contents/vitest.config.ts?ref=main",
"git": "https://api.github.com/repos/cline/cline/git/blobs/f798e90e73bcbe76f08d362f89a1337fd66b9b8d",
"html": "https://github.com/cline/cline/blob/main/vitest.config.ts"
}
}
]
+37
View File
@@ -0,0 +1,37 @@
version: 1
domain_id: cline-cline
object:
type: github_repository
name: cline/cline
url: https://github.com/cline/cline
pulled_at: '2026-07-02T22:47:14+00:00'
puller: scripts/fetch-research-raw.py
files:
- path: repository/
kind: git-working-tree
status: ok
source: 'git clone --depth=1 --single-branch --no-tags https://github.com/cline/cline.git docs/research/cline-cline/raw/repository'
- path: github-repo.raw.json
kind: repository-metadata
status: ok
source: 'gh repo view cline/cline --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
- path: github-readme.raw.md.txt
kind: readme
status: ok
source: 'gh api repos/cline/cline/readme -H Accept: application/vnd.github.raw'
- path: github-license.raw.txt
kind: license
status: ok
source: 'gh api repos/cline/cline/license -H Accept: application/vnd.github.raw'
- path: github-root-contents.raw.json
kind: root-contents
status: ok
source: 'gh api repos/cline/cline/contents'
- path: github-languages.raw.json
kind: languages
status: ok
source: 'gh api repos/cline/cline/languages'
- path: github-latest-release.raw.json
kind: latest-release
status: ok
source: 'gh api repos/cline/cline/releases/latest'
+23
View File
@@ -0,0 +1,23 @@
# Daotin/ai-coding 研究域 Agent 指南
本目录维护 `Daotin/ai-coding` 的独立研究域。
## 目录职责
```text
daotin-ai-coding/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层:仓库元数据、研究角色、来源证据
└── raw/ # 原始事实层:拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `Daotin/ai-coding`,不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`,并更新 `observed_at`
- `raw/` 保存原始事实层,必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件;稳定事实摘要再同步到 `domain.yml`
- README 只写判断、定位、使用方式和后续观察点,不堆外部 README 全文。
- 如果需要横向比较,在 `docs/research/README.md` 或新的对比文档中处理,不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc``make test`
+56
View File
@@ -0,0 +1,56 @@
# Daotin/ai-coding 研究域
## 字多不看
- 本目录研究 `Daotin/ai-coding` 这个外部仓库。
- 当前优先级:P3;研究角色:AI Coding 经验汇总。
- GitHub 动态事实放在 `domain.yml`,观测日期为 2026-07-03。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>
### 细粒度目录
- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
</details>
## 使用方式
- 先读本 README 的判断,再读 `analysis.md` 的结构化研究结论,最后读 `domain.yml` 的事实字段。
- 需要引用 stars、forks、release、归档状态时,先重新核验 GitHub。
- 如果形成稳定方法论,再迁入 concepts、references、workflow 或 skills。
## 正文
### 研究定位
`Daotin/ai-coding` 的当前研究定位是:AI Coding 经验汇总。
### 当前判断
适合补充 Cursor、Claude Code、Codex、MCP、AGENTS.md 等实践素材。
### 观察字段
- GitHub URLhttps://github.com/Daotin/ai-coding
- 当前研究方向:`workflow-methodology`
- 当前优先级:P3
- 当前归档状态:`false`
- 主要语言:`None`
### 后续观察
- 是否有稳定文档结构、命令入口和可复用工作流。
- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。
@@ -0,0 +1,44 @@
# Daotin/ai-coding 研究分析
## 本轮结论
- 这是中文 AI Coding 资料与经验汇总,价值在主题覆盖,不在工程实现。
- README 将内容分成 AI 方法论、AI 工具、AI 经验、AI 科普、AI 实战、AI 思考、AI 提示词、MCP 等块。
- 适合作为本仓中文语境资源补充和关键词候选来源。
## 本地证据
- 研究对象:`Daotin/ai-coding`
- 当前研究角色:AI Coding 经验汇总
- 本轮成熟度:L1 初步理解
- 原始仓库:`raw/repository/`
- 原始来源清单:`raw/sources.yml`
- 事实摘要:`domain.yml`
## 结构观察
- 根目录包含 `README.md``package.json``BACKUP/` 和 GitHub 配置。
- 没有明显的核心应用源码,主体是文档索引和资料组织。
- 分类覆盖 Cursor、Claude Code、Codex、MCP、AGENTS.md 等 AI Coding 主题。
## 可借鉴点
- 可借鉴它的中文主题颗粒度,用于补本仓关键词系统和资源分类。
- 适合作为“中文社区正在关心什么”的观察点。
- 可把其中高价值链接转入 `assets/external-resources/` 做结构化管理。
## 风险和边界
- 资料聚合多于一手验证,不适合作为工程标准来源。
- 内容质量可能不均,需要二次核验。
- 如果直接复制,会让本仓变成资源堆。
## 下一轮研究任务
- 抽取与 MCP、AGENTS.md、Claude Code、Codex 相关的高频词。
- 筛选能进入本仓 references 或 concepts 的稳定经验。
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
+32
View File
@@ -0,0 +1,32 @@
version: 1
repo:
name: Daotin/ai-coding
source_name: Daotin/ai-coding
url: https://github.com/Daotin/ai-coding
research:
domain_id: daotin-ai-coding
domain_name: Daotin/ai-coding 研究域
primary_direction: workflow-methodology
role: AI Coding 经验汇总
priority: 3
why_study: 适合补充 Cursor、Claude Code、Codex、MCP、AGENTS.md 等实践素材。
github_observed:
observed_at: '2026-07-03'
source: gh repo view
stars: 65
forks: 6
archived: false
language: null
license: mit
default_branch: main
pushed_at: '2026-01-24T13:27:57Z'
updated_at: '2026-07-02T10:34:32Z'
latest_release: null
homepage: ''
topics: []
source_evidence:
file: ChatGPT-中文Vibe Coding仓库 (2).md
line: 35
maintenance:
fact_policy: GitHub 动态字段只代表 observed_at 当日快照,更新结论前必须重新核验。
split_policy: 本目录已经是一等研究域;更深分析放入本目录新增文档。
@@ -0,0 +1,12 @@
# raw/ Agent 指南
本目录是 `Daotin/ai-coding` 的原始事实层。
## 维护规则
- 只保存从研究对象拉取的一手材料,不写分析判断。
- `repository/` 是本地 Git 工作树,刷新时由脚本 clone 或 fast-forward pull。
- 不手工改写 `*.raw.*` 文件内容;需要刷新时运行 `python3 scripts/fetch-research-raw.py`
- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
- 外部 README 原文必须保存为 `.txt`,避免本仓库 Markdown 链接检查误判。
- 分析、判断、采用建议和沉淀路径写回上一级 `README.md``analysis.md``decisions.md`
@@ -0,0 +1,16 @@
# raw 事实层
本目录保存 `Daotin/ai-coding` 的本地原始材料快照。
这里不写分析结论,只保存可复查的一手资料:
- `sources.yml`:来源清单、拉取时间、命令和文件状态。
- `repository/`Git 仓库工作树;本目录由 `.gitignore` 忽略,只作为本地研究材料。
- `github-repo.raw.json`GitHub 仓库元数据。
- `github-readme.raw.md.txt`GitHub README 原文快照。
- `github-license.raw.txt`GitHub license 原文快照;仓库无 license 时可能不存在。
- `github-root-contents.raw.json`:默认分支根目录内容快照。
- `github-languages.raw.json`GitHub language 统计快照。
- `github-latest-release.raw.json`:最新 release 快照;无 release 时可能不存在。
`repository/` 是外部源码快照,不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存,避免其中的外部相对链接被本仓库 Markdown 链接检查误判。
@@ -0,0 +1 @@
{}
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2025 Daotin
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
@@ -0,0 +1,98 @@
# 📚 AI Coding
<!-- UPDATED_AT --> updated: 2026-01-02 21:43:22 <!-- UPDATED_AT -->
## 关于本仓库
一直以来,我对 AI Coding 充满热情和好奇。从最初的探索到如今的深度实践,这一年来,我持续学习各种 AI 辅助编程工具和方法论,并将它们应用到实际项目开发中。
本仓库汇集了我在 AI Coding 领域的:
- **方法论**:从 0 到 1 的实践经验和思考框架
- **实战案例**:真实项目中的 AI 应用场景
- **经验分享**:踩过的坑和总结的技巧
- **提示词技巧**:如何更高效地与 AI 协作
- **工具推荐**:实用的 AI 开发工具和工作流
希望这些内容能够帮助到同样对 AI Coding 感兴趣的朋友们,让我们一起探索 AI 赋能开发的无限可能!
<!-- ISSUES-LIST:START -->
<!-- 此列表由 GitHub Actions 自动生成,请勿手动修改 -->
## AI方法论
* [BMAD——基于Spec-kit理念的AI敏捷开发工作流](https://github.com/Daotin/ai-coding/issues/42) (2025-12-01)
* [AI赋能前端中后台开发](https://github.com/Daotin/ai-coding/issues/11) (2025-10-28)
* [AI Coding的正确范式](https://github.com/Daotin/ai-coding/issues/8) (2025-10-27)
* [AI Coding 维护现有项目](https://github.com/Daotin/ai-coding/issues/5) (2025-10-27)
* [AI Coding从0到1方法论](https://github.com/Daotin/ai-coding/issues/2) (2025-10-27)
## AI工具
* [OpenSkillsAI 编程助手的"Forge"](https://github.com/Daotin/ai-coding/issues/47) (2026-01-24)
* [一文搞懂MCP](https://github.com/Daotin/ai-coding/issues/41) (2025-11-07)
* [一文搞懂cursor](https://github.com/Daotin/ai-coding/issues/40) (2025-11-07)
* [自动化操作MCP](https://github.com/Daotin/ai-coding/issues/20) (2025-10-28)
* [Figma远程MCP](https://github.com/Daotin/ai-coding/issues/19) (2025-10-28)
* [Claude Code使用教程](https://github.com/Daotin/ai-coding/issues/18) (2025-10-28)
* [UI原型图+设计稿+Vibe Coding](https://github.com/Daotin/ai-coding/issues/17) (2025-10-28)
* [最佳AI开发工作流](https://github.com/Daotin/ai-coding/issues/16) (2025-10-28)
* [出海独立开发穷鬼全家桶](https://github.com/Daotin/ai-coding/issues/15) (2025-10-28)
* [UI原型图+设计稿](https://github.com/Daotin/ai-coding/issues/4) (2025-10-27)
## AI经验
* [AGENTS.md](https://github.com/Daotin/ai-coding/issues/44) (2025-12-15)
* [【转】AI Coding 实践技巧,告诉 AI 如何验证](https://github.com/Daotin/ai-coding/issues/38) (2025-11-03)
* [使用json样式设计文件,避免AI生成的页面有一股AI味儿。](https://github.com/Daotin/ai-coding/issues/28) (2025-10-28)
* [Vibe Coding 工作流LLM模型选择](https://github.com/Daotin/ai-coding/issues/27) (2025-10-28)
* [Codex使用技巧](https://github.com/Daotin/ai-coding/issues/26) (2025-10-28)
* [【摘录】AI Coding,其实很像做技术管理](https://github.com/Daotin/ai-coding/issues/9) (2025-10-28)
* [Andrej Karpathy 的 Vibe Coding 技巧](https://github.com/Daotin/ai-coding/issues/7) (2025-10-27)
* [cursor引入外部文档的方式](https://github.com/Daotin/ai-coding/issues/6) (2025-10-27)
## AI科普
* [MCP 和 Agent Skills 的核心区别](https://github.com/Daotin/ai-coding/issues/45) (2025-12-21)
## AI实战
* [Todo](https://github.com/Daotin/ai-coding/issues/36) (2025-10-29)
- [ ] AI+监控系统:监控大屏中,对于错误,增加 AI 修复建议
- [ ] AI+VSCode 插件:自研公司内部 vscode 插件,提效(生成自定义组件,echart,代码辅助等)
- [ ] AI+Agent(参考 [NC VSCode IDE](https://mp.weixin.qq.com/s/GwNnkuDvbDDLjp0MHtypQw)
- [ ] AI+自动化测试(参考 [使用 CodeX 调起 Chrome-devtools-mcp 做了其中一个关键场景走查](https://x.com/Stephen4171127/status/1972348138628464813)
* [小红书内容生成器(AI Agent)](https://github.com/Daotin/ai-coding/issues/14) (2025-10-28)
* [AI+游戏设计](https://github.com/Daotin/ai-coding/issues/13) (2025-10-28)
* [MCP原理解析及搭建私有组件库MCP](https://github.com/Daotin/ai-coding/issues/10) (2025-10-28)
* [自动删除 FG](https://github.com/Daotin/ai-coding/issues/1) (2025-10-27)
## AI思考
* [对于模糊的需求,可以让 AI 面试你,通过提问的形式一步步形成 SPEC 文档,然后使用该 SPEC 完成需求开发](https://github.com/Daotin/ai-coding/issues/46) (2026-01-02)
* [AI时代,资深工程师的价值在哪里?](https://github.com/Daotin/ai-coding/issues/39) (2025-11-05)
## AI提示词
* [使用json样式设计文件,避免AI生成的页面有一股AI味儿。](https://github.com/Daotin/ai-coding/issues/28) (2025-10-28)
* [AI洞察](https://github.com/Daotin/ai-coding/issues/25) (2025-10-28)
* [递归法写Prompt](https://github.com/Daotin/ai-coding/issues/24) (2025-10-28)
* [【摘录】为什么我用了那么多提示词模板甚至用了 AI 帮忙还是写不好提示词?](https://github.com/Daotin/ai-coding/issues/23) (2025-10-28)
* [AI+landing page](https://github.com/Daotin/ai-coding/issues/22) (2025-10-28)
* [AI+PPT](https://github.com/Daotin/ai-coding/issues/21) (2025-10-28)
* [AI设计网页svg](https://github.com/Daotin/ai-coding/issues/12) (2025-10-28)
* [APP设计稿](https://github.com/Daotin/ai-coding/issues/3) (2025-10-27)
## MCP
* [Todo](https://github.com/Daotin/ai-coding/issues/37) (2025-10-29)
- [ ] Story MCP:如果你们有 tapd 之类的需求平台,甚至可以自己实现一个 mcp 来让他拉取相对应项目的需求,基于 tapd 上的 story 在本地创建一个 story,做具体的任务拆解,分块完成。
- [ ] Story MCP:通过自己开发的 Jira MCP,连接到自己公司的 Jira 服务器,自动获取 bug,自动修复,自动 run dev 验证,自动 commit。
- [ ] API MCP:连接后端数据库,做前端 mock 代码生成
* [自动化操作MCP](https://github.com/Daotin/ai-coding/issues/20) (2025-10-28)
* [MCP原理解析及搭建私有组件库MCP](https://github.com/Daotin/ai-coding/issues/10) (2025-10-28)
<!-- ISSUES-LIST:END -->
# License
[MIT License](./LICENSE)
@@ -0,0 +1,28 @@
{
"createdAt": "2025-10-27T08:40:02Z",
"defaultBranchRef": {
"name": "main"
},
"description": "AI Coding 方法论,经验分享汇总",
"forkCount": 6,
"homepageUrl": "",
"isArchived": false,
"isFork": false,
"isMirror": false,
"latestRelease": null,
"licenseInfo": {
"key": "mit",
"name": "MIT License",
"nickname": ""
},
"nameWithOwner": "Daotin/ai-coding",
"primaryLanguage": null,
"pushedAt": "2026-01-24T13:27:57Z",
"repositoryTopics": null,
"stargazerCount": 65,
"updatedAt": "2026-07-02T10:34:32Z",
"url": "https://github.com/Daotin/ai-coding",
"watchers": {
"totalCount": 0
}
}
@@ -0,0 +1,114 @@
[
{
"name": ".github",
"path": ".github",
"sha": "f3e1f80647a43b2ea3d05c74627e644fbb66a5a8",
"size": 0,
"url": "https://api.github.com/repos/Daotin/ai-coding/contents/.github?ref=main",
"html_url": "https://github.com/Daotin/ai-coding/tree/main/.github",
"git_url": "https://api.github.com/repos/Daotin/ai-coding/git/trees/f3e1f80647a43b2ea3d05c74627e644fbb66a5a8",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Daotin/ai-coding/contents/.github?ref=main",
"git": "https://api.github.com/repos/Daotin/ai-coding/git/trees/f3e1f80647a43b2ea3d05c74627e644fbb66a5a8",
"html": "https://github.com/Daotin/ai-coding/tree/main/.github"
}
},
{
"name": ".gitignore",
"path": ".gitignore",
"sha": "832bf5731fff19fbd187b82227368466820f9015",
"size": 290,
"url": "https://api.github.com/repos/Daotin/ai-coding/contents/.gitignore?ref=main",
"html_url": "https://github.com/Daotin/ai-coding/blob/main/.gitignore",
"git_url": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/832bf5731fff19fbd187b82227368466820f9015",
"download_url": "https://raw.githubusercontent.com/Daotin/ai-coding/main/.gitignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Daotin/ai-coding/contents/.gitignore?ref=main",
"git": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/832bf5731fff19fbd187b82227368466820f9015",
"html": "https://github.com/Daotin/ai-coding/blob/main/.gitignore"
}
},
{
"name": "BACKUP",
"path": "BACKUP",
"sha": "a6d6e7c090616bae27f3be223b6edb586359489d",
"size": 0,
"url": "https://api.github.com/repos/Daotin/ai-coding/contents/BACKUP?ref=main",
"html_url": "https://github.com/Daotin/ai-coding/tree/main/BACKUP",
"git_url": "https://api.github.com/repos/Daotin/ai-coding/git/trees/a6d6e7c090616bae27f3be223b6edb586359489d",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/Daotin/ai-coding/contents/BACKUP?ref=main",
"git": "https://api.github.com/repos/Daotin/ai-coding/git/trees/a6d6e7c090616bae27f3be223b6edb586359489d",
"html": "https://github.com/Daotin/ai-coding/tree/main/BACKUP"
}
},
{
"name": "LICENSE",
"path": "LICENSE",
"sha": "c8d4aa9f1a25f65281532f55a3d16b444c7263f8",
"size": 1063,
"url": "https://api.github.com/repos/Daotin/ai-coding/contents/LICENSE?ref=main",
"html_url": "https://github.com/Daotin/ai-coding/blob/main/LICENSE",
"git_url": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/c8d4aa9f1a25f65281532f55a3d16b444c7263f8",
"download_url": "https://raw.githubusercontent.com/Daotin/ai-coding/main/LICENSE",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Daotin/ai-coding/contents/LICENSE?ref=main",
"git": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/c8d4aa9f1a25f65281532f55a3d16b444c7263f8",
"html": "https://github.com/Daotin/ai-coding/blob/main/LICENSE"
}
},
{
"name": "README.md",
"path": "README.md",
"sha": "f0b7abe6849f9d1da9d7e25ac914798a9a8e52c1",
"size": 6109,
"url": "https://api.github.com/repos/Daotin/ai-coding/contents/README.md?ref=main",
"html_url": "https://github.com/Daotin/ai-coding/blob/main/README.md",
"git_url": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/f0b7abe6849f9d1da9d7e25ac914798a9a8e52c1",
"download_url": "https://raw.githubusercontent.com/Daotin/ai-coding/main/README.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Daotin/ai-coding/contents/README.md?ref=main",
"git": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/f0b7abe6849f9d1da9d7e25ac914798a9a8e52c1",
"html": "https://github.com/Daotin/ai-coding/blob/main/README.md"
}
},
{
"name": "package-lock.json",
"path": "package-lock.json",
"sha": "5e9ab40f96adc7d1d194e91326f91e7bc54acde1",
"size": 7646,
"url": "https://api.github.com/repos/Daotin/ai-coding/contents/package-lock.json?ref=main",
"html_url": "https://github.com/Daotin/ai-coding/blob/main/package-lock.json",
"git_url": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/5e9ab40f96adc7d1d194e91326f91e7bc54acde1",
"download_url": "https://raw.githubusercontent.com/Daotin/ai-coding/main/package-lock.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Daotin/ai-coding/contents/package-lock.json?ref=main",
"git": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/5e9ab40f96adc7d1d194e91326f91e7bc54acde1",
"html": "https://github.com/Daotin/ai-coding/blob/main/package-lock.json"
}
},
{
"name": "package.json",
"path": "package.json",
"sha": "a0632d63c2fe76652a91aa93408a6f3f3a96ee3f",
"size": 243,
"url": "https://api.github.com/repos/Daotin/ai-coding/contents/package.json?ref=main",
"html_url": "https://github.com/Daotin/ai-coding/blob/main/package.json",
"git_url": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/a0632d63c2fe76652a91aa93408a6f3f3a96ee3f",
"download_url": "https://raw.githubusercontent.com/Daotin/ai-coding/main/package.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/Daotin/ai-coding/contents/package.json?ref=main",
"git": "https://api.github.com/repos/Daotin/ai-coding/git/blobs/a0632d63c2fe76652a91aa93408a6f3f3a96ee3f",
"html": "https://github.com/Daotin/ai-coding/blob/main/package.json"
}
}
]
@@ -0,0 +1,38 @@
version: 1
domain_id: daotin-ai-coding
object:
type: github_repository
name: Daotin/ai-coding
url: https://github.com/Daotin/ai-coding
pulled_at: '2026-07-02T22:47:14+00:00'
puller: scripts/fetch-research-raw.py
files:
- path: repository/
kind: git-working-tree
status: ok
source: 'git clone --depth=1 --single-branch --no-tags https://github.com/Daotin/ai-coding.git docs/research/daotin-ai-coding/raw/repository'
- path: github-repo.raw.json
kind: repository-metadata
status: ok
source: 'gh repo view Daotin/ai-coding --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
- path: github-readme.raw.md.txt
kind: readme
status: ok
source: 'gh api repos/Daotin/ai-coding/readme -H Accept: application/vnd.github.raw'
- path: github-license.raw.txt
kind: license
status: ok
source: 'gh api repos/Daotin/ai-coding/license -H Accept: application/vnd.github.raw'
- path: github-root-contents.raw.json
kind: root-contents
status: ok
source: 'gh api repos/Daotin/ai-coding/contents'
- path: github-languages.raw.json
kind: languages
status: ok
source: 'gh api repos/Daotin/ai-coding/languages'
- path: github-latest-release.raw.json
kind: latest-release
status: missing_or_error
source: 'gh api repos/Daotin/ai-coding/releases/latest'
message: 'gh: Not Found (HTTP 404)'
@@ -0,0 +1,26 @@
# datawhalechina/easy-vibe 研究域 Agent 指南
本目录维护 `datawhalechina/easy-vibe` 的独立研究域。
## 目录职责
```text
datawhalechina-easy-vibe/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层:仓库元数据、研究角色、来源证据
├── analysis.md # L1 结构化研究结论、可借鉴点、风险和下一轮任务
├── deep-dive.md # L2 源码/结构深度研究、关键机制和可迁移模式
└── raw/ # 原始事实层:拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `datawhalechina/easy-vibe`,不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`,并更新 `observed_at`
- `raw/` 保存原始事实层,必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件;稳定事实摘要再同步到 `domain.yml`
- README 只写判断、定位、使用方式和后续观察点,不堆外部 README 全文。
- `analysis.md` 写 L1 结构化理解;`deep-dive.md` 写 L2 源码证据、关键机制和可迁移模式。
- 如果需要横向比较,在 `docs/research/README.md` 或新的对比文档中处理,不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc``make test`
@@ -0,0 +1,58 @@
# datawhalechina/easy-vibe 研究域
## 字多不看
- 本目录研究 `datawhalechina/easy-vibe` 这个外部仓库。
- 当前优先级:P2;研究角色:中文分阶段交互式课程。
- GitHub 动态事实放在 `domain.yml`,观测日期为 2026-07-03。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
| [deep-dive.md](deep-dive.md) | L2 源码/结构深度研究、关键机制和可迁移模式。 |
| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>
### 细粒度目录
- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
- [deep-dive.md](deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
</details>
## 使用方式
- 先读本 README 的判断,再读 `analysis.md``deep-dive.md` 的研究结论,最后读 `domain.yml`
- 需要引用 stars、forks、release、归档状态时,先重新核验 GitHub。
- 如果形成稳定方法论,再迁入 concepts、references、workflow 或 skills。
## 正文
### 研究定位
`datawhalechina/easy-vibe` 的当前研究定位是:中文分阶段交互式课程。
### 当前判断
适合研究学习地图、交互式教程和现代前端课程包装。
### 观察字段
- GitHub URLhttps://github.com/datawhalechina/easy-vibe
- 当前研究方向:`cn-onboarding`
- 当前优先级:P2
- 当前归档状态:`false`
- 主要语言:`JavaScript`
### 后续观察
- 是否有稳定文档结构、命令入口和可复用工作流。
- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。
@@ -0,0 +1,44 @@
# datawhalechina/easy-vibe 研究分析
## 本轮结论
- Easy Vibe 是中文 Vibe Coding 课程型站点,重点在学习路径、课程包装和面向不同目标的路线分流。
- 它比单纯 awesome list 更接近产品化教程,有 `docs/``config/``scripts/``llms.txt``AGENTS.md``CLAUDE.md` 等 AI/文档工程资产。
- 本仓应重点吸收它的学习路径分层、课程入口设计、Agent 文档入口和多语言/站点化组织方式。
## 本地证据
- 研究对象:`datawhalechina/easy-vibe`
- 当前研究角色:中文分阶段交互式课程
- 本轮成熟度:L1 初步理解
- 原始仓库:`raw/repository/`
- 原始来源清单:`raw/sources.yml`
- 事实摘要:`domain.yml`
## 结构观察
- 根目录包含 `docs/``docs-readme/``config/``scripts/``assets/``Dockerfile``package.json`
- README 将用户分成 fast first win、idea to prototype、full-stack products、AI-Native advanced workflow、reference material 等学习路径。
- 存在 `AGENTS.md``CLAUDE.md``llms.txt`,说明它已经考虑 AI Agent 可读入口。
## 可借鉴点
- 学习路线不应只按技术栈组织,也应按用户目标和阶段组织。
- 课程站点可以同时服务人类读者和 AI 助手,关键是保留 `llms.txt` 与目录规则。
- 适合对照本仓 getting-started 和 docs/README 的新手路径设计。
## 风险和边界
- 课程内容规模大且多语言/多目录,直接迁移会增加维护成本。
- 它偏学习体验,不等同于企业级工程治理模板。
- 站点生成和课程结构需要拆开研究,不能混成一个结论。
## 下一轮研究任务
- 读取 `docs/` 的学习路径结构,抽象为本仓学习地图改进建议。
- 研究 `AGENTS.md``CLAUDE.md``llms.txt` 如何服务 AI 读取。
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
@@ -0,0 +1,86 @@
# datawhalechina/easy-vibe 深度研究
## 研究级别
- 当前级别:L2 源码/结构深度研究。
- 研究对象:`datawhalechina/easy-vibe`
- 证据来源:本目录 `raw/` 下的 GitHub 元数据、README 快照和本地仓库工作树。
- 观察日期:2026-07-03。
## L2 结论
`datawhalechina/easy-vibe` 是课程站点化最强的中文 Vibe Coding 对标对象。它不是简单 Markdown
教程,而是用 VitePress、多语言目录、交互式组件、站点部署脚本、`llms.txt``AGENTS.md`
`CLAUDE.md` 把课程包装成面向人类和 AI 的学习产品。
对本仓最有价值的点不是复制它的站点复杂度,而是学习它如何把“零基础学习路径”拆成用户目标、
学习阶段、视觉演示、交互组件和 AI 可读入口。
## 源码证据
- `raw/repository/README.md`:主叙事入口,包含学习路径、多语言入口、在线阅读和本地运行说明。
- `raw/repository/docs/`VitePress 文档主体。
- `raw/repository/docs-readme/`:多语言 README 入口。
- `raw/repository/docs/zh-cn/index.md`:中文内容入口。
- `raw/repository/docs/en/index.md`:英文内容入口。
- `raw/repository/docs/public/llms.txt`:站点级 AI 读取入口。
- `raw/repository/llms.txt`:仓库级 AI 读取入口。
- `raw/repository/AGENTS.md`Agent 操作入口。
- `raw/repository/CLAUDE.md`Claude 入口。
- `raw/repository/docs/.vitepress/config.mjs`:站点配置、多语言和部署环境逻辑。
- `raw/repository/scripts/build-locales.mjs`:多语言构建脚本。
- `raw/repository/scripts/generate-sitemap.mjs`:站点 sitemap 生成脚本。
- `raw/repository/package.json`VitePress、Vue、Element Plus、Mermaid、Reveal.js 等站点依赖和命令。
## 关键机制
### 学习路径按用户目标组织
Easy Vibe 的 README 把读者导向不同路径,而不是只按技术章节线性排列。它面向的是“我是谁、
我想做什么、应该从哪开始”的 onboarding 问题。这比纯目录更适合零基础和跨背景读者。
### 课程站点和 AI 入口并存
仓库同时保留 VitePress 站点、`llms.txt``AGENTS.md``CLAUDE.md`。这说明成熟教程需要同时
服务三类读取者:浏览器用户、搜索引擎/AI 引用系统、AI Agent。
### 多语言是产品能力,不是翻译附件
`docs-readme/`、多语言目录和 `config.mjs` 中的 locale 配置说明,多语言不是附属文件,而是站点
路由、构建、SEO 和内容维护的一部分。多语言会显著提升触达,但也显著提高维护成本。
### 交互式解释降低新手门槛
assets 中的 IDE、RAG、terminal、diffusion 等视觉材料说明,零基础教程不能只靠概念解释。
可视化和交互式组件能把抽象工程概念变成可感知流程。
## 可迁移模式
- 本仓 getting-started 应按“用户身份 + 目标产出 + 当前阶段”重组入口,而不只按知识分类。
- 对关键教程增加“你将做出什么”“需要什么前置条件”“卡住怎么验证”。
- `llms.txt``assets/ai-citation/llms-full.txt` 应继续作为 AI 入口维护,而不是事后补充。
- 如果未来站点化,应先保留轻量结构,避免过早引入多语言构建复杂度。
- 对 RAG、terminal、Git、IDE、agent 等抽象主题增加可视化解释或最小交互示例。
## 对本仓的影响
本仓当前优势是治理、研究域、资源和质量门禁;Easy Vibe 的优势是课程产品化和新手体验。
两者结合后,本仓可形成两层入口:
- `getting-started/`:面向新手的目标导向学习路径。
- `references/``workflow/``research/`:面向进阶用户和维护者的工程治理层。
关键取舍是:吸收学习路径和 AI 入口设计,不复制完整多语言站点复杂度。
## 风险和待验证项
- 多语言和站点组件会显著增加维护成本,本仓不能为了展示效果牺牲文档治理稳定性。
- 本轮没有运行 Easy Vibe 的构建、测试和多语言脚本。
- 站点视觉资产丰富,但不等同于工程治理成熟度。
## 下一步 L3 验证任务
- 对照 Easy Vibe 的学习路径,重审本仓 `docs/getting-started/` 是否按用户目标组织。
- 为本仓补一个“零基础到第一个可部署产物”的路径表。
- 抽取 AI 入口设计经验,更新 `llms.txt` / `llms-full.txt` 维护规则。
- 评估是否需要为关键概念增加图片、流程图或交互式示例。
@@ -0,0 +1,52 @@
version: 1
repo:
name: datawhalechina/easy-vibe
source_name: datawhalechina/easy-vibe
url: https://github.com/datawhalechina/easy-vibe
research:
domain_id: datawhalechina-easy-vibe
domain_name: datawhalechina/easy-vibe 研究域
primary_direction: cn-onboarding
role: 中文分阶段交互式课程
priority: 2
why_study: 适合研究学习地图、交互式教程和现代前端课程包装。
github_observed:
observed_at: '2026-07-03'
source: gh repo view
stars: 17686
forks: 1673
archived: false
language: JavaScript
license: null
default_branch: main
pushed_at: '2026-06-17T01:53:13Z'
updated_at: '2026-07-02T21:29:04Z'
latest_release: null
homepage: https://datawhalechina.github.io/easy-vibe/
topics:
- ai
- course
- vibe-coding
- coding
- genai
- low-code
- no-code
- programming
- tutorial
- vibecoding
- vscode
- agent
- gemini
- gpt
- llm
- nextjs
- openai
- workflow
- mcp
- deepseek
source_evidence:
file: ChatGPT-中文Vibe Coding仓库 (2).md
line: 26
maintenance:
fact_policy: GitHub 动态字段只代表 observed_at 当日快照,更新结论前必须重新核验。
split_policy: 本目录已经是一等研究域;更深分析放入本目录新增文档。
@@ -0,0 +1,12 @@
# raw/ Agent 指南
本目录是 `datawhalechina/easy-vibe` 的原始事实层。
## 维护规则
- 只保存从研究对象拉取的一手材料,不写分析判断。
- `repository/` 是本地 Git 工作树,刷新时由脚本 clone 或 fast-forward pull。
- 不手工改写 `*.raw.*` 文件内容;需要刷新时运行 `python3 scripts/fetch-research-raw.py`
- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
- 外部 README 原文必须保存为 `.txt`,避免本仓库 Markdown 链接检查误判。
- 分析、判断、采用建议和沉淀路径写回上一级 `README.md``analysis.md``decisions.md`
@@ -0,0 +1,16 @@
# raw 事实层
本目录保存 `datawhalechina/easy-vibe` 的本地原始材料快照。
这里不写分析结论,只保存可复查的一手资料:
- `sources.yml`:来源清单、拉取时间、命令和文件状态。
- `repository/`Git 仓库工作树;本目录由 `.gitignore` 忽略,只作为本地研究材料。
- `github-repo.raw.json`GitHub 仓库元数据。
- `github-readme.raw.md.txt`GitHub README 原文快照。
- `github-license.raw.txt`GitHub license 原文快照;仓库无 license 时可能不存在。
- `github-root-contents.raw.json`:默认分支根目录内容快照。
- `github-languages.raw.json`GitHub language 统计快照。
- `github-latest-release.raw.json`:最新 release 快照;无 release 时可能不存在。
`repository/` 是外部源码快照,不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存,避免其中的外部相对链接被本仓库 Markdown 链接检查误判。
@@ -0,0 +1,5 @@
{
"JavaScript": 17384,
"Dockerfile": 774,
"Shell": 502
}
@@ -0,0 +1,448 @@
<!-- trigger vercel build -->
<div align="center">
<img src="assets/easy-vibe-logo-hd.svg" alt="Easy-Vibe Logo" width="300">
<img src="assets/banner.png" alt="Easy-Vibe Banner" width="100%">
<p align="center" style="font-size: 1.2em; color: #666; margin: 20px 0;">
Jump right in and vibe together — if you can talk, you can build apps.<br>
<span style="font-size: 0.9em; color: #888;">直接上手,一起 vibe!会说话就会做应用。</span>
</p>
<a href="https://trendshift.io/repositories/22079" target="_blank"><img src="https://trendshift.io/api/badge/repositories/22079" alt="datawhalechina/easy-vibe | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
<p align="center" style="font-size: 1.05em; color: #666; margin: 16px 0;">
你好 · Hello · 哈囉 · こんにちは · 안녕하세요 · Hola · Bonjour · Hallo · مرحبا · Xin chào<br>
Our tutorial supports 10 languages. Let's code together!<br>
<span style="font-size: 0.9em; color: #888;">我们的教程支持 10 种语言,欢迎世界各地的朋友一起 coding</span>
</p>
<p align="center">
🚀 <a href="https://datawhalechina.github.io/easy-vibe/welcome.html">Start Exploring</a> · ✨ <a href="https://datawhalechina.github.io/easy-vibe/en/appendix/">Interactive Tutorial</a> · 🦞 <a href="https://github.com/datawhalechina/hello-claw">Learn OpenClaw</a> · 📖 <a href="#table-of-contents">Table of Contents</a><br>
<span style="font-size: 0.85em; color: #888;">🚀 <a href="https://datawhalechina.github.io/easy-vibe/welcome.html">开始体验</a> · ✨ <a href="https://datawhalechina.github.io/easy-vibe/zh-cn/appendix/">交互式教程</a> · 🦞 <a href="https://github.com/datawhalechina/hello-claw">学习 OpenClaw</a> · 📖 <a href="#table-of-contents">查看目录</a></span>
</p>
<p align="center">
<a href="https://datawhalechina.github.io/easy-vibe/welcome.html">Read Online</a> ·
<a href="#-content-navigation">Learning Map</a><br>
<span style="font-size: 0.85em; color: #888;">
<a href="https://datawhalechina.github.io/easy-vibe/welcome.html">开始阅读</a> ·
<a href="#-content-navigation">学习地图</a>
</span>
</p>
<p align="center">
<a href="https://github.com/datawhalechina/easy-vibe/stargazers" target="_blank">
<img src="https://img.shields.io/github/stars/datawhalechina/easy-vibe?color=660874&style=for-the-badge&logo=star&logoColor=white&labelColor=1a1a2e" alt="Stars"></a>
<a href="https://github.com/datawhalechina/easy-vibe/network/members" target="_blank">
<img src="https://img.shields.io/github/forks/datawhalechina/easy-vibe?color=660874&style=for-the-badge&logo=git-fork&logoColor=white&labelColor=1a1a2e" alt="Forks"></a>
<a href="LICENSE" target="_blank">
<img src="https://img.shields.io/badge/License-CC_BY_NC_SA_4.0-4ecdc4?style=for-the-badge&logo=creative-commons&logoColor=white&labelColor=1a1a2e" alt="License"></a>
</p>
<p align="center">
<a href="README.md"><img alt="English" src="https://img.shields.io/badge/English-d9d9d9"></a>
<a href="docs-readme/zh-CN/README.md"><img alt="简体中文" src="https://img.shields.io/badge/简体中文-d9d9d9"></a>
<a href="docs-readme/zh-TW/README.md"><img alt="繁體中文" src="https://img.shields.io/badge/繁體中文-d9d9d9"></a>
<a href="docs-readme/ja-JP/README.md"><img alt="日本語" src="https://img.shields.io/badge/日本語-d9d9d9"></a>
<a href="docs-readme/es-ES/README.md"><img alt="Español" src="https://img.shields.io/badge/Español-d9d9d9"></a>
<a href="docs-readme/fr-FR/README.md"><img alt="Français" src="https://img.shields.io/badge/Français-d9d9d9"></a>
<a href="docs-readme/ko-KR/README.md"><img alt="한국어" src="https://img.shields.io/badge/한국어-d9d9d9"></a>
<a href="docs-readme/ar-SA/README.md"><img alt="العربية" src="https://img.shields.io/badge/العربية-d9d9d9"></a>
<a href="docs-readme/vi-VN/README.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a>
<a href="docs-readme/de-DE/README.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a>
</p>
</div>
<table align="center">
<tr>
<td width="50%" valign="top" align="center">
<img src="assets/gif-header.png" width="100%">
<br>
<strong>A beginner-friendly learning map</strong>
<br>
<sub>Clear guidance from zero, so you can stop "learning and forgetting"</sub>
</td>
<td width="50%" valign="top" align="center">
<img src="assets/gif-tutorial.png" width="100%">
<br>
<strong>Step-by-step visual tutorials</strong>
<br>
<sub>Detailed walkthroughs that feel like learning with a private tutor</sub>
</td>
</tr>
<tr>
<td width="50%" valign="top" align="center">
<img src="assets/gif-ide.gif" width="100%">
<br>
<strong>Immersive simulated coding</strong>
<br>
<sub>Virtual mouse guidance helps you quickly learn the core IDE workflow</sub>
</td>
<td width="50%" valign="top" align="center">
<img src="assets/gif-diffusion.gif" width="100%">
<br>
<strong>Visible AI principles</strong>
<br>
<sub>Animated explanations make it easy to see how AI generates images</sub>
</td>
</tr>
<tr>
<td width="50%" valign="top" align="center">
<img src="assets/gif-rag.gif" width="100%">
<br>
<strong>Learn RAG like a game</strong>
<br>
<sub>Interactive components let you click through the full RAG data flow</sub>
</td>
<td width="50%" valign="top" align="center">
<img src="assets/git-terminal.gif" width="100%">
<br>
<strong>Visual terminal concepts</strong>
<br>
<sub>Command-line behavior becomes intuitive when the underlying logic is visualized</sub>
</td>
</tr>
</table>
<div align="center">
<h3>⭐ <a href="https://github.com/datawhalechina/easy-vibe" style="color: #d0cd16ff;">Star the repo here</a> to help accelerate updates ❤️</h3>
</div>
<div align="center" style="margin: 30px 0;">
<a href="https://github.com/datawhalechina/easy-vibe/issues/new?template=story_submission.md">
<img src="https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/assets/stories_image.png" alt="Share Your Vibe Story" width="80%" style="border-radius: 10px; box-shadow: 0 4px 12px rgba(0,0,0,0.15);">
</a>
<p style="margin-top: 15px; font-size: 1.1em; color: #666;">
📝 <strong>Have your own vibe coding story?</strong>
Submit it here and inspire others!
</p>
</div>
## Table of Contents
- [Why Easy-Vibe](#why-easy-vibe)
- [News](#-news)
- [Who This Is For](#who-this-is-for)
- [Your Learning Paths](#your-learning-paths)
- [Study Suggestions](#study-suggestions)
- [I. Beginner Entry](#i-beginner-entry)
- [II. Junior and Mid-Level Developers](#ii-junior-and-mid-level-developers)
- [III. Advanced Developers](#iii-advanced-developers)
- [Appendix Knowledge Base](#-appendix-knowledge-base)
- [How To Learn](#-how-to-learn)
- [Run Locally](#-run-locally)
- [Other Courses](#other-courses)
- [Contributing & Contributors](#-contributing--contributors)
- [LICENSE](#-license)
## Why Easy-Vibe
Want an expense tracker? Say it.
Need a booking system with WeChat login? Say it.
Want a blog with comments? Say it.
In the AI era, programming starts by describing what you want.
Easy-Vibe teaches you how to turn that into a real product.
## 🔥 News
- **[2026-06-17]** 🌍 **Full multilingual coverage complete**: All tutorial content (Stages 1-3) is now available in 10 languages (zh-cn, en, zh-tw, ja-jp, ko-kr, es-es, fr-fr, de-de, ar-sa, vi-vn), covering product prototyping, full-stack development, and cross-platform development.
- **[2026-03-29]** ✨ **Vibe Stories launched and upgraded with real user journeys**: Added a new homepage Vibe Stories section with an interactive carousel and dedicated story pages, then replaced placeholder content with four real user stories featuring a rural primary school teacher, a college student, a high school IT teacher, and a truck driver who built real products with AI. [👉 View the stories](https://datawhalechina.github.io/easy-vibe/zh-cn/vibe-stories/story-1.html)
- **[2026-03-26]** 🚀 **Major Stage 2 practice update**: Completed the SaaS capstone project "[Your First SaaS Full-Stack App: Copywriting Generator Website](https://datawhalechina.github.io/easy-vibe/en/stage-2/assignments/fullstack-app/)" and substantially expanded the "[How to integrate Stripe and payment systems](https://datawhalechina.github.io/easy-vibe/en/stage-2/backend/stripe-payment/)" section, plus key content around multi-product UI and WeChat Mini Program backend workflows.
- **[2026-03-25]** 📚 **New appendix: User Research and Requirement Validation**: Added four new articles covering idea sourcing, the Double Diamond model, Jobs to Be Done, and The Mom Test to help beginners discover and validate product ideas. [👉 Read the appendix](https://datawhalechina.github.io/easy-vibe/en/appendix/)
- **[2026-03-25]** 📚 **English documentation fully updated**: Stage 2 (Full-stack Development) and Stage 3 (Advanced Development) are now fully available in English. [👉 Start learning](https://datawhalechina.github.io/easy-vibe/en/stage-2/)
<details>
<summary>Past News</summary>
- **[2026-03-02]** 🦞 **OpenClaw and AI Agent friendly support**: Added `llms.txt` so OpenClaw, Claude, Cursor, Trae, and other AI agents can quickly understand the repository structure and find the right tutorial content.
- **[2026-03-01]** The [Advanced Development section](https://datawhalechina.github.io/easy-vibe/en/stage-3/) has been comprehensively upgraded with deep guides for Claude Code, including MCP, Skills, Agent Teams, and more, along with eight cross-platform project tutorials.
- **[2026-02-25]** Updated the [Appendix Knowledge Base](https://datawhalechina.github.io/easy-vibe/en/appendix/), now covering 9 knowledge areas and 80+ interactive topics.
- **[2026-01-27]** Added Android and iOS app development tutorials.
- **[2026-01-19]** Released interactive demos for Prompt Engineering, AI history, authentication design, Git principles, and more.
- **[2026-01-16]** Reorganized the project structure and formally established a beginner entry path.
- **[2026-01-14]** Completed a large update to the Stage 1 product prototyping docs.
- **[2026-01-13]** Refactored the documentation architecture and fully enabled multi-language support.
- **[2026-01-01]** Released the core learning map for the project.
</details>
## Who This Is For
- **Complete beginners**: Build your first project first, then understand how it works
- **Product managers / founders**: Validate ideas fast and build MVPs at low cost
- **Students**: Develop practical skills for the AI era
- **Junior developers**: Learn the full path from idea to launch
- **Mid-level and senior developers**: Upgrade your AI collaboration workflow for complex projects
## Your Learning Paths
### 🎮 I want a fast first win
**Best for**: Everyone
**What you will learn**: What AI coding actually feels like through a simple, concrete hands-on example
**What you will get**: A clear first impression of vibe coding and how to work with AI by conversation
[Start here](https://datawhalechina.github.io/easy-vibe/en/stage-1/ai-capabilities-through-games/)
### 💡 I want to turn an idea into a product prototype
**Best for**: Beginners / product managers / founders
**What you will learn**: Learning roadmap, AI IDE tools, idea validation, prototyping, AI capability integration, and full demo iteration
**What you will get**: A demoable AI product prototype you can actually show to users or teammates
[Start learning](https://datawhalechina.github.io/easy-vibe/en/stage-1/learning-map/)
### 🚀 I want to build full-stack products end to end
**Best for**: Junior developers / indie hackers / advanced learners
**What you will learn**: Frontend workflows, design-to-code, databases, backend APIs, deployment, billing, and major projects
**What you will get**: The ability to independently ship modern AI-enabled web applications
[Start learning](https://datawhalechina.github.io/easy-vibe/en/stage-2/)
### AI-Native: I want advanced Claude Code and agent workflows
**Best for**: Developers interested in AI-native engineering
**What you will learn**: Claude Code, MCP, Skills, Agent Teams, long-running tasks, Spec Coding, and cross-platform app delivery
**What you will get**: A stronger workflow for complex AI-assisted development and automation
[Go to advanced development](https://datawhalechina.github.io/easy-vibe/en/stage-3/)
### 📚 I want reference material and fundamentals
**Best for**: Everyone
**What you will learn**: Computer fundamentals, frontend/backend basics, infrastructure, AI principles, and engineering practices
**What you will get**: A long-term reference knowledge base covering 9 major knowledge areas
[Browse the knowledge base](https://datawhalechina.github.io/easy-vibe/en/appendix/)
## Study Suggestions
- If you are a beginner, product manager, or founder, start with [Stage 1](https://datawhalechina.github.io/easy-vibe/en/stage-1/learning-map/)
- If you want to move from prototypes to full-stack delivery, start with [Stage 2](https://datawhalechina.github.io/easy-vibe/en/stage-2/)
- If you want advanced Claude Code workflows or cross-platform projects, go to [Stage 3](https://datawhalechina.github.io/easy-vibe/en/stage-3/)
- If you get blocked by concepts or missing background knowledge, use the [Appendix Knowledge Base](https://datawhalechina.github.io/easy-vibe/en/appendix/)
### 📖 Content Navigation
<div align="center">
<img src="assets/readme-image1.png" alt="Learning Map" width="70%" style="border-radius: 10px; box-shadow: 0 8px 20px rgba(45,55,72,0.3); margin: 15px 0;"/>
</div>
### I. Beginner Entry
| Section | Key Content |
| :------ | :---------- |
| [Learning Map](https://datawhalechina.github.io/easy-vibe/en/stage-1/learning-map/) | A guided overview of the full learning journey |
| [AI Era: If You Can Speak, You Can Code](https://datawhalechina.github.io/easy-vibe/en/stage-1/ai-capabilities-through-games/) | Get your first feel for AI coding through examples like Snake |
| [Master AI Programming Tools](https://datawhalechina.github.io/easy-vibe/en/stage-1/introduction-to-ai-ide/) | Learn how AI IDE tools work and build simple local projects with them |
| [Find Great Ideas](https://datawhalechina.github.io/easy-vibe/en/stage-1/finding-great-idea/) | Learn how to discover and validate product ideas worth building |
| [Build Product Prototypes](https://datawhalechina.github.io/easy-vibe/en/stage-1/building-prototype/) | Move from requirements to single-page and multi-page product prototypes |
| [Integrate AI Capabilities](https://datawhalechina.github.io/easy-vibe/en/stage-1/integrating-ai-capabilities/) | Integrate text, image, and video AI features |
| [Complete project practice](https://datawhalechina.github.io/easy-vibe/en/stage-1/complete-project-practice/) | Simulate real scenarios, collect user feedback, and iterate on a full project |
#### Appendix: Product and Business Thinking
| Section | Key Content |
| :------ | :---------- |
| [Product Thinking and Solution Design](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-a-product-thinking/) | Core frameworks for going from zero to one with a product |
| [AI Industry Application Scenarios (B-end)](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-industry-scenarios/) | Understand how AI is applied across industries |
| [AI Consumer Scenarios Inspiration (C-end)](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-c-consumer-scenarios/) | Explore product opportunities in consumer AI |
#### Appendix: User Research and Requirement Validation
| Section | Key Content |
| :------ | :---------- |
| [Where to find ideas: 3 reference sources that work best for beginners](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-idea-sources/) | Build a reliable pipeline for finding concrete product opportunities |
| [Double Diamond: first do the right thing, then do it right](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-double-diamond/) | Use a structured process to move from scattered inspiration to a workable direction |
| [Use Jobs to Be Done to find what users really want done](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-jobs-to-be-done/) | Analyze user goals through real tasks instead of surface-level feature requests |
| [The Mom Test: a user interview method for validating demand](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-mom-test/) | Learn how to ask better questions and avoid false-positive feedback |
#### Appendix: Technical Solutions
| Section | Key Content |
| :------ | :---------- |
| [What to do if you encounter errors](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-b-common-errors/) | Common vibe coding issues and how to troubleshoot them |
| [Comparison of Seven AI Programming Tools](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-articles/example0-1/vibe-coding-tools-snake-game-tutorial) | Compare major AI coding platforms through hands-on testing |
| [Design Websites with Agents](https://datawhalechina.github.io/easy-vibe/en/stage-1/appendix-articles/example0-2/vibe-coding-tools-build-website-with-ai-coding-and-design-agents) | Learn multi-agent collaboration in practice |
### II. Junior and Mid-Level Developers
#### Frontend
| Section | Key Content |
| :------ | :---------- |
| [Frontend 0: Build Your Own Asset-Production Agent with Lovart](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/lovart-assets/) | Use Nanobanana and Lovart to batch-generate visual assets and build a drawing agent with intent recognition |
| [Frontend 1: Figma & MasterGo Basics](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/figma-mastergo/) | Learn the workflow from design drafts to implementation-ready UI thinking |
| [Frontend 2: Build Your First Modern App - UI Design](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/ui-design/) | Learn the UI design foundations behind modern application interfaces |
| [Frontend 3: UI Guidelines and Multi-Product Design](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/multi-product-ui/) | Improve consistency and aesthetics across multiple products with shared UI rules |
| [Frontend 4: Make Interfaces Beautiful with LLMs and Skills](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/llm-skills-beautiful/) | Use prompts and plugins to make AI generate more polished, distinctive interfaces |
| [Frontend 4: Let's Build Hogwarts Portraits](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/hogwarts-portraits/) | Build an interactive AI-image frontend project from scratch |
| [Frontend 6: From Design Prototype to Project Code](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/design-to-code/) | Turn design prototypes into frontend code that can really run in the browser |
| [Frontend 7: Upgrade Your UI with Modern Component Libraries](https://datawhalechina.github.io/easy-vibe/en/stage-2/frontend/modern-component-library/) | Use component libraries to build professional interfaces faster |
#### Backend
| Section | Key Content |
| :------ | :---------- |
| [Backend 1: Learn Git and GitHub](https://datawhalechina.github.io/easy-vibe/en/stage-2/backend/git-workflow/) | Master core version control operations and collaboration workflows with Git |
| [Backend 2: From Database to Supabase](https://datawhalechina.github.io/easy-vibe/en/stage-2/backend/database-supabase/) | Learn relational database basics and use Supabase as a modern BaaS platform |
| [Backend 3: Backend API Design and Development](https://datawhalechina.github.io/easy-vibe/en/stage-2/backend/ai-interface-code/) | Use AI to assist API design, backend code generation, and API documentation |
| [Backend 4: Ship Your Product Prototype](https://datawhalechina.github.io/easy-vibe/en/stage-2/backend/zeabur-deployment/) | Quickly deploy full-stack applications to the cloud with Zeabur |
| [Backend 5: From IDEs to CLI AI Coding Tools](https://datawhalechina.github.io/easy-vibe/en/stage-2/backend/modern-cli/) | Explore terminal-first AI coding workflows for modern development |
| [Backend 6: Integrate Stripe and Other Billing Systems](https://datawhalechina.github.io/easy-vibe/en/stage-2/backend/stripe-payment/) | Add monetization with payment and billing capabilities |
#### Major Projects
| Section | Key Content |
| :------ | :---------- |
| [Major Project 1: Your First SaaS Full-Stack App - AI Copywriting Website](https://datawhalechina.github.io/easy-vibe/en/stage-2/assignments/fullstack-app/) | Build an AI marketing copy workspace with login, generation, billing, and admin management |
| [Major Project 2: Online Exam and Management System](https://datawhalechina.github.io/easy-vibe/en/stage-2/assignments/modern-frontend-trae/) | Build an online exam system with question generation, test-taking flows, and admin tools |
#### AI Capabilities Appendix
| Section | Key Content |
| :------ | :---------- |
| [AI 1: Dify Basics & Knowledge Base Integration](https://datawhalechina.github.io/easy-vibe/en/stage-2/ai-capabilities/dify-knowledge-base/) | Learn to build AI applications with Dify and integrate private knowledge bases |
### III. Advanced Developers
#### Claude Code Core Skills
| Section | Key Content |
| :------ | :---------- |
| [Getting started with Claude Code](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/basics/) | Installation, setup, fundamentals, and useful commands |
| [Claude Code MCP guide](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/mcp/) | Connect Claude Code to GitHub, databases, APIs, and other services through MCP |
| [Claude Code Skills guide](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/skills/) | Package expertise into reusable skills you can use again and again |
| [How to keep Claude Code working for long-running tasks](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/long-running-tasks/) | Design long-running tasks so coding tools can keep working until the job is done |
| [Claude Agent Teams guide](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/agent-teams/) | Coordinate multiple AI instances like a real development team |
| [Claude Code Superpowers for engineering-grade development](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/superpowers/) | Help AI produce engineering-grade code with TDD and best practices |
| [Claude Code workflow best practices](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/workflow/) | Best practices for refactoring, code review, and daily development |
| [Claude Code remote development on mobile](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/mobile-development/) | Use Claude Code beyond the desktop and build a productive remote workflow on mobile devices |
| [Claude Agent SDK complete guide](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/claude-agent-sdk/) | Build custom agent workflows and integrate Claude into your own tools with the SDK |
| [From vibe coding to spec coding](https://datawhalechina.github.io/easy-vibe/en/stage-3/core-skills/spec-coding/) | Move from ad-hoc prompting to a more structured, specification-driven AI development workflow |
#### Cross-Platform Development
| Section | Key Content |
| :------ | :---------- |
| [How to choose the right platform for your app](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/choose-platform/) | Compare app forms and choose the right platform based on users, scenarios, and delivery goals |
| [Build a WeChat Mini Program](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/wechat-miniprogram/) | Understand the ecosystem and ship a frontend mini program from template to launch |
| [Build a WeChat Mini Program with backend](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/wechat-miniprogram-backend/) | Add backend logic and databases to complete the full business loop |
| [Build an Android app](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/android-app/) | Learn Android app development with a modern native workflow |
| [Build an iOS app](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/ios-app/) | Learn iOS app development and the conventions of the Apple ecosystem |
| [Build a local PWA app](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/pwa-local-app/) | Turn a website into a real app with offline support, push, and installation |
| [Build a browser AI assistant extension](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/browser-ai-extension/) | Create a Chrome extension that summarizes any page with either cloud APIs or built-in AI |
| [Build an Electron desktop app](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/electron-voice-to-text/) | Build a voice-to-text desktop app with Electron for three platforms |
| [Rapidly build and mint an NFT](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/nft-minting/) | Write a smart contract from scratch, deploy it, and mint your own NFT |
| [Build a VS Code extension](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/vscode-extension/) | Build an AI project assistant with templates, code chat, and multi-file Q&A |
| [Build an industrial-grade Qt desktop app](https://datawhalechina.github.io/easy-vibe/en/stage-3/cross-platform/qt-industrial-hmi/) | Create a real-time Qt HMI system with trends, alerts, and monitoring |
#### AI Capabilities Appendix
| Section | Key Content |
| :------ | :---------- |
| [What is RAG and how does it work](https://datawhalechina.github.io/easy-vibe/en/stage-3/ai-advanced/rag-introduction/) | Build a systematic understanding of RAG principles and common architectures |
| [Intermediate and advanced RAG workflows with LangGraph](https://datawhalechina.github.io/easy-vibe/en/stage-3/ai-advanced/langgraph-advanced-rag/) | Design multi-step workflows and more advanced RAG systems |
### 📚 Appendix Knowledge Base
> Covering **9 major knowledge areas** and **80+ interactive topics**, this appendix uses animation and visual components to help you intuitively understand core concepts from computer fundamentals to the AI frontier.
>
> 👉 [View the full appendix](https://datawhalechina.github.io/easy-vibe/en/appendix/)
### 🎓 Other Courses
- [Hands-on Modern RL](#other-courses)
- [Learn Harness Engineering](#other-courses)
## 🛠️ How To Learn
- Read and practice the sections that match your current level. If you get stuck, feel free to open an issue.
## 💻 Run Locally
### Modern approach
In an AI IDE chat window such as VS Code, Cursor, or Trae, you can simply say:
```text
Please help me run this project locally.
```
### Traditional approach
1. `npm install`
2. `npm run dev`
3. Open `http://localhost:3000` in your browser.
## Other Courses
Our team has also created other courses! Check them out:
[![Hands-on Modern RL](https://img.shields.io/badge/HANDS--ON_MODERN_RL-0052cc?style=for-the-badge)](https://github.com/walkinglabs/hands-on-modern-rl)
**Hands-on Modern RL**: An open-source, hands-on curriculum bridging the gap from basic RL concepts to LLM alignment, RLVR, and advanced Agentic systems.
[![Learn Harness Engineering](https://img.shields.io/badge/LEARN_HARNESS_ENGINEERING-0052cc?style=for-the-badge)](https://github.com/walkinglabs/learn-harness-engineering/tree/main)
**Learn Harness Engineering**: A comprehensive guide to harness engineering.
## 🤝 Contributing & Contributors
- If you find an issue or see something that can be improved, feel free to open an issue. If nobody replies, you can also contact the [Datawhale support team](https://github.com/datawhalechina/DOPMC/blob/main/OP.md).
- If you want to contribute, open a pull request. If nobody replies, you can also contact the [Datawhale support team](https://github.com/datawhalechina/DOPMC/blob/main/OP.md).
- If you want to start a new Datawhale open-source project, please follow the [Datawhale Open Source Project Guide](https://github.com/datawhalechina/DOPMC/blob/main/GUIDE.md).
### 🙏 Contributors
- [Sanbu - Project Lead](https://github.com/sanbuphy) (Datawhale member)
- Fang Ke - Mentor (Datawhale member, Tsinghua University)
- [Yerim Kang](https://github.com/yerim25) (Practice projects, Tsinghua University)
- [Zhilin Zhao](https://github.com/ChileenZ) (Practice projects, Tsinghua University)
- [Yixuan Li](https://yixuan20.github.io/) (Visual design, Tsinghua University)
- Siyi Liu (Practice projects, Tsinghua University)
- [Lixin Liu](https://github.com/liulx25xx) (Practice projects, Tsinghua University)
- Everyone in the AI Vibe Coding 101 internal testing group who shared suggestions and feedback
### Special Thanks
- Thanks to [@Sm1les](https://github.com/Sm1les) for the help and support on this project
- Thanks to every contributor and everyone who supported the project with feedback and stars ❤️
<div align="center">
<a href="https://www.star-history.com/#datawhalechina/easy-vibe&type=timeline&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=datawhalechina/easy-vibe&type=timeline&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=datawhalechina/easy-vibe&type=timeline&legend=top-left" />
</picture>
</a>
</div>
<div align=center style="margin-top: 30px;">
<a href="https://github.com/datawhalechina/easy-vibe/graphs/contributors">
<img src="https://contrib.rocks/image?repo=datawhalechina/easy-vibe" />
</a>
</div>
## 📄 LICENSE
<div align="center">
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">
<img
alt="Creative Commons License"
style="border-width:0"
src="https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-lightgrey"
/>
</a>
<br />
This work is licensed under the
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License
</a>.
</div>
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=datawhalechina/easy-vibe&type=date&legend=top-left)](https://www.star-history.com/#datawhalechina/easy-vibe&type=date&legend=top-left)
@@ -0,0 +1,87 @@
{
"createdAt": "2025-12-28T16:45:28Z",
"defaultBranchRef": {
"name": "main"
},
"description": "💻 vibe coding 2026 | Your First Modern Coding course beginners to master step by step.",
"forkCount": 1673,
"homepageUrl": "https://datawhalechina.github.io/easy-vibe/",
"isArchived": false,
"isFork": false,
"isMirror": false,
"latestRelease": null,
"licenseInfo": null,
"nameWithOwner": "datawhalechina/easy-vibe",
"primaryLanguage": {
"name": "JavaScript"
},
"pushedAt": "2026-06-17T01:53:13Z",
"repositoryTopics": [
{
"name": "ai"
},
{
"name": "course"
},
{
"name": "vibe-coding"
},
{
"name": "coding"
},
{
"name": "genai"
},
{
"name": "low-code"
},
{
"name": "no-code"
},
{
"name": "programming"
},
{
"name": "tutorial"
},
{
"name": "vibecoding"
},
{
"name": "vscode"
},
{
"name": "agent"
},
{
"name": "gemini"
},
{
"name": "gpt"
},
{
"name": "llm"
},
{
"name": "nextjs"
},
{
"name": "openai"
},
{
"name": "workflow"
},
{
"name": "mcp"
},
{
"name": "deepseek"
}
],
"stargazerCount": 17687,
"updatedAt": "2026-07-02T22:16:26Z",
"url": "https://github.com/datawhalechina/easy-vibe",
"watchers": {
"totalCount": 57
}
}
@@ -0,0 +1,386 @@
[
{
"name": ".dockerignore",
"path": ".dockerignore",
"sha": "1f9ac4e9d883c58a2a72a68c521b40a730c113fd",
"size": 204,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.dockerignore?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/.dockerignore",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/1f9ac4e9d883c58a2a72a68c521b40a730c113fd",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/.dockerignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.dockerignore?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/1f9ac4e9d883c58a2a72a68c521b40a730c113fd",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/.dockerignore"
}
},
{
"name": ".github",
"path": ".github",
"sha": "74698e80f6811c51f6439df6997a7b3f19af963d",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.github?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/.github",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/74698e80f6811c51f6439df6997a7b3f19af963d",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.github?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/74698e80f6811c51f6439df6997a7b3f19af963d",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/.github"
}
},
{
"name": ".gitignore",
"path": ".gitignore",
"sha": "9041d2d868000075b93dfe1e0b7a90e9484e0a43",
"size": 476,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.gitignore?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/.gitignore",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/9041d2d868000075b93dfe1e0b7a90e9484e0a43",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/.gitignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.gitignore?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/9041d2d868000075b93dfe1e0b7a90e9484e0a43",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/.gitignore"
}
},
{
"name": ".husky",
"path": ".husky",
"sha": "fa06f162e64d2d3ac94185f2888e8ac300a878c6",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.husky?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/.husky",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/fa06f162e64d2d3ac94185f2888e8ac300a878c6",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.husky?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/fa06f162e64d2d3ac94185f2888e8ac300a878c6",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/.husky"
}
},
{
"name": ".prettierignore",
"path": ".prettierignore",
"sha": "6f797150353660385432710e57300ef558635ee8",
"size": 17,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.prettierignore?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/.prettierignore",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/6f797150353660385432710e57300ef558635ee8",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/.prettierignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.prettierignore?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/6f797150353660385432710e57300ef558635ee8",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/.prettierignore"
}
},
{
"name": ".prettierrc",
"path": ".prettierrc",
"sha": "a93b0d69e61ed22162dffb8ceae78026afe24d46",
"size": 268,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.prettierrc?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/.prettierrc",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/a93b0d69e61ed22162dffb8ceae78026afe24d46",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/.prettierrc",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.prettierrc?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/a93b0d69e61ed22162dffb8ceae78026afe24d46",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/.prettierrc"
}
},
{
"name": ".trae",
"path": ".trae",
"sha": "e3d37947ef73a7b0ebd7d8d210fc5cae14bf901e",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.trae?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/.trae",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/e3d37947ef73a7b0ebd7d8d210fc5cae14bf901e",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.trae?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/e3d37947ef73a7b0ebd7d8d210fc5cae14bf901e",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/.trae"
}
},
{
"name": ".vscode",
"path": ".vscode",
"sha": "e533aaf460464e7a529fea09745593a5646f9199",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.vscode?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/.vscode",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/e533aaf460464e7a529fea09745593a5646f9199",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/.vscode?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/e533aaf460464e7a529fea09745593a5646f9199",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/.vscode"
}
},
{
"name": "AGENTS.md",
"path": "AGENTS.md",
"sha": "8a8d9a4debb85f91b4be1598637f0b76b05841ca",
"size": 2200,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/AGENTS.md?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/AGENTS.md",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/8a8d9a4debb85f91b4be1598637f0b76b05841ca",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/AGENTS.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/AGENTS.md?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/8a8d9a4debb85f91b4be1598637f0b76b05841ca",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/AGENTS.md"
}
},
{
"name": "CLAUDE.md",
"path": "CLAUDE.md",
"sha": "60274bd55ae784cf38681cddd2a4af8327cbb234",
"size": 12222,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/CLAUDE.md?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/CLAUDE.md",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/60274bd55ae784cf38681cddd2a4af8327cbb234",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/CLAUDE.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/CLAUDE.md?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/60274bd55ae784cf38681cddd2a4af8327cbb234",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/CLAUDE.md"
}
},
{
"name": "Dockerfile",
"path": "Dockerfile",
"sha": "76f57b1fba8a4d9e1615353fa3ea7cae1d122ecc",
"size": 774,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/Dockerfile?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/Dockerfile",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/76f57b1fba8a4d9e1615353fa3ea7cae1d122ecc",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/Dockerfile",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/Dockerfile?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/76f57b1fba8a4d9e1615353fa3ea7cae1d122ecc",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/Dockerfile"
}
},
{
"name": "README.md",
"path": "README.md",
"sha": "733bddf81c3aad2c42d83c7998d624cdfd3ebc36",
"size": 30877,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/README.md?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/README.md",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/733bddf81c3aad2c42d83c7998d624cdfd3ebc36",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/README.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/README.md?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/733bddf81c3aad2c42d83c7998d624cdfd3ebc36",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/README.md"
}
},
{
"name": "assets",
"path": "assets",
"sha": "54ab3cf49cca52b0336cb618705e08674332e3e0",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/assets?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/assets",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/54ab3cf49cca52b0336cb618705e08674332e3e0",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/assets?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/54ab3cf49cca52b0336cb618705e08674332e3e0",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/assets"
}
},
{
"name": "config",
"path": "config",
"sha": "4ba824beac3291efac771425ae10eefe11e72343",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/config?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/config",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/4ba824beac3291efac771425ae10eefe11e72343",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/config?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/4ba824beac3291efac771425ae10eefe11e72343",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/config"
}
},
{
"name": "docs-readme",
"path": "docs-readme",
"sha": "ad8c4a9a2b0070bd9aa0e4f9aba3d1adc79ba8d8",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/docs-readme?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/docs-readme",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/ad8c4a9a2b0070bd9aa0e4f9aba3d1adc79ba8d8",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/docs-readme?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/ad8c4a9a2b0070bd9aa0e4f9aba3d1adc79ba8d8",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/docs-readme"
}
},
{
"name": "docs",
"path": "docs",
"sha": "dccac1e383ceef32353b9bdc4cd53bfd0ae3e893",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/docs?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/docs",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/dccac1e383ceef32353b9bdc4cd53bfd0ae3e893",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/docs?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/dccac1e383ceef32353b9bdc4cd53bfd0ae3e893",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/docs"
}
},
{
"name": "eslint.config.js",
"path": "eslint.config.js",
"sha": "ff7b71a0c917994b89ec3bc7e6364a6e7e0514a3",
"size": 2110,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/eslint.config.js?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/eslint.config.js",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/ff7b71a0c917994b89ec3bc7e6364a6e7e0514a3",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/eslint.config.js",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/eslint.config.js?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/ff7b71a0c917994b89ec3bc7e6364a6e7e0514a3",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/eslint.config.js"
}
},
{
"name": "llms.txt",
"path": "llms.txt",
"sha": "1b8857f05368197ea5fe3e678976c48cf402af70",
"size": 51093,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/llms.txt?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/llms.txt",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/1b8857f05368197ea5fe3e678976c48cf402af70",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/llms.txt",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/llms.txt?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/1b8857f05368197ea5fe3e678976c48cf402af70",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/llms.txt"
}
},
{
"name": "ms_deploy.json",
"path": "ms_deploy.json",
"sha": "febd0cbbae05772059cbdabb9bed02be0b85d29f",
"size": 170,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/ms_deploy.json?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/ms_deploy.json",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/febd0cbbae05772059cbdabb9bed02be0b85d29f",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/ms_deploy.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/ms_deploy.json?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/febd0cbbae05772059cbdabb9bed02be0b85d29f",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/ms_deploy.json"
}
},
{
"name": "nginx.conf",
"path": "nginx.conf",
"sha": "03b75bc5972dfefa12e2a58dad0941774aa3efff",
"size": 732,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/nginx.conf?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/nginx.conf",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/03b75bc5972dfefa12e2a58dad0941774aa3efff",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/nginx.conf",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/nginx.conf?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/03b75bc5972dfefa12e2a58dad0941774aa3efff",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/nginx.conf"
}
},
{
"name": "package-lock.json",
"path": "package-lock.json",
"sha": "9cb97f86a635f8395d7a40b87e0250a4363eded7",
"size": 185918,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/package-lock.json?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/package-lock.json",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/9cb97f86a635f8395d7a40b87e0250a4363eded7",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/package-lock.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/package-lock.json?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/9cb97f86a635f8395d7a40b87e0250a4363eded7",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/package-lock.json"
}
},
{
"name": "package.json",
"path": "package.json",
"sha": "184be23b6d9b3ac459e3b13a379bc0e817bcdd26",
"size": 1853,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/package.json?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/package.json",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/184be23b6d9b3ac459e3b13a379bc0e817bcdd26",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/package.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/package.json?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/184be23b6d9b3ac459e3b13a379bc0e817bcdd26",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/package.json"
}
},
{
"name": "scripts",
"path": "scripts",
"sha": "c4c9498c932f9cf1eacd639e094612ab306e9716",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/scripts?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/tree/main/scripts",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/c4c9498c932f9cf1eacd639e094612ab306e9716",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/scripts?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/trees/c4c9498c932f9cf1eacd639e094612ab306e9716",
"html": "https://github.com/datawhalechina/easy-vibe/tree/main/scripts"
}
},
{
"name": "vercel.json",
"path": "vercel.json",
"sha": "a2849cc4d7366f9aa155c43622c53e0eff3809c8",
"size": 1099,
"url": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/vercel.json?ref=main",
"html_url": "https://github.com/datawhalechina/easy-vibe/blob/main/vercel.json",
"git_url": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/a2849cc4d7366f9aa155c43622c53e0eff3809c8",
"download_url": "https://raw.githubusercontent.com/datawhalechina/easy-vibe/main/vercel.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/easy-vibe/contents/vercel.json?ref=main",
"git": "https://api.github.com/repos/datawhalechina/easy-vibe/git/blobs/a2849cc4d7366f9aa155c43622c53e0eff3809c8",
"html": "https://github.com/datawhalechina/easy-vibe/blob/main/vercel.json"
}
}
]
@@ -0,0 +1,39 @@
version: 1
domain_id: datawhalechina-easy-vibe
object:
type: github_repository
name: datawhalechina/easy-vibe
url: https://github.com/datawhalechina/easy-vibe
pulled_at: '2026-07-02T22:47:14+00:00'
puller: scripts/fetch-research-raw.py
files:
- path: repository/
kind: git-working-tree
status: ok
source: 'git clone --depth=1 --single-branch --no-tags https://github.com/datawhalechina/easy-vibe.git docs/research/datawhalechina-easy-vibe/raw/repository'
- path: github-repo.raw.json
kind: repository-metadata
status: ok
source: 'gh repo view datawhalechina/easy-vibe --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
- path: github-readme.raw.md.txt
kind: readme
status: ok
source: 'gh api repos/datawhalechina/easy-vibe/readme -H Accept: application/vnd.github.raw'
- path: github-license.raw.txt
kind: license
status: missing_or_error
source: 'gh api repos/datawhalechina/easy-vibe/license -H Accept: application/vnd.github.raw'
message: 'gh: Not Found (HTTP 404)'
- path: github-root-contents.raw.json
kind: root-contents
status: ok
source: 'gh api repos/datawhalechina/easy-vibe/contents'
- path: github-languages.raw.json
kind: languages
status: ok
source: 'gh api repos/datawhalechina/easy-vibe/languages'
- path: github-latest-release.raw.json
kind: latest-release
status: missing_or_error
source: 'gh api repos/datawhalechina/easy-vibe/releases/latest'
message: 'gh: Not Found (HTTP 404)'
@@ -0,0 +1,26 @@
# datawhalechina/vibe-vibe 研究域 Agent 指南
本目录维护 `datawhalechina/vibe-vibe` 的独立研究域。
## 目录职责
```text
datawhalechina-vibe-vibe/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层:仓库元数据、研究角色、来源证据
├── analysis.md # L1 结构化研究结论、可借鉴点、风险和下一轮任务
├── deep-dive.md # L2 源码/结构深度研究、关键机制和可迁移模式
└── raw/ # 原始事实层:拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `datawhalechina/vibe-vibe`,不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`,并更新 `observed_at`
- `raw/` 保存原始事实层,必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件;稳定事实摘要再同步到 `domain.yml`
- README 只写判断、定位、使用方式和后续观察点,不堆外部 README 全文。
- `analysis.md` 写 L1 结构化理解;`deep-dive.md` 写 L2 源码证据、关键机制和可迁移模式。
- 如果需要横向比较,在 `docs/research/README.md` 或新的对比文档中处理,不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc``make test`
@@ -0,0 +1,58 @@
# datawhalechina/vibe-vibe 研究域
## 字多不看
- 本目录研究 `datawhalechina/vibe-vibe` 这个外部仓库。
- 当前优先级:P2;研究角色:中文零基础系统教程。
- GitHub 动态事实放在 `domain.yml`,观测日期为 2026-07-03。
## 快速导航
| 文档 | 定位 |
|:---|:---|
| [domain.yml](domain.yml) | 仓库事实快照、研究方向、优先级和来源证据。 |
| [analysis.md](analysis.md) | 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。 |
| [deep-dive.md](deep-dive.md) | L2 源码/结构深度研究、关键机制和可迁移模式。 |
| [AGENTS.md](AGENTS.md) | 本研究域维护规则。 |
<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>
### 细粒度目录
- [domain.yml](domain.yml) - 仓库事实快照、研究方向、优先级和来源证据。
- [analysis.md](analysis.md) - 本研究域的结构化研究结果、可借鉴点、风险和下一轮任务。
- [deep-dive.md](deep-dive.md) - L2 源码/结构深度研究、关键机制和可迁移模式。
- [AGENTS.md](AGENTS.md) - 本研究域维护规则。
</details>
## 使用方式
- 先读本 README 的判断,再读 `analysis.md``deep-dive.md` 的研究结论,最后读 `domain.yml`
- 需要引用 stars、forks、release、归档状态时,先重新核验 GitHub。
- 如果形成稳定方法论,再迁入 concepts、references、workflow 或 skills。
## 正文
### 研究定位
`datawhalechina/vibe-vibe` 的当前研究定位是:中文零基础系统教程。
### 当前判断
适合作为零基础入口,用来观察中文教程如何把 Vibe Coding 讲成可执行路线。
### 观察字段
- GitHub URLhttps://github.com/datawhalechina/vibe-vibe
- 当前研究方向:`cn-onboarding`
- 当前优先级:P2
- 当前归档状态:`false`
- 主要语言:`Dockerfile`
### 后续观察
- 是否有稳定文档结构、命令入口和可复用工作流。
- 是否能反哺本仓库的 concepts、references、workflow 或 skills。
- 是否存在许可证、归档状态、维护活跃度或生态迁移风险。
@@ -0,0 +1,44 @@
# datawhalechina/vibe-vibe 研究分析
## 本轮结论
- Vibe Vibe 是面向零基础用户的中文 AI 编程指南,核心价值是把 Vibe Coding 讲成可学习、可部署、可演示的课程。
- 仓库包含 `docs/``demos/``Dockerfile``docker-compose.yml`,说明它强调教程、示例和私有化部署。
- 本仓应吸收它对零基础用户的解释方式和 demo 驱动学习路径,但工程治理层仍需本仓自己定义。
## 本地证据
- 研究对象:`datawhalechina/vibe-vibe`
- 当前研究角色:中文零基础系统教程
- 本轮成熟度:L1 初步理解
- 原始仓库:`raw/repository/`
- 原始来源清单:`raw/sources.yml`
- 事实摘要:`domain.yml`
## 结构观察
- 根目录包含 `docs/``demos/``package.json``pnpm-lock.yaml``Dockerfile``docker-compose.yml`
- README 的核心理念、快速开始、私有化部署、教程定位、进阶版预告和学习产出结构清晰。
- 课程形态比工具实现更强,适合作为 onboarding 研究对象。
## 可借鉴点
- 零基础内容需要先给学习产出,再给工具和概念。
- demo 目录能降低抽象教程的理解成本。
- 私有化部署说明适合补充本仓“教程站点/知识库发布”参考。
## 风险和边界
- 面向零基础会简化工程细节,不能直接当作高级工程规范。
- 大体量课程仓库需要区分原创内容、站点框架和生成资产。
- 进阶版能力需要继续观察是否真实落地。
## 下一轮研究任务
- 整理它的课程目录和 demo 类型,对照本仓 getting-started。
- 分析私有化部署部分是否能沉淀到 references。
## 沉淀判断
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
@@ -0,0 +1,86 @@
# datawhalechina/vibe-vibe 深度研究
## 研究级别
- 当前级别:L2 源码/结构深度研究。
- 研究对象:`datawhalechina/vibe-vibe`
- 证据来源:本目录 `raw/` 下的 GitHub 元数据、README 快照和本地仓库工作树。
- 观察日期:2026-07-03。
## L2 结论
`datawhalechina/vibe-vibe` 是面向零基础用户的系统教程仓库。它的核心不是工具实现,而是把
Vibe Coding 解释成基础篇、进阶篇、实践篇和优质文章篇四层学习路径,并通过 VitePress、demo
项目、Docker 部署和 PWA/SEO 配置把教程做成可访问、可部署、可持续阅读的产品。
对本仓最有价值的是它的课程分层和“从想法到产品”的读者叙事;最需要警惕的是教程产品化很容易
引入站点工程复杂度,偏离本仓作为工程知识库和 Agent 控制面的主轴。
## 源码证据
- `raw/repository/README.md`:中文主入口,定义教程定位、推荐起点、板块和学习产出。
- `raw/repository/README.en.md`:英文入口。
- `raw/repository/docs/Basic/`:基础篇。
- `raw/repository/docs/Advanced/`:进阶篇。
- `raw/repository/docs/Practice/`:实践篇。
- `raw/repository/docs/Articles/`:优质文章篇。
- `raw/repository/demos/`:示例项目入口。
- `raw/repository/demos/demo-01-todo/`:第一个 todo demo。
- `raw/repository/demos/demo-02-todo-auth/`:带认证 demo。
- `raw/repository/demos/demo-03-social-schema/`schema 练习 demo。
- `raw/repository/docs/deployment/index.md`:部署说明。
- `raw/repository/Dockerfile`:容器化部署入口。
- `raw/repository/docker-compose.yml`:本地私有化部署入口。
- `raw/repository/docs/public/llms.txt`AI 读取入口。
- `raw/repository/docs/.vitepress/config.mts`:站点、SEO、PWA、FAQ、RSS 和侧边栏配置。
## 关键机制
### 四层课程结构
基础篇解决“能不能开始”,进阶篇解决“能不能完整交付”,实践篇解决“能不能动手练”,文章篇解决
“能不能持续追踪”。这是一种很适合中文用户的学习漏斗。
### Demo 是教程可信度来源
仓库不是只讲理念,还提供 `demos/`。这对零基础教程很关键:读者需要看到具体可运行对象,
否则很容易停在“AI 很厉害”的抽象叙事里。
### 部署能力被前置
README 和 `docs/deployment/index.md` 都强调私有化部署和本地运行。对 Vibe Coding 教程来说,
“能部署给别人看”比“写出代码”更接近真实成就感。
### 站点配置承担传播和检索
`config.mts` 中包含 SEO、RSS、FAQ、PWA、侧边栏和 Mermaid 等能力,说明教程产品化后,传播、
索引和结构导航会成为工程任务。
## 可迁移模式
- 本仓入门路径应明确“基础、进阶、实践、持续追踪”四类入口。
- 每个核心概念最好配一个可运行 demo 或最小任务,而不是只写定义。
- 部署上线应进入入门路径早期,而不是进阶尾部。
- 对面向新手的内容,先写学习产出,再写工具和概念。
- 站点化可以作为未来选项,但本仓当前仍应优先维护 Markdown 可读性和门禁。
## 对本仓的影响
本仓可以吸收 Vibe Vibe 的教程节奏,但要保持自己的差异:
- 本仓更偏工程治理、Agent 协作、研究域和资源治理。
- Vibe Vibe 更偏零基础教育和站点化课程。
- 合理方向是将本仓 getting-started 改得更像“学习路径”,而不是把全仓改成课程站点。
## 风险和待验证项
- 本轮没有运行 VitePress 构建、Docker 部署或 demo 项目。
- 部分 demo 目录可能只是模板或未完成项目,需要逐个验证。
- 面向零基础的表达会有必要简化,不能直接替代本仓进阶工程规范。
## 下一步 L3 验证任务
- 选取 `demos/demo-01-todo/` 作为最小 demo,验证是否可运行。
- 将 Vibe Vibe 的四层课程结构映射到本仓 `getting-started``workflow``references`
- 为本仓补“学习产出表”:每个阶段读者能做出什么。
- 评估是否需要将部署上线前移到入门路径。
@@ -0,0 +1,39 @@
version: 1
repo:
name: datawhalechina/vibe-vibe
source_name: datawhalechina/vibe-vibe
url: https://github.com/datawhalechina/vibe-vibe
research:
domain_id: datawhalechina-vibe-vibe
domain_name: datawhalechina/vibe-vibe 研究域
primary_direction: cn-onboarding
role: 中文零基础系统教程
priority: 2
why_study: 适合作为零基础入口,用来观察中文教程如何把 Vibe Coding 讲成可执行路线。
github_observed:
observed_at: '2026-07-03'
source: gh repo view
stars: 5633
forks: 445
archived: false
language: Dockerfile
license: null
default_branch: main
pushed_at: '2026-04-30T11:49:58Z'
updated_at: '2026-07-02T17:16:02Z'
latest_release: null
homepage: https://www.vibevibe.cn
topics:
- agent
- agentic-ai
- ai
- coding-assistant
- programming
- vibe-coding
- vibecoding
source_evidence:
file: ChatGPT-中文Vibe Coding仓库 (2).md
line: 25
maintenance:
fact_policy: GitHub 动态字段只代表 observed_at 当日快照,更新结论前必须重新核验。
split_policy: 本目录已经是一等研究域;更深分析放入本目录新增文档。
@@ -0,0 +1,12 @@
# raw/ Agent 指南
本目录是 `datawhalechina/vibe-vibe` 的原始事实层。
## 维护规则
- 只保存从研究对象拉取的一手材料,不写分析判断。
- `repository/` 是本地 Git 工作树,刷新时由脚本 clone 或 fast-forward pull。
- 不手工改写 `*.raw.*` 文件内容;需要刷新时运行 `python3 scripts/fetch-research-raw.py`
- `sources.yml` 必须记录拉取时间、来源命令和每个文件的状态。
- 外部 README 原文必须保存为 `.txt`,避免本仓库 Markdown 链接检查误判。
- 分析、判断、采用建议和沉淀路径写回上一级 `README.md``analysis.md``decisions.md`
@@ -0,0 +1,16 @@
# raw 事实层
本目录保存 `datawhalechina/vibe-vibe` 的本地原始材料快照。
这里不写分析结论,只保存可复查的一手资料:
- `sources.yml`:来源清单、拉取时间、命令和文件状态。
- `repository/`Git 仓库工作树;本目录由 `.gitignore` 忽略,只作为本地研究材料。
- `github-repo.raw.json`GitHub 仓库元数据。
- `github-readme.raw.md.txt`GitHub README 原文快照。
- `github-license.raw.txt`GitHub license 原文快照;仓库无 license 时可能不存在。
- `github-root-contents.raw.json`:默认分支根目录内容快照。
- `github-languages.raw.json`GitHub language 统计快照。
- `github-latest-release.raw.json`:最新 release 快照;无 release 时可能不存在。
`repository/` 是外部源码快照,不参与本仓库 Markdown、链接、README/AGENTS 覆盖检查。原始 README 使用 `.txt` 后缀保存,避免其中的外部相对链接被本仓库 Markdown 链接检查误判。
@@ -0,0 +1,3 @@
{
"Dockerfile": 444
}
@@ -0,0 +1,235 @@
<p align="center">
<a href="./README.en.md">English</a> |
<a href="./README.md"><strong>简体中文</strong></a>
</p>
<p align="center">
<img src="./docs/public/logo.png" width="100" alt="Vibe Vibe"/>
</p>
<h1 align="center">Vibe Vibe </h1>
# Vibe Vibe —— 人人都能学会的 AI 编程(Vibe Coding)指南
> **面向零编程基础学习者的 AI 辅助编程系统化教程,从「我有一个想法」到「我做出了一个产品」,让人人都能成为 Builder。**
点击以访问教程主页:www.vibevibe.cn
### 核心理念
践行 OpenAI 联合创始人 **Andrej Karpathy** 提出的 Vibe Coding 理念——**从 Coder 到 Commander**:通过自然语言与 AI 对话,让编程从"写代码"转变为"对话式创作"。
> *"完全沉浸于编程的'氛围'中,忘记代码的存在。"*
### 快速开始
📖 **在线阅读**[www.vibevibe.cn](https://www.vibevibe.cn)
| 你是谁 | 推荐起点 |
|-------|---------|
| 完全零基础 | 基础篇 → 第1章 觉醒 |
| 用过 ChatGPT 等大语言模型工具但没做过项目 | 基础篇 → 第2章 心法 |
| 有编程基础想学 Vibe Coding | 基础篇快速浏览 → 进阶篇 |
| 想直接动手做项目 | 基础篇 → 第4章 实战 |
| 想找项目练手 | 实践篇 |
### 私有化部署
如果你想在本地或内网环境部署本教程站点,仓库已经提供了可直接使用的 `Dockerfile` 和 `docker-compose.yml`
```bash
docker compose up -d --build
```
默认访问地址为 `http://localhost:1024`。
更完整的部署方式、静态文件部署方案和离线环境注意事项,请查看[部署指南](./docs/deployment/index.md)。
### 教程定位
国内首个系统化的 Vibe Coding 开源教程,分为四大板块:
| 板块 | 定位 | 适合人群 |
|-----|------|---------|
| 📘 **基础篇** | AI 编程入门 + 心法 + 第一个项目 | 完全零基础、用过 ChatGPT 但没做过项目 |
| 📗 **进阶篇** | 16章"序言可阅读" · 从0到上线的避坑指南 | 想了解完整项目交付流程的开发者 |
| 📙 **实践篇** | 分人群项目实战 + 进阶技能训练 | 想通过动手练习巩固所学 |
| 📕 **优质文章篇** | 精选学习资源 + 行业前沿追踪 | 想持续学习、保持行业敏感度 |
- **为什么需要这份教程?** Vibe Coding 已成为全球趋势(越来越多的创业公司大部分代码由 AI 辅助生成),但国内学习资源碎片化严重,缺乏系统化、零基础友好、包含完整进阶路径的教程。
- **适合人群**:编程零基础者、大学生、创业者、传统程序员、职场人士,任何想用 AI 快速实现想法、提升工作效率或学习新范式的人。
### 进阶版预告:在线 IDE + Skills
我们即将推出**在线开发环境**,无需本地配置环境,打开浏览器即可开始学习:
- **云端 IDE** —— 内置完整的 Node.js 24、Python、Docker 等开发环境
- **50+ AI Skills** —— 预装丰富的 AI 辅助技能包,覆盖开发全流程
- **开箱即用** —— 无需安装任何软件,登录即可开始编程实践
让学习门槛降到最低,敬请期待!
### 学习产出
| 阶段 | 你将获得 |
|-----|---------|
| **基础篇** | 掌握 Vibe Coding 心法 · 用自然语言指挥 AI · 独立完成项目 · 部署上线能力 |
| **进阶篇** | 现代全栈技术栈 · 前后端架构 · 用户系统开发 · 生产级部署 · 工程化思维 |
## 贡献者名单
| 姓名 | 职责 | 简介 |
| :----| :---- | :---- |
| [符航康](https://www.hangkangfu.cn) | 项目负责人 & 核心贡献者 | 一位 AI 时代的原住民|
| [齐国皓](https://www.guohaoqi.cn) | 项目负责人 & 核心贡献者 | 现就读于新加坡国立大学计算机学院, 湖南大学金融科技协会创始人|
| 刘磊 | 「实践篇」贡献者、图像贡献者 | 中国科学院大学,一枚在职后端 Coder,热爱 Vibe,崇尚分享。 |
| 陈俊希 | 「优质文章篇」板块贡献者 | 湖南大学金融科技协会会长,湖南大学金融与统计学院24级本科生 |
| 金龙 |「实践篇」板块贡献者 | 北京大学学生创新学社AI俱乐部副部长,北京大学24级研究生|
| 舒璐璐 | 「实践篇」板块贡献者 | 湖南大学「麓山人文+」创始人,湖南大学岳麓书院23级本科生 |
## 目录
本教程分为**四大板块**,采用渐进式学习路径设计(点击展开详细目录):
<details>
<summary><b>📘 基础篇:Vibe Coding 启示录(写给所有人的 AI 编程入门)</b></summary>
```
基础篇目录
├── 写在最前面
│ └── 找到你的位置
├── 第1章:觉醒 —— 为什么现在是编程最好的时代
│ ├── 1.1 编程已死,编程永生:从 Coder 到 Commander
│ ├── 1.2 核心概念:Vibe Coding 与 Spec Coding 详解
│ ├── 1.3 破除迷信:不懂英文、数学不好也能写代码吗?
│ ├── 1.4 工具初探:Cursor、Windsurf、Bolt.new 与 Replit 选型指南
│ └── 1.5 Hello World:你的第一个 3 分钟 AI 网页
├── 第2章:心法 —— 像产品经理一样思考
│ ├── 2.1 拒绝功能堆砌:为什么你的 AI 写不出复杂的 App?
│ ├── 2.2 MVP 思维:如何设计一个"能跑的最小版本"
│ ├── 2.3 灵魂三问:用户是谁?痛点在哪?为何用你?
│ └── 2.4 实战演练:拆解一个"背单词软件"的想法
├── 第3章:技法 —— 与 AI 对话的艺术
│ ├── 3.1 提示词工程基础:Context is King
│ ├── 3.2 用户旅程地图:把想法变成 AI 能懂的路径
│ ├── 3.3 编写第一份 PRD:让 AI 不再胡编乱造
│ └── 3.4 功能优先级 P0/P1/P2:学会对 AI 说"这个先不做"
├── 第4章:实战 —— 从 0 到 1 开发个人工具
│ ├── 4.1 环境准备:无需命令行的开发环境搭建
│ ├── 4.2 第一轮:生成静态页面 —— 先看"脸"
│ ├── 4.3 第二轮:注入逻辑与交互 —— 再长"脑"
│ ├── 4.4 第三轮:数据存储基础
│ └── 4.5 Debug 指南:当 AI 报错时,如何用 AI 修复 AI
├── 第5章:精进 —— 从"能用"到"好用"
│ ├── 5.1 后悔药:代码改崩了怎么办
│ ├── 5.2 见世面:把网页发到互联网上
│ ├── 5.3 护城河:AI 时代的安全意识
│ ├── 5.4 再进化:项目的持续迭代与优化
│ ├── 5.5 知边界:Vibe Coding 的能与不能
│ └── 5.6 启程前:本章总结与进阶预告
├── 结语:给未来的你
├── 下部预告:Vibe Coding 全栈实战教程
└── 附录
├── A. Prompt 速查清单
├── B. 常见错误与解决方案速查表
├── C. 术语表(中英对照)
├── D. 工具对比速查表
└── E. 项目 idea 清单
```
</details>
<details>
<summary><b>📗 进阶篇:从0到上线的避坑指南</b></summary>
本篇以**完整的产品交付流程**为主线,共16章,每章序言均可阅读:
```
进阶篇目录
├── 第1章:环境搭建、代码形态与包管理器
├── 第2章:开发工具与 AI 调教
├── 第3章:PRD 与文档驱动开发
├── 第4章:开发常识与技术栈
├── 第5章:代码运行状态与构建原理
├── 第6章:界面(UI)与交互(UX)
├── 第7章:环境变量与安全机制
├── 第8章:数据持久化与数据库
├── 第9章:功能测试流程与自动化脚本
├── 第10章:Localhost 与公网访问
├── 第11章:Git 版本控制与跨平台协作
├── 第12章:无服务器部署与 CI/CD 自动化
├── 第13章:域名解析原理与网络接入
├── 第14章:云服务器运维与项目部署
├── 第15章:SEO、分享与数据统计
└── 第16章:用户反馈与产品迭代
```
**技术栈**Next.js 16 · React · TypeScript · Tailwind CSS · shadcn/ui · Drizzle ORM · PostgreSQL
</details>
<details>
<summary><b>📙 实践篇:分人群项目实战</b></summary>
```
实践篇目录
├── 基础板块(按人群分类)
│ ├── 文科生/商科生项目 —— 内容创作、数据展示类
│ ├── 理工科学生项目 —— 算法可视化、数据处理类
│ └── 职场人士项目 —— 工作流自动化、效率提升类
└── 进阶板块(基于 Sean's Stories 系列)
├── 核心技能 —— 上线应用、数据库、后端部署、用户认证
├── AI Agent 开发 —— RAG、向量数据库、MCP 集成
├── 全栈项目实战 —— SaaS、地图应用、移动应用
└── 工具与效率 —— n8n、GitHub 工作流、React/TS 进阶
```
</details>
<details>
<summary><b>📕 优质文章篇:精选学习资源</b></summary>
```
优质文章篇目录
├── 知名公司博客 —— OpenAI、Anthropic、Vercel 等技术博客
├── 优质播客 —— AI、开发者、创业者相关播客推荐
├── 研究报告 —— AI 发展报告、开发者调查、行业趋势
├── 优质 Newsletter —— 值得订阅的技术周刊
└── 开发者社区 —— Discord、Twitter、GitHub 优质资源
```
</details>
## 参与贡献
- 如果你发现了一些问题,可以提Issue进行反馈,如果提完没有人回复你可以联系[保姆团队](https://github.com/datawhalechina/DOPMC/blob/main/OP.md)的同学进行反馈跟进~
- 如果你想参与贡献本项目,可以提Pull request,如果提完没有人回复你可以联系[保姆团队](https://github.com/datawhalechina/DOPMC/blob/main/OP.md)的同学进行反馈跟进~
- 如果你对 Datawhale 很感兴趣并想要发起一个新的项目,请按照[Datawhale开源项目指南](https://github.com/datawhalechina/DOPMC/blob/main/GUIDE.md)进行操作即可~
## 关注我们
<div align=center>
<p>扫描下方二维码关注公众号:Datawhale</p>
<img src="https://raw.githubusercontent.com/datawhalechina/pumpkin-book/master/res/qrcode.jpeg" width = "180" height = "180">
</div>
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=datawhalechina/vibe-vibe&type=Date)](https://star-history.com/#datawhalechina/vibe-vibe&Date)
## LICENSE
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="知识共享许可协议" style="border-width:0" src="https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-lightgrey" /></a><br />本作品采用<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议</a>进行许可。
@@ -0,0 +1,48 @@
{
"createdAt": "2025-11-28T10:30:29Z",
"defaultBranchRef": {
"name": "main"
},
"description": "AI for All: The First Systematic Vibe Coding Tutorial | From Zero to Full-Stack, Bring Your Ideas to Life | Live at: www.vibevibe.cn ;全民AI学习第一课,首个系统化 Vibe Coding 开源教程 | 零基础到全栈实战,让人人都能借助 AI 实现自己的想法与创意 | 在线地址:www.vibevibe.cn",
"forkCount": 445,
"homepageUrl": "https://www.vibevibe.cn",
"isArchived": false,
"isFork": false,
"isMirror": false,
"latestRelease": null,
"licenseInfo": null,
"nameWithOwner": "datawhalechina/vibe-vibe",
"primaryLanguage": {
"name": "Dockerfile"
},
"pushedAt": "2026-04-30T11:49:58Z",
"repositoryTopics": [
{
"name": "agent"
},
{
"name": "agentic-ai"
},
{
"name": "ai"
},
{
"name": "coding-assistant"
},
{
"name": "programming"
},
{
"name": "vibe-coding"
},
{
"name": "vibecoding"
}
],
"stargazerCount": 5633,
"updatedAt": "2026-07-02T17:16:02Z",
"url": "https://github.com/datawhalechina/vibe-vibe",
"watchers": {
"totalCount": 27
}
}
@@ -0,0 +1,194 @@
[
{
"name": ".cnb.yml",
"path": ".cnb.yml",
"sha": "850504f0e0ad0b211ead9c06107c4128b303a687",
"size": 3070,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/.cnb.yml?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/.cnb.yml",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/850504f0e0ad0b211ead9c06107c4128b303a687",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/.cnb.yml",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/.cnb.yml?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/850504f0e0ad0b211ead9c06107c4128b303a687",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/.cnb.yml"
}
},
{
"name": ".gitignore",
"path": ".gitignore",
"sha": "18ab205cb9c70376b0fc6fd10effc423b1ca6136",
"size": 1376,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/.gitignore?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/.gitignore",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/18ab205cb9c70376b0fc6fd10effc423b1ca6136",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/.gitignore",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/.gitignore?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/18ab205cb9c70376b0fc6fd10effc423b1ca6136",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/.gitignore"
}
},
{
"name": ".prettierrc.json",
"path": ".prettierrc.json",
"sha": "cd95e259e29450b730f780a2db6fe12aa02429f2",
"size": 371,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/.prettierrc.json?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/.prettierrc.json",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/cd95e259e29450b730f780a2db6fe12aa02429f2",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/.prettierrc.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/.prettierrc.json?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/cd95e259e29450b730f780a2db6fe12aa02429f2",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/.prettierrc.json"
}
},
{
"name": "Dockerfile",
"path": "Dockerfile",
"sha": "a343b0392b6647fabf11256c0246c14d9c6df8e5",
"size": 444,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/Dockerfile?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/Dockerfile",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/a343b0392b6647fabf11256c0246c14d9c6df8e5",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/Dockerfile",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/Dockerfile?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/a343b0392b6647fabf11256c0246c14d9c6df8e5",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/Dockerfile"
}
},
{
"name": "README.en.md",
"path": "README.en.md",
"sha": "51519f8a2de5e0b0a3410d9413f657be352e5c72",
"size": 4291,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/README.en.md?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/README.en.md",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/51519f8a2de5e0b0a3410d9413f657be352e5c72",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/README.en.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/README.en.md?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/51519f8a2de5e0b0a3410d9413f657be352e5c72",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/README.en.md"
}
},
{
"name": "README.md",
"path": "README.md",
"sha": "645f0bef1d254ee64805ef8abf0ec4e459c2377b",
"size": 10925,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/README.md?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/README.md",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/645f0bef1d254ee64805ef8abf0ec4e459c2377b",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/README.md",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/README.md?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/645f0bef1d254ee64805ef8abf0ec4e459c2377b",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/README.md"
}
},
{
"name": "demos",
"path": "demos",
"sha": "f67f282f5ed94897357b7bb4129f0396e0d72fd5",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/demos?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/tree/main/demos",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/trees/f67f282f5ed94897357b7bb4129f0396e0d72fd5",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/demos?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/trees/f67f282f5ed94897357b7bb4129f0396e0d72fd5",
"html": "https://github.com/datawhalechina/vibe-vibe/tree/main/demos"
}
},
{
"name": "docker-compose.yml",
"path": "docker-compose.yml",
"sha": "8f44b32f89348859149dbd4d6896fa094af8a89c",
"size": 728,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/docker-compose.yml?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/docker-compose.yml",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/8f44b32f89348859149dbd4d6896fa094af8a89c",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/docker-compose.yml",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/docker-compose.yml?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/8f44b32f89348859149dbd4d6896fa094af8a89c",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/docker-compose.yml"
}
},
{
"name": "docs",
"path": "docs",
"sha": "4beeca295ef9c51103f05a2d06cb883a2529b5ec",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/docs?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/tree/main/docs",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/trees/4beeca295ef9c51103f05a2d06cb883a2529b5ec",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/docs?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/trees/4beeca295ef9c51103f05a2d06cb883a2529b5ec",
"html": "https://github.com/datawhalechina/vibe-vibe/tree/main/docs"
}
},
{
"name": "package.json",
"path": "package.json",
"sha": "bbd3b353476e1faeb5b922fd36ec7c90a192ad00",
"size": 1020,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/package.json?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/package.json",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/bbd3b353476e1faeb5b922fd36ec7c90a192ad00",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/package.json",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/package.json?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/bbd3b353476e1faeb5b922fd36ec7c90a192ad00",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/package.json"
}
},
{
"name": "patches",
"path": "patches",
"sha": "e71e97d01040c01be8c773e3c6514aa65175ded7",
"size": 0,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/patches?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/tree/main/patches",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/trees/e71e97d01040c01be8c773e3c6514aa65175ded7",
"download_url": null,
"type": "dir",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/patches?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/trees/e71e97d01040c01be8c773e3c6514aa65175ded7",
"html": "https://github.com/datawhalechina/vibe-vibe/tree/main/patches"
}
},
{
"name": "pnpm-lock.yaml",
"path": "pnpm-lock.yaml",
"sha": "5a580e9ab8c78f4cfb0c4ab67fa61695ba929fbf",
"size": 229027,
"url": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/pnpm-lock.yaml?ref=main",
"html_url": "https://github.com/datawhalechina/vibe-vibe/blob/main/pnpm-lock.yaml",
"git_url": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/5a580e9ab8c78f4cfb0c4ab67fa61695ba929fbf",
"download_url": "https://raw.githubusercontent.com/datawhalechina/vibe-vibe/main/pnpm-lock.yaml",
"type": "file",
"_links": {
"self": "https://api.github.com/repos/datawhalechina/vibe-vibe/contents/pnpm-lock.yaml?ref=main",
"git": "https://api.github.com/repos/datawhalechina/vibe-vibe/git/blobs/5a580e9ab8c78f4cfb0c4ab67fa61695ba929fbf",
"html": "https://github.com/datawhalechina/vibe-vibe/blob/main/pnpm-lock.yaml"
}
}
]
@@ -0,0 +1,39 @@
version: 1
domain_id: datawhalechina-vibe-vibe
object:
type: github_repository
name: datawhalechina/vibe-vibe
url: https://github.com/datawhalechina/vibe-vibe
pulled_at: '2026-07-02T22:47:14+00:00'
puller: scripts/fetch-research-raw.py
files:
- path: repository/
kind: git-working-tree
status: ok
source: 'git clone --depth=1 --single-branch --no-tags https://github.com/datawhalechina/vibe-vibe.git docs/research/datawhalechina-vibe-vibe/raw/repository'
- path: github-repo.raw.json
kind: repository-metadata
status: ok
source: 'gh repo view datawhalechina/vibe-vibe --json nameWithOwner,url,description,homepageUrl,isArchived,isFork,isMirror,defaultBranchRef,licenseInfo,primaryLanguage,repositoryTopics,stargazerCount,forkCount,watchers,createdAt,updatedAt,pushedAt,latestRelease --jq .'
- path: github-readme.raw.md.txt
kind: readme
status: ok
source: 'gh api repos/datawhalechina/vibe-vibe/readme -H Accept: application/vnd.github.raw'
- path: github-license.raw.txt
kind: license
status: missing_or_error
source: 'gh api repos/datawhalechina/vibe-vibe/license -H Accept: application/vnd.github.raw'
message: 'gh: Not Found (HTTP 404)'
- path: github-root-contents.raw.json
kind: root-contents
status: ok
source: 'gh api repos/datawhalechina/vibe-vibe/contents'
- path: github-languages.raw.json
kind: languages
status: ok
source: 'gh api repos/datawhalechina/vibe-vibe/languages'
- path: github-latest-release.raw.json
kind: latest-release
status: missing_or_error
source: 'gh api repos/datawhalechina/vibe-vibe/releases/latest'
message: 'gh: Not Found (HTTP 404)'
@@ -0,0 +1,23 @@
# earyantLe/vibe-coding-skill 研究域 Agent 指南
本目录维护 `earyantLe/vibe-coding-skill` 的独立研究域。
## 目录职责
```text
earyantle-vibe-coding-skill/
├── README.md # 研究域入口和判断层
├── AGENTS.md # 本目录维护规则
├── domain.yml # 事实摘要层:仓库元数据、研究角色、来源证据
└── raw/ # 原始事实层:拉取到本地的一手材料快照
```
## 维护规则
- 本目录只研究 `earyantLe/vibe-coding-skill`,不要混入其他仓库的横向比较正文。
- 动态事实必须写入 `domain.yml.github_observed`,并更新 `observed_at`
- `raw/` 保存原始事实层,必须通过 `python3 scripts/fetch-research-raw.py` 刷新。
- 不手工改写 `raw/*.raw.*` 文件;稳定事实摘要再同步到 `domain.yml`
- README 只写判断、定位、使用方式和后续观察点,不堆外部 README 全文。
- 如果需要横向比较,在 `docs/research/README.md` 或新的对比文档中处理,不把本目录重新变成聚合域。
- 修改后运行 `make sync-doc-toc``make test`

Some files were not shown because too many files have changed in this diff Show More