## 1. Project Overview & Quickstart (AlexAnys/awesome-openclaw-usecases-zh)

---

# Awesome OpenClaw 最佳案例合集（中文版）🇨🇳

> 解决 OpenClaw 普及的瓶颈：不是 ~~技能~~，而是找到 **能改善你生活的方式**。
>
> 一份面向中文用户的 OpenClaw 真实使用案例合集，包含社区验证的国际用例的中国适配，国内生态特色用例，从零入门。


**📖 来源声明**

本仓库受 [awesome-openclaw-usecases](https://github.com/hesamsheikh/awesome-openclaw-usecases) 启发，在其基础上独立发展，包含大量国内生态原创用例和适配内容。感谢原作者 [hesamsheikh](https://github.com/hesamsheikh) 和所有社区贡献者。



> **2026.7 更新**：新增 **to-agent 适配层**——[AGENTS.md](AGENTS.md)（执行协议 + 人机分工协议）、[INDEX.md](INDEX.md)（50 用例索引 + 风险标签）、[CONCEPT-MAPPING.md](CONCEPT-MAPPING.md)（跨 agent 概念对照），任何 AI 智能体都能按协议帮你复现本仓库用例。⚠️ 注意：`CLAUDE.md` 已纳入版本控制——存量 clone 若有本地私有 `CLAUDE.md`，请先改名（如 `CLAUDE.local.md`）再 pull。

> **2026.5.4 更新**：新增 Multica 多 CLI 协作看板用例——把 OpenClaw / Claude Code / Codex / Hermes 拉进同一个 Web 看板，Apache 2.0 自部署友好。详见 [基础设施与 DevOps](#基础设施与-devops)。

> 🤖 **For AI agents / 给 AI Agent**：如果你是 AI 智能体（OpenClaw / Hermes / Claude Code / Codex 等），请先读 **[AGENTS.md](AGENTS.md)**——里面有执行协议和"人机分工协议"（教你替用户算出*最少要做什么、在什么时点做*，再做二次指导）。用例索引见 [INDEX.md](INDEX.md)，跨 agent 概念翻译见 [CONCEPT-MAPPING.md](CONCEPT-MAPPING.md)。本合集用 OpenClaw 术语写就，但任何 agent 都能复用。**转发提醒**：把单个用例发给不在本仓库目录中的 agent（聊天粘贴 / raw URL）时，请连同 AGENTS.md 一起发——协议不在用例文件里。

---

## 🗂 目录

- [新手入门指南](#-新手入门指南)
- **[🇨🇳 中国特色用例](#-中国特色用例)** — 23 个国内生态用例
  - [平台机器人](#平台机器人) (4) — 飞书、钉钉、企业微信等 IM 平台 AI 接入
  - [内容创作与发布](#内容创作与发布) (3) — 小红书、公众号、播客全流程自动化
  - [数据研究与监控](#数据研究与监控) (7) — A 股、财报、竞品、论文、中文互联网研究
  - [办公与客户服务](#办公与客户服务) (4) — 邮件、会议、多渠道客服、电商多 Agent
  - [个人助理与智能体架构](#个人助理与智能体架构) (5) — 早间简报、人格档案、多 Agent 编排
- **[🌐 通用场景](#-通用场景)** — 国际用例合集（部分含国内适配）
  - [社交媒体](#社交媒体) (4) — Reddit、YouTube、X 等平台内容聚合
  - [创意与构建](#创意与构建) (3) — 内容创作流水线、从零构建产品
  - [基础设施与 DevOps](#基础设施与-devops) (5) — 服务器自愈、工作流编排、可观测性、智能体看板
  - [生产力](#生产力) (16) — 邮件、日程、笔记、CRM、个人助理
  - [研究与学习](#研究与学习) (9) — 知识库、市场调研、论文发现、竞品分析
  - [金融与交易](#金融与交易) (1) — 预测市场模拟交易

---

## 🚀 新手入门指南

[OpenClaw](https://github.com/openclaw/openclaw)（前身为 ClawdBot、MoltBot）是一个开源的 **个人 AI 智能体**。和普通 AI 聊天不同，它能主动执行任务、永久记住你的偏好、连接多个平台、按时间表自动运行。简单来说，是一个 **7×24 小时在线的 AI 员工**。[查看官方中文教程](https://docs.openclaw.ai/zh-CN)


**🚀 三步开始使用（点击展开）**

```
1️⃣  安装 OpenClaw → github.com/openclaw/openclaw
2️⃣  从下方选一个感兴趣的用例开始，或连接你的 Telegram / Discord / 飞书 / 钉钉 / 企业微信
3️⃣  复制用例中的提示词，粘贴给你的 OpenClaw
```

就这么简单。




**📖 核心概念一看就懂（点击展开）**

| 概念 | 英文 | 一句话解释 | 生活类比 |
|:---:|:---:|---|---|
| 工作区 | Workspace | 智能体的"家"，所有文件都在这里 | 像员工的办公桌 |
| 灵魂 | SOUL.md | 定义智能体的性格、语气和边界 | 像一个人的性格和价值观 |
| 操作手册 | AGENTS.md | 告诉智能体如何工作、如何记忆 | 像岗位说明书 |
| 记忆 | Memory | 记住你说过的话和偏好 | 像一个越来越懂你的老助理 |
| 技能 | Skill | 教会智能体做好某件事的知识包 | 像老师傅传授的经验诀窍 |
| 工具 | Tool | 智能体能调用的具体能力（读文件、搜索、发消息等） | 像员工手边的办公工具 |
| 频道 | Channel | 连接 Telegram、飞书、Discord 等平台 | 像员工的多个联系方式 |
| 提示词 | Prompt | 你给它的指令 | 像给员工安排工作 |
| 定时任务 | Cron Job | 按时间表自动执行 | 像设了个闹钟 |
| 心跳 | Heartbeat | 定期自动检查状态并主动汇报 | 像保安巡逻 |
| 子智能体 | Sub-agent | 派出"分身"并行处理 | 像带了一个小团队 |
| 上下文 | Context | 智能体当前能"看到"的所有信息 | 像工作记忆，桌上摊开的文件 |
| 节点 | Node | 把手机/平板连接为智能体的"眼睛和手" | 像给员工配了手机 |



### 如何阅读本合集？

每个用例都按统一格式组织：

| 章节 | 内容 |
|------|------|
| **痛点** | 这个用例解决什么问题 |
| **它能做什么** | 具体功能列表 |
| **所需技能** | 需要安装哪些插件 |
| **如何设置** | 手把手教你配置（含可复制的提示词） |
| **实用建议** | 踩过的坑和最佳实践 |

> 💡 **提示**：代码块中的英文 prompt（提示词）建议直接复制使用，效果最佳。每段 prompt 上方都有中文说明帮你理解其作用。

> 🤖 **Agent 友好**：本合集的用例格式经过结构化设计，除了方便你阅读，也可以把用例文件交给 AI 智能体（OpenClaw / Hermes / Claude Code / Codex 等）辅助执行。智能体入口见 **[AGENTS.md](AGENTS.md)**：它会先替你算出"最少要亲自做什么、在什么时点做"，再开始动手。代码块执行细则见 [AGENT-GUIDE.md](AGENT-GUIDE.md)。效果因用例复杂度而异，复杂用例仍建议通读全文。

---

> ⚠️ **安全提醒**：本合集引用的技能和第三方依赖**未经维护者审核**。使用前请审查源代码、检查权限，避免硬编码凭证。

> 难度说明：⭐ 复制粘贴即可用 · ⭐⭐ 需要简单配置 · ⭐⭐⭐ 需要一定技术基础

---

## 🇨🇳 中国特色用例

> 为中国工具生态设计或适配的用例，使用飞书、钉钉、企业微信、小红书等国内平台。标注"适配"的用例在国际版基础上增加了国内方案。共 23 个，按场景分 5 类。

### 平台机器人

把 OpenClaw 接入国内 IM 和办公平台，在日常对话中使用 AI。

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [飞书 AI 助手](usecases/cn-feishu-ai-assistant.md) | 把 OpenClaw 部署为飞书机器人，在对话中直接触发 AI 任务，支持文档自动化 | ⭐⭐ |
| [飞书全能操作台（Lark CLI）](usecases/cn-feishu-lark-cli.md) | 让 AI Agent 以你的身份操作飞书——搜文档、读妙记、查日历、发消息，覆盖 11 个领域 200+ 命令 | ⭐ |
| [钉钉 AI 助手](usecases/cn-dingtalk-ai-assistant.md) | 把 OpenClaw 部署为钉钉机器人，Stream 模式无需公网 IP | ⭐⭐ |
| [企业微信 AI 助手](usecases/cn-wecom-ai-assistant.md) | 在企业微信中使用 AI，通过微信插件让个人微信也能用 | ⭐⭐ |

### 内容创作与发布

从选题、写作、排版到发布的自动化流水线。

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [小红书内容自动化](usecases/cn-xiaohongshu-automation.md) | 从选题、文案、封面图到定时发布的全流程自动化 | ⭐ |
| [微信公众号自动发布](usecases/cn-wechat-mp-automation.md) | Markdown 转排版 + 草稿箱推送，含账号权限矩阵与 IP 白名单配置 | ⭐⭐ |
| [播客制作流水线（适配）](usecases/podcast-production-pipeline.md) | 从选题到发布的全流程播客制作自动化（小宇宙/喜马拉雅/B站） | ⭐⭐ |

### 数据研究与监控

商业数据、学术论文、互联网内容的采集与分析。

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [A 股每日行情监控](usecases/cn-a-share-monitor.md) | 盘前简报 + 盘后复盘 + 板块资金流向，AKShare/MCP 数据源 | ⭐⭐ |
| [AI 财报追踪器（适配）](usecases/earnings-tracker.md) | A 股财报追踪，AKShare 免费数据源 + 业绩预告/快报自动化 | ⭐⭐ |
| [竞争对手分析与价格监控（适配）](usecases/competitive-intelligence.md) | Perplexity + Firecrawl MCP 竞品周报，百度指数/微信指数/飞书推送 | ⭐⭐ |
| [开发前创意验证器（适配）](usecases/pre-build-idea-validator.md) | 编码前自动扫描竞品（百度指数/微信指数/V2EX/少数派） | ⭐⭐ |
| [中文互联网 30 天研究](usecases/cn-internet-research-30days.md) | 8 大中文平台（微博/B站/知乎/抖音/小红书/微信/百度/头条）内容聚合研究 | ⭐⭐ |
| [HuggingFace 论文发现（适配）](usecases/hf-papers-research-discovery.md) | 每日热门 ML 论文筛选 + arXiv 深读，HF 镜像站/飞书推送 | ⭐ |
| [arXiv 论文阅读与 LaTeX 写作（适配）](usecases/arxiv-paper-reader-latex-writer.md) | 论文获取/章节浏览/摘要速扫 + LaTeX 即时编译，中文模板/Docker 镜像适配 | ⭐⭐ |

### 办公与客户服务

企业内部工作流、会议协作、对外客服。

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [办公自动化套件](usecases/cn-office-automation.md) | 邮件管理、文件整理、会议纪要、周报生成，支持 163/QQ/Outlook | ⭐⭐ |
| [会议纪要与待办自动化（适配）](usecases/meeting-notes-action-items.md) | 会议转录自动生成纪要并创建任务（飞书妙记/腾讯会议/钉钉） | ⭐⭐ |
| [多渠道 AI 客户服务（适配）](usecases/multi-channel-customer-service.md) | 企业微信/抖音/小红书多渠道客服自动化 | ⭐⭐⭐ |
| [电商多 Agent 架构](usecases/cn-ecommerce-multi-agent.md) | 多 Agent 绑定飞书群实现电商角色分工，4 个 Skill 覆盖销售/库存/客户全场景 | ⭐⭐ |

### 个人助理与智能体架构

日常推送、人格档案、多智能体编排。

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [早间简报（适配）](usecases/custom-morning-brief.md) | 每日定时推送简报到飞书/钉钉，支持中文新闻源和 cron 配置 | ⭐ |
| [数字人格蒸馏（适配）](usecases/digital-persona-distillation.md) | 从 12+ 平台聊天记录提取 4 维人格档案，含飞书/微信采集和 PIPL 提醒 | ⭐⭐⭐ |
| [多智能体协作操作系统](usecases/cn-multi-agent-operating-system.md) | 把 OpenClaw 变成专业分工、协同、稳定迭代的智能体系统 | ⭐⭐⭐ |
| [Agent Swarm 一人开发团队（适配）](usecases/agent-swarm-dev-team.md) | OpenClaw 编排 Codex + Claude Code 舰队，全自动化开发流水线 | ⭐⭐⭐ |
| [Multica 智能体看板（适配）](usecases/multica-managed-agents.md) | 把 OpenClaw / Claude Code / Codex / Hermes 拉进同一个 Web 看板，Issue 即任务、Apache 2.0 自部署 | ⭐⭐ |

---

## 🌐 通用场景

> OpenClaw 国际社区贡献的通用用例，按场景分类。部分用例已在文件底部补充了国内适配章节。

### 社交媒体

> 自动聚合你关心的内容，告别信息焦虑

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [每日 Reddit 摘要](usecases/daily-reddit-digest.md) | 根据你的偏好，生成你喜爱的 subreddit 精选摘要 | ⭐ |
| [每日 YouTube 摘要](usecases/daily-youtube-digest.md) | 获取你关注频道的每日新视频摘要，不错过任何内容 | ⭐ |
| [X 账号分析](usecases/x-account-analysis.md) | 获取你的 X（原 Twitter）账号的定性分析 | ⭐⭐ |
| [多源科技新闻摘要](usecases/multi-source-tech-news-digest.md) | 自动聚合 109+ 来源的科技新闻，支持质量评分和多渠道分发 | ⭐⭐ |

### 创意与构建

> 让 AI 智能体帮你创作内容、从零构建产品

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [目标驱动的自主任务](usecases/overnight-mini-app-builder.md) | 告诉 AI 你的目标，它自动拆解并每天执行，还能一夜之间造出迷你应用 | ⭐⭐ |
| [YouTube 内容流水线](usecases/youtube-content-pipeline.md) | 为 YouTube 频道自动化视频创意发掘、研究和追踪 | ⭐⭐⭐ |
| [多智能体内容工厂](usecases/content-factory.md) | 在 Discord 中运行研究、写作、设计三个智能体组成的内容流水线 | ⭐⭐⭐ |

### 基础设施与 DevOps

> 让服务器自己修自己，你只管睡觉

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [n8n 工作流编排](usecases/n8n-workflow-orchestration.md) | 通过 webhook 将 API 调用委托给 n8n 工作流，智能体从不接触凭证 | ⭐⭐⭐ |
| [Opik 可观测性追踪](usecases/opik-openclaw-observability.md) | 将 OpenClaw 运行链路接入 Opik，统一查看 LLM/工具/子智能体追踪，并监控 token 与成本 | ⭐⭐ |
| [自愈家庭服务器](usecases/self-healing-home-server.md) | 运行始终在线的基础设施智能体，自动发现并修复故障 | ⭐⭐⭐ |
| [Agent Swarm 一人开发团队](usecases/agent-swarm-dev-team.md) | OpenClaw 编排 Codex + Claude Code 舰队实现全自动化开发流水线（国内适配） | ⭐⭐⭐ |
| [Multica 智能体看板](usecases/multica-managed-agents.md) | 多 CLI 智能体统一 Web 看板，Issue 即任务、Skills 可复用，Apache 2.0 自部署（国内适配） | ⭐⭐ |

### 生产力

> 把重复性工作交给 AI，专注于真正重要的事

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [定制早间简报](usecases/custom-morning-brief.md) | 每天醒来就有专属简报——新闻、任务、内容草稿、AI 推荐操作（国内适配） | ⭐ |
| [收件箱整理](usecases/inbox-declutter.md) | 自动总结新闻通讯并发送摘要邮件，告别邮件堆积 | ⭐ |
| [第二大脑](usecases/second-brain.md) | 随手发消息记住一切，在自定义仪表板中随时搜索 | ⭐ |
| [个人 CRM](usecases/personal-crm.md) | 自动从邮件和日历中发现并追踪联系人，支持自然语言查询 | ⭐⭐ |
| [健康与症状追踪器](usecases/health-symptom-tracker.md) | 追踪食物摄入和症状以识别过敏诱因，带有定期签到提醒 | ⭐ |
| [基于电话的个人助理](usecases/phone-based-personal-assistant.md) | 通过电话或短信从任何手机访问你的 AI 智能体 | ⭐⭐ |
| [多渠道个人助理](usecases/multi-channel-assistant.md) | 一个 AI 助理统管 Telegram、Slack、邮件和日历 | ⭐⭐ |
| [家庭日历与家务助理](usecases/family-calendar-household-assistant.md) | 聚合所有家庭日历到早间简报，监控消息获取预约，管理家庭库存 | ⭐⭐ |
| [Todoist 任务管理器](usecases/todoist-task-manager.md) | 将 AI 推理和进度日志同步到 Todoist，实时看到智能体在做什么 | ⭐⭐ |
| [多渠道 AI 客户服务](usecases/multi-channel-customer-service.md) | WhatsApp + Instagram + 邮件 + Google 评价统一到 AI 收件箱（国内适配） | ⭐⭐⭐ |
| [活动嘉宾确认](usecases/event-guest-confirmation.md) | 自动逐一呼叫嘉宾确认出席、收集备注并编译摘要 | ⭐⭐ |
| [项目状态管理](usecases/project-state-management.md) | 事件驱动的项目追踪，自动捕获上下文，取代静态看板 | ⭐⭐⭐ |
| [动态仪表板](usecases/dynamic-dashboard.md) | 实时仪表板，子智能体并行从 API、数据库和社交媒体获取数据 | ⭐⭐⭐ |
| [自主项目管理](usecases/autonomous-project-management.md) | 使用 STATE.yaml 模式协调多智能体项目，无需人工编排 | ⭐⭐⭐ |
| [多智能体专业团队](usecases/multi-agent-team.md) | 4 个专业 AI 智能体（战略+开发+营销+商务）作为你的虚拟团队 | ⭐⭐⭐ |
| [数字人格蒸馏](usecases/digital-persona-distillation.md) | 从 12+ 平台聊天记录提取 4 维人格档案（国内适配） | ⭐⭐⭐ |

### 研究与学习

> 让 AI 帮你整理知识、追踪市场、发现机会

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [个人知识库 (RAG)](usecases/knowledge-base-rag.md) | 把 URL、推文和文章拖入聊天，构建可语义搜索的知识库 | ⭐⭐ |
| [AI 财报追踪器](usecases/earnings-tracker.md) | 追踪科技/AI 公司财报，自动化预览、提醒和详细摘要（国内适配） | ⭐⭐ |
| [语义记忆搜索](usecases/semantic-memory-search.md) | 为 OpenClaw 记忆文件添加向量驱动的语义搜索 | ⭐⭐ |
| [市场研究与产品工厂](usecases/market-research-product-factory.md) | 从 Reddit 和 X 挖掘真实痛点，让 AI 构建解决方案 MVP | ⭐⭐⭐ |
| [开发前创意验证器](usecases/pre-build-idea-validator.md) | 编码前自动扫描竞品，返回竞争度评分（国内适配） | ⭐⭐ |
| [竞争对手分析与价格监控](usecases/competitive-intelligence.md) | Perplexity + Firecrawl MCP 构建竞品周报，月 $1.20 替代 $150 订阅（国内适配） | ⭐⭐ |
| [HuggingFace 论文发现](usecases/hf-papers-research-discovery.md) | 每日热门 ML 论文筛选、元数据浏览、社区信号 + arXiv 深读（国内适配） | ⭐ |
| [arXiv 论文阅读与 LaTeX 写作](usecases/arxiv-paper-reader-latex-writer.md) | 论文获取/章节浏览/摘要速扫 + LaTeX 即时编译，无需本地 TeX 环境（国内适配） | ⭐⭐ |
| [中文互联网 30 天研究](usecases/cn-internet-research-30days.md) | 8 大中文平台内容聚合研究，三级降级策略，零配置可用 4 个免费平台 | ⭐⭐ |

### 金融与交易

> 用 AI 在预测市场上做模拟交易和策略回测

| 名称 | 描述 | 难度 |
|------|------|:---:|
| [Polymarket 自动驾驶](usecases/polymarket-autopilot.md) | 自动化预测市场模拟交易，带回测、策略分析和每日绩效报告 | ⭐⭐⭐ |



---

> 💡 能用好 OpenClaw 这些用例，说明你在 AI 协作上很领先了。这些工具的背后，是 Coding Agent 工程能力的快速发展。想更自由地发挥这个能力，打造个性化生产级应用，欢迎关注 **[Agent-First Development](https://github.com/AlexAnys/agent-first-dev)**——基于斯坦福大学教授等授权，为所有背景的同学设计。项目开发中，欢迎宝贵反馈。

## 🌟 为什么选择这个合集？

| | 自己摸索 | 看碎片教程 | **本合集** |
|---|:---:|:---:|:---:|
| 用例经过真实验证 | ❌ 不确定能否跑通 | ⚠️ 质量参差不齐 | ✅ 每个用例有来源佐证 |
| 国内生态适配 | ❌ 需自行替换工具 | ❌ 多为海外方案 | ✅ 飞书/钉钉/企业微信/小红书 |
| 帮你选对方向 | ❌ skill 太多无从下手 | ⚠️ 只讲功能不讲场景 | ✅ 按真实场景组织，难度分级 |
| 照做就能跑通 | ❌ 缺配置和提示词 | ⚠️ 步骤常不完整 | ✅ 完整步骤 + 可复制的提示词 |
| 从零入门 | ❌ 默认你已经会了 | ⚠️ 各说各的 | ✅ 核心概念解释 + 新手指南 |

---

## 🤝 贡献

我们欢迎经过验证的真实用例。详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

- **提交国内生态用例**（飞书、钉钉、企业微信、小红书等）
- **适配国际用例**（在已有用例基础上增加国内方案）
- **改进现有内容**（补充实践经验、修正过时信息）

> 收录标准：真实跑通 + 多源验证 + 读者照做能复现。不接受未测试的用例和加密货币相关内容。

---

## 📌 相关资源

- [OpenClaw 官方仓库](https://github.com/openclaw/openclaw) — 安装和官方文档
- [GitHub 主仓库](https://github.com/AlexAnys/awesome-openclaw-usecases-zh) — 主要开发与讨论在此进行
- [AtomGit 国内托管](https://atomgit.com/alex_anys/awesome-openclaw-usecases-zh) — 国内访问更快，内容同步更新

---



---

## 📈 Star History

<a href="https://star-history.com/#AlexAnys/awesome-openclaw-usecases-zh&Date">
 
   
   
   
 
</a>

## 2. Official Technical Reference & Guides (AlexAnys/agent-first-dev)

# Agent-First Dev 智能体开发最重要的事

> 与 Coding Agent 协作构建生产级应用的最小必要知识。基于 [Stanford CS146S](https://themodernsoftware.dev)（授权）和 Chicago Booth Application Development 课程。

[](https://github.com/AlexAnys/agent-first-dev)

**目录**: [背景](#背景) · [为什么做这个仓库](#为什么做这个仓库) · [模块总览](#模块总览) · [前置要求](#前置要求) · [如何使用](#如何使用这个知识库) · [授权与致谢](#授权与致谢)

## 背景

> "会写代码还意味着一件事：你有了想法，就能自己动手做出来。这不是必须的（Jeff Bezos 就不会写代码），但这是个巨大的优势。当你琢磨一个点子——比如把大学花名册搬到网上——你的反应不再是'这想法挺有意思'，而是'这想法挺有意思，今晚我就做个初版出来'。"
>
> — Paul Graham, *[How to Get Startup Ideas](http://paulgraham.com/startupideas.html)*（Chicago Booth BUSN 36110 课程开篇引用）

我是一个非技术背景的 MBA 学生。2025 年秋在 Chicago Booth 修了一门 Application Development 课程，从写第一行代码开始。四个月后，我在用 Coding Agent 从零开发生产级的全栈 SaaS 应用。

从今年 2 月到现在，我在 GitHub 上收获了 4700+ Star，利用业余时间同时管理着二十多个开源项目，这超出了以前的想象。

## 为什么做这个仓库

**[25年底以来 Coding Agent 的能力已经发生质变](https://wtfhappened2025.com/)。** Claude Code、Cursor 等工具可以在相当长的时间里自主完成完整的开发任务，包括生产级应用。但大多数非技术背景的人还卡在 vibe coding 阶段：用 lovable、manus、v0 生成一个 Demo，看起来能跑，实际上线第一天就崩。

与此同时，市面上铺天盖地的 AI 工具推荐和教程，噪音远大于信号。

**这个仓库就是我回过头来，把最重要的东西整理出来。**

1. **走过的弯路和经验教训** — 哪些知识真正有用，哪些是浪费时间
2. **为什么学习有时候是一种"诅咒"** — 并非知识越多越好，过度学习反而让你不敢动手
3. **最小必要知识** — 从 Stanford 和 Chicago Booth 两门顶级课程中，提取出与 Coding Agent 协作进行全栈开发刚好够用的信息

我的核心信念：**Learn by Doing**。不是先学完再做，而是在做的过程中，只学当下需要的东西。这个仓库会持续更新，分享我对即时学习（Just-in-Time Learning）、知识必要性、以及什么才是 AI 时代学习方式的思考。

> 📖 **[领域专家 × AI 协作框架](FRAMEWORK.md)** — 这些模块背后的方法论体系。关于如何学习、如何思考、如何与 AI 协作的通用框架。也可以直接作为 AI Agent 的上下文，帮助你更有效地学习任何领域。

---

## 模块总览

知识库按模块组织，每个模块聚焦一个完整主题。

| 模块 | 说明 | 状态 |
|------|------|------|
| [**Agentic Coding**](modules/agentic-coding/README.md) | 与 AI 协作的软件开发（改编自 Stanford CS146S，10 周） | **进行中** |
| [**Application Development**](modules/app-dev-fundamentals/README.md) | 理解软件是怎么运作的（基于 Chicago Booth BUSN 36110 核心思想） | **框架已搭建** |
| [**Getting Started**](modules/getting-started/README.md) | 从零开始的 30 分钟：环境搭建、工具选择、第一个项目 | **已完成** |

| 其他资源 | 说明 |
|----------|------|
| [**FRAMEWORK.md**](FRAMEWORK.md) | 领域专家 × AI 协作框架：学习方法论与思维模型（人类参考 + Agent 上下文） |
| [`guides/`](guides/README.md) | 跨模块实用指南（如何选 AI 工具、如何调试等） |
| [`resources/`](resources/README.md) | 学习资源汇总：推荐阅读、视频、社区 |
| [`TERMINOLOGY.md`](TERMINOLOGY.md) | 术语表 |

---

## 模块 1: Agentic Coding

> 改编自 [Stanford CS146S](https://themodernsoftware.dev)，由 Mihail Eric 设计。完整的 10 周课程，覆盖从提示工程到系统监控的软件全生命周期。
>
> → [**模块首页**](modules/agentic-coding/README.md)（课程逻辑、学习路径、嘉宾一览）

| 周次 | 主题 | 一句话简介 |
|------|------|-----------|
| [Week 1](modules/agentic-coding/week1/README.md) | 提示工程 | 6 种核心提示技术，从零开始学会跟 AI 说话 |
| [Week 2](modules/agentic-coding/week2/README.md) | AI 辅助全栈开发 | 用 AI 构建一个完整的 Web 应用 |
| [Week 3](modules/agentic-coding/week3/README.md) | MCP 服务器 | 扩展 AI 的能力边界，让它能调用外部工具和数据 |
| [Week 4](modules/agentic-coding/week4/README.md) | 自主编码代理 | Claude Code 深度实践，理解代理式开发的核心理念 |
| [Week 5](modules/agentic-coding/week5/README.md) | Warp Agentic 开发 | 多代理工作流，让多个 AI 协同工作 |
| [Week 6](modules/agentic-coding/week6/README.md) | 安全扫描 | AI 辅助的代码安全检查 |
| [Week 7](modules/agentic-coding/week7/README.md) | AI 代码审查 | 人机协作的质量保障 |
| [Week 8](modules/agentic-coding/week8/README.md) | 多技术栈应用 | Vibe Coding 的正确打开方式 |
| | **延伸阅读** | |
| [Week 9](modules/agentic-coding/week9/README.md) | AI 系统监控 | 生产环境监控与事件响应（阅读材料 + 自学实践） |
| [Week 10](modules/agentic-coding/week10/README.md) | AI 软件工程的未来 | 行业展望与持续学习（阅读材料 + 自学实践） |

**快速路径**: Week 1 → 2 → 4 → 8 · **完整路径**: Week 1-8 + 延伸阅读 · 详见[模块首页](modules/agentic-coding/README.md)

---

## 模块 2: Application Development

> 理解软件是怎么运作的。基于 Chicago Booth BUSN 36110 课程核心思想，用螺旋式学习法构建对 Web 应用的完整心智模型。
>
> → [**模块首页**](modules/app-dev-fundamentals/README.md)（课程思想、教学理念、与 Agentic Coding 的关系）

| 章节 | 主题 | 一句话简介 |
|------|------|-----------|
| [01](modules/app-dev-fundamentals/01-how-the-web-works/README.md) | 互联网是怎么工作的 | HTTP 请求与响应，URL 的工作原理 |
| [02](modules/app-dev-fundamentals/02-data-modeling/README.md) | 数据建模 | 最高杠杆的技能——名词变成表 |
| [03](modules/app-dev-fundamentals/03-request-lifecycle/README.md) | 请求的生命周期 | RCAV: URL 如何变成你看到的页面 |
| [04](modules/app-dev-fundamentals/04-databases-and-crud/README.md) | 数据库与 CRUD | 增删改查——所有应用的骨架 |
| [05](modules/app-dev-fundamentals/05-apis/README.md) | API | "一切都是 HTTP 请求" |
| [06](modules/app-dev-fundamentals/06-auth-and-security/README.md) | 认证与安全 | 谁是你，你能做什么 |
| [方法论](modules/app-dev-fundamentals/methodology/README.md) | 教学理念 | 螺旋学习、砍范围、AI 是乘数 |

---

## 模块 3: Getting Started

> 从完全没写过代码，到用 AI 做出一个能跑的网页。30 分钟环境搭建 + 第一个项目。
>
> → [**开始学习**](modules/getting-started/README.md)（选工具、认识终端、第一个项目、发布上线）

---

## 前置要求

- 基本的电脑操作能力（会用浏览器、安装软件）
- 愿意学习新事物的心态
- **不需要**任何编程经验
- **不需要**计算机科学背景

---

## 从哪里开始？

- 🟢 **完全没写过代码** → [Getting Started](modules/getting-started/README.md)（30 分钟搭环境 + 第一个项目）→ [Agentic Coding Week 1](modules/agentic-coding/week1/README.md)
- 🟡 **用过 ChatGPT / v0 / lovable，但没正式学过开发** → [Agentic Coding Week 1](modules/agentic-coding/week1/README.md) → 快速路径（Week 1→2→4→8）
- 🔵 **有开发经验，想学 AI 协作** → [Agentic Coding Week 4](modules/agentic-coding/week4/README.md)（直接进 Claude Code）

> 不确定？从 [Getting Started](modules/getting-started/README.md) 开始，30 分钟后你就知道自己在哪个阶段了。

---

## 如何使用这个知识库

1. **从哪开始**：看上方[从哪里开始](#从哪里开始)的决策树，找到你的起点
2. **查看模块首页**：每个模块都有独立的 README，包含课程逻辑、学习路径和推荐顺序
3. **遇到不懂的术语**：查阅 [`TERMINOLOGY.md`（术语表）](TERMINOLOGY.md)
4. **跳过可以跳过的**：如果某个部分你已经熟悉，直接跳到下一个
5. **动手做项目**：每个模块都有练习，建议跟着做，光读不练效果减半

---

## 授权与致谢

本知识库的 Agentic Coding 模块经 Stanford CS146S 课程设计者 [Mihail Eric](https://www.mihaileric.com) 授权，将课程材料翻译并改编为中文学习路径。

- 原始课程网站: [The Modern Software Developer](https://themodernsoftware.dev)
- 原课程内容版权归 Mihail Eric 所有

本项目不是单纯的翻译，而是结合作者在 Chicago Booth Application Development 课程中的实践经验（非技术背景，4 个月内用 AI 辅助开发交付 20+ 开源项目），为非 CS 背景的学习者重新组织的自学路径。

---

## 📌 相关资源

- [GitHub 主仓库](https://github.com/AlexAnys/agent-first-dev) — 主要开发与讨论在此进行

---

## 许可协议

本项目采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 协议。

- **BY**（署名）— 使用或改编本内容时，请注明出处并链接到[本仓库](https://github.com/AlexAnys/agent-first-dev)和[原课程](https://themodernsoftware.dev)
- **NC**（非商业）— 不得用于商业目的
- **SA**（相同方式共享）— 改编作品须以相同协议发布