2026-02-10 14:51:54 +08:00
# 前言
2026-02-23 15:04:30 +08:00
1. AI算法讲解
2026-02-26 15:15:24 +08:00
1. [【Transformer】最强动画讲解! 目前B站最全最详细的Transformer教程, 2025最新版! 从理论到实战, 通俗易懂解释原理, 草履虫都学的会! ](https://www.bilibili.com/video/BV1fj6vBfEnu/?p=3&share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e )
2026-02-23 14:34:26 +08:00
2. Claude: 编程向的LLM大模型
2026-02-10 17:21:08 +08:00
1. 本地部署 LLM, 无订阅使用 Claude Code https://km.netease.com/v4/detail/blog/258409
2026-02-26 19:19:35 +08:00
1. 【【硬核教程】教你搭建Mac AI集群! 4台M3 Ultra, 运行万亿参数大模型! 】 https://www.bilibili.com/video/BV18wZjBuEUB/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2. 【模型推理时所需的GPU显存】 https://www.bilibili.com/video/BV1up25Y7Emb/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-03-04 00:50:24 +08:00
2. [ ] ClaudeCode插件
2026-02-24 19:15:40 +08:00
1. 【🚀告别Vibe Coding! 用Superpowers让Claude Code写出工程级代码, 一次通过零报错! 遵循TDD最佳实践! 支持Codex】 https://www.bilibili.com/video/BV11urFBrEc4/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2. Ralph for Claude Code: 【🚀Claude Code自动化开发必备神器! Ralph for Claude Code实战演示, 导入PRD文档秒变任务清单, AI通宵帮你写代码! 保姆级教程】 https://www.bilibili.com/video/BV1V9kEB7Erw/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-03-04 00:50:24 +08:00
3. [ ] Claude Code Agent Teams 实验与技术剖析 https://km.netease.com/v4/detail/blog/259175
4. [ ] [Anthropic 黑客马拉松获胜者的完整 Claude Code 配置集合 ](https://github.com/affaan-m/everything-claude-code/blob/main/README.zh-CN.md )
5. [ ] [claude.md怎么写才能让Claude Code更高效? ](https://www.zhihu.com/question/1979609139266213083/answer/2009919949922133046?share_code=vC8d59XJYGNj&utm_psn=2010698466100262066 )
6. [ ] [他把Claude Code给玩通关了 - 欧巴聊AI的文章 - 知乎 ](https://zhuanlan.zhihu.com/p/2001805409359520847 )
2026-02-23 15:04:30 +08:00
3. 教学视频
2026-02-11 23:52:34 +08:00
1. ClaudeCode
2026-03-04 00:50:24 +08:00
1. [x] 【Claude Code 从 0 到 1 全攻略: MCP / SubAgent / Agent Skill / Hook / 图片 / 上下文处理/ 后台任务】 https://www.bilibili.com/video/BV14rzQB9EJj/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2. [x] 【最火AI编程Claude Code详细攻略, 一期视频精通】 https://www.bilibili.com/video/BV1XGbazvEuh/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
3. 【AI Max+ 395突破96G显存限制部署GLM-4.7生成电脑游戏】 https://www.bilibili.com/video/BV1pfixBvEzC/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-11 23:52:34 +08:00
2. CodeX
1. 【AI编程新王Codex详细攻略, 一期视频精通, 附免费使用方法】 https://www.bilibili.com/video/BV1wm4UzfEbr/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
3. OpenCode
1. 【OpenCode详细攻略, 开源版Claude Code, 免费模型与神级插件】 https://www.bilibili.com/video/BV1BVrXBUEbR/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
4. MCP
1. 【用过上百款编程MCP, 只有这15个真正好用, Claude Code与Codex配置MCP详细教程】 https://www.bilibili.com/video/BV1ZJsBznEt3/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2. 【从零编写MCP并发布上线, 超简单! 手把手教程】 https://www.bilibili.com/video/BV1RNTtzMENj/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
5. Skill
1. 【Agent Skills (Claude Skills) 详细攻略,一期视频精通】 https://www.bilibili.com/video/BV1HuiyBQE9G/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2. 我用Claude白嫖了整个Github, 现在每天只工作2小时 https://zhuanlan.zhihu.com/p/1998522824734815001
2026-02-26 19:19:35 +08:00
3. 【解读EvoMap(Evolver), 让Openclaw自我进化的神秘机制】 https://www.bilibili.com/video/BV1hcf1BxETm/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-12 09:24:33 +08:00
6. Agent
1. 【Agent 的概念、原理与构建模式 —— 从零打造一个简化版的 Claude Code】 https://www.bilibili.com/video/BV1TSg7zuEqR/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2. 《AI Agent设计实战: 智能体设计的方法与技巧》
3. 如何从0开始写一个AI Agent: nanobot源码分析 https://km.netease.com/v4/detail/blog/259144
1. 学习OpenClaw、OpenCode来编写AITA Agent。
2. Agent论文 大学生。
3. 【那些 Agent 神文没告诉你的事:照着做,系统只会更烂 【AI agent 搭建实操指南】】 https://www.bilibili.com/video/BV1nPq2BoEf3/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
4. 【AI agent 开发千万别越努力, 越心酸! 【AI agent 搭建实操指南 第二弹】】 https://www.bilibili.com/video/BV1VzvYBBE92/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-26 15:15:24 +08:00
2026-02-23 15:04:30 +08:00
4. WY工具
2026-02-10 17:21:08 +08:00
1. Claude Dashboard: AI并行编程的指挥中心 https://km.netease.com/v4/detail/blog/258957
2026-02-27 20:32:57 +08:00
2. WY MCP市场:https://modelspace.netease.com/mcphub
2026-02-23 15:04:30 +08:00
5. 开发案例:
2026-02-13 00:30:57 +08:00
1. 【GLM-5 一战封神,如何用他构建全自动开发系统?】 https://www.bilibili.com/video/BV1zZcYz1EMy/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-26 15:15:24 +08:00
6. 其他大模型: 【免费Claude Code, 免费模型有满血版几成功力? Claude Code高热度AI编程工具】 https://www.bilibili.com/video/BV1jGtEzNEAv/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-20 23:17:00 +08:00
1. 【普通人学AI, 如何理智地选择Coding Plan】 https://www.bilibili.com/video/BV14yfuBnEkc/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2. ClaudeCode API: 可以通过OpenRouter来中转API。
3. GLM5
4. QWen
5. Gemini
2026-02-26 15:15:24 +08:00
7. Trae
2026-02-11 20:39:19 +08:00
1. 【MCP到虚幻5, 感觉吃了一坨大的, 但是有点甜! AI创作游戏前瞻, trae+UE】 https://www.bilibili.com/video/BV1JmG9zPEqw/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-15 22:58:53 +08:00
2. * * *【TRAE正式上线Seed 2.0模型! 和Seedance2同代的编程模型, Seed2.0到底什么水平*** https://www.bilibili.com/video/BV1y8ZLBcEMQ/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-26 15:15:24 +08:00
8. MacStudio叠罗汉
2026-02-12 20:53:48 +08:00
1. 在 Mac Studio 集群上用 MLX 做分布式推理 / 训练,核心是**统一环境、免密 SSH、低延迟网络、mlx.launch 调度**,推荐优先用 Thunderbolt 5 + RDMA 以获得最佳性能。
2026-02-26 15:15:24 +08:00
9. 其他
2026-02-20 23:17:00 +08:00
1. 它把Coding Agent 是怎么工作的讲清楚了 https://www.zhihu.com/pin/1996206268008927358?native=1&scene=share&share_code=rhJTYBz9Y9iW&utm_psn=2006646711288870147
2. 【【深度解析】字节开源 OpenViking: 给 AI Agent 装上文件系统-哔哩哔哩】 https://b23.tv/LXBFLLj
3. 【手把手教你做Skill, 把Github变成本地知识库】 https://www.bilibili.com/video/BV1p46eBPEWP/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
4. 【聊一下AI时代怎么选取信息源】 https://www.bilibili.com/video/BV1xr6GB5EnH/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-25 10:44:03 +08:00
5. ClaudeCode Three3D.js Skill https://github.com/CloudAI-X/threejs-skills
2026-02-25 12:14:59 +08:00
6. 【【OpenCode】小彭老师skills+提示词配置分享】 https://www.bilibili.com/video/BV16WfwBDE4y/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
2026-02-22 22:00:41 +08:00
1. https://github.com/archibate/dotfiles-opencode
2026-02-10 14:51:54 +08:00
2026-02-11 23:52:34 +08:00
## Skill与MCP对比
| | 侧重点 | 类比 | Token消耗 | 核心主体 | 编写难度 |
| ------------ | -------- | -------------- | --------- | ------------ | -------- |
| Agent Skills | 提示词 | 带目录的说明书 | 低 | Markdown文件 | 低 |
| MCP | 工具调用 | 标准化工具箱 | 高 | 软件包 | 高 |
2026-03-02 11:02:35 +08:00
# Token
github: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
2026-03-08 19:54:09 +08:00
OpenClaw
y_yg3nEbh3s3xS3Z2-Vy
2026-02-25 17:04:28 +08:00
# WY API
- ANTHROPIC_AUTH_TOKEN:deweza3h28b2umy2.i0utchmh7l8ofrkliv6k1kbp2o42ahmg
- ANTHROPIC_BASE_URL:https://openai.nie.netease.com
- DISABLE_AUTOUPDATER:1
2026-02-11 23:52:34 +08:00
2026-02-26 13:03:23 +08:00
PS. 接入OpenClaw, API格式是基于OpenAI的。
2026-02-11 23:52:34 +08:00
# ClaudeCode
2026-03-04 00:50:24 +08:00
- 教学视频
- [【Claude Code 从 0 到 1 全攻略: MCP / SubAgent / Agent Skill / Hook / 图片 / 上下文处理/ 后台任务】 https://www.bilibili.com/video/BV14rzQB9EJj/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
- 可视化客户端:https://github.com/getAsterisk/claudia
- Insight -> Forks -> xuzhenpeng263 / claudia-globa
2026-02-26 15:15:24 +08:00
2026-03-04 00:50:24 +08:00
## Claude.md
ClaudeCode每次启动都会读取这个文件。
### 🤔 为什么你需要一个 `CLAUDE.md` 文件?
Claude 每次对话都是独立的,没有项目记忆。`CLAUDE.md` 解决了这个问题,它会在每次会话开始时自动加载,告诉 Claude 关于你项目的一切,让你无需重复说明项目背景、代码风格或常用命令。
**编写优秀 `CLAUDE.md` 的核心原则:**
- **简洁为王,保持精悍**: Claude的上下文窗口是宝贵的资源。文件应尽量精炼, 最好控制在300行以内, 确保每一条信息都不可或缺。
- **具体明确,拒绝模糊**: 指令要清晰、可操作。不要说“代码写得好一点”, 而要规定“使用ES模块, 推崇命名导出, 变量命名采用驼峰式”这样的具体规则。
- **持续进化,动态更新**:这不是一份写完就固定的文档。在开发过程中,如果发现 Claude 的某些做法不符合预期,可以随时让它“更新 `CLAUDE.md` :以后都使用日志库替代 `console.log` ”。通过这种持续迭代,让文件成为项目活的规范。
- **善用引用,分层管理**:对于庞大的项目,可以将通用规则放在根目录的 `CLAUDE.md` 中, 而将特定模块的细节( 如API设计模式) 拆分到单独的文件里, 再用 `@docs/api-patterns.md` 的方式引入。此外,`.claude/rules/` 目录和子目录下的 `CLAUDE.md` 文件也是实现模块化、按需加载的好方法。
### 🚀 优秀 `CLAUDE.md` 方案与实战案例
基于以上原则,这里为你提供一套可以直接套用的编写方案和几个不同场景的案例。
#### 基础通用模板
这个模板涵盖了大多数项目需要的基本信息,你可以根据自己的项目进行填充。
```markdown
# 项目: [项目名称]
一句话描述项目:这是一个[项目类型]应用,使用了[核心技术栈]和[关键集成服务]。
## 代码风格与规范
- **语言与框架**: [例如: TypeScript 严格模式, Next.js 14 App Router]
- **命名规则**: [例如:组件使用 PascalCase, 工具函数使用 camelCase, 样式类使用 kebab-case]
- **导入导出**: [例如:统一使用命名导出 (named export),避免默认导出 (default export)]
- **样式方案**: [例如:使用 TailwindCSS 工具类,禁止编写自定义 CSS 文件]
- **错误处理**: [例如:必须使用 try-catch 包裹异步操作,错误信息需记录到 Sentry]
## 重要命令
- `npm run dev` :启动开发服务器(端口 3000)
- `npm run build` :构建生产版本
- `npm run test` :运行单元测试 (Jest)
- `npm run lint` :运行代码检查 (ESLint)
- `npm run db:migrate` :执行数据库迁移
## 项目架构与重要约定
- `/app` : Next.js 路由和页面
- `/components/ui` : 可复用的UI组件库
- `/lib` :工具函数和共享逻辑
- `/prisma` : 数据库Schema和迁移文件
- **重要**: `/app/api/webhooks/stripe` 文件中的签名验证逻辑**严禁修改**
- **禁止**:将 `.env` 文件提交到代码仓库
```
#### 分层文件结构方案(适合大型项目)
当项目变得庞大时,单一文件会变得臃肿。可以采用分层结构,让 Claude 在不同目录下工作时,只加载最相关的规则。
```text
your-project/
├── CLAUDE.md # 全局规则: Git工作流、通用命令
├── .claude/
│ └── rules/
│ ├── testing.md # 测试规范, 被根目录CLAUDE.md引用
│ └── security.md # 安全规范
├── backend/
│ └── CLAUDE.md # 后端专属规则: Python/FastAPI 风格、数据库操作
└── frontend/
└── CLAUDE.md # 前端专属规则: React/TypeScript 组件规范、状态管理
```
#### 案例一: Next.js 电商项目
这个案例来自 Builder.io 的博客,清晰地展示了如何为一个具体的 Next.js 电商项目编写指令。
```markdown
# Project: ShopFront
Next.js 14 e-commerce application with App Router, Stripe payments, and Prisma ORM.
## Code Style
- TypeScript strict mode, no `any` types
- Use named exports, not default exports
- CSS: Tailwind utility classes, no custom CSS files
## Commands
- `npm run dev` : Start development server (port 3000)
- `npm run test` : Run Jest tests
- `npm run test:e2e` : Run Playwright end-to-end tests
- `npm run lint` : ESLint check
- `npm run db:migrate` : Run Prisma migrations
## Architecture
- `/app` : Next.js App Router pages and layouts
- `/components/ui` : Reusable UI components
- `/lib` : Utilities and shared logic
- `/prisma` : Database schema and migrations
- `/app/api` : API routes
## Important Notes
- NEVER commit .env files
- The Stripe webhook handler in /app/api/webhooks/stripe must validate signatures
- Product images are stored in Cloudinary, not locally
- See @docs/authentication .md for auth flow details
```
#### 案例二: 集成外部工具的支持调查员( Mergify 实战)
这个案例来自 Mergify 公司,展示了 `CLAUDE.md` 如何超越代码规范,成为一个复杂工作流的“大脑”。他们将技术支持手册编码进文件,让 Claude 能并行调查来自 Sentry、Datadog 和数据库的线索, 将平均处理时间从15分钟锐减到5分钟以内。
```markdown
# Support Investigation Agent
You are an expert support engineer for Mergify. Your goal is to investigate customer tickets by gathering evidence from multiple systems in parallel.
## Investigation Workflow (Execute Steps in Parallel)
1. **Identify Context ** : Extract `organization` , `repository` , and `PR number` from the ticket URL (fetched via Plain MCP).
2. **Launch Parallel Investigations (Wave 1) ** :
- **Database Query (Read-Only)**: Use `/pr-event-log` slash command to get event timeline for the PR.
- **Error Tracking**: Search Sentry (via MCP) for errors related to the customer org and timeframe.
- **Logs**: Query Datadog (via MCP) for relevant log spikes.
- **Existing Tickets**: Search Linear (via MCP) for related, unresolved issues.
3. **Synthesize Findings ** : Merge results from all sources into a unified timeline.
4. **Generate Output ** : Draft a response with findings, hypothesis, and suggested next steps. If a new bug is confirmed, create a Linear ticket draft with a fix plan.
## Important Constraints
- All database queries MUST include a `LIMIT` clause and time filter.
- Never assume causality; present findings as correlations for the engineer to review.
- If the investigation involves engine code, inspect it under the `src/` directory.
- Check GitHub status for ongoing incidents if widespread failures are suspected.
```
### 💡 高级技巧与避坑指南
- **`/init` 命令是你的好帮手**:在新项目中,首先运行 `/init` 命令。Claude 会自动扫描你的项目结构、依赖和文档,生成一个不错的 `CLAUDE.md` 基础版本,你可以在这个基础上修改,比自己从零开始写要快得多。
- **用 @ 精确引用信息**:在 `CLAUDE.md` 中,你可以使用 `@` 符号引用其他文件,如 `@README.md` 或 `@docs/api-spec.md` 。Claude 在需要时会自动读取这些文件的内容,这有助于保持主文件的简洁,同时又能提供深度信息。
- **区分团队共享与个人偏好**:将团队共有的规范放在项目内的 `CLAUDE.md` 中并提交至 Git。而个人的、无需共享的偏好( 如最喜欢的 Pizza 口味、个人笔记),可以放在 `CLAUDE.local.md` 或通过 `@~/.claude/info.md` 引用,并确保这些文件被 Git 忽略。
- **通过代码审查持续改进**:当同事在代码审查中指出一个未文档化的约定或错误时,这就是更新 `CLAUDE.md` 的最佳时机。甚至可以直接在 PR 评论中 @Claude ,让它根据评论自动更新文件,形成“发现问题 -> 更新规则 -> 预防未来问题”的良性循环。
- **避免“过度承诺”**:不要在文件中堆砌无用的套话,每一条指令都应该有它存在的价值。像“请编写高质量的代码”这种模糊指令可以删掉,它们只会稀释真正重要的信息。
2026-02-11 23:52:34 +08:00
## 操作命令
2026-03-04 00:50:24 +08:00
1. /init: 扫描项目所有代码, 并且记录上下文到**claude.md**。后续用户可以自己在里面补充相关信息。
2. * * /compact**: 压缩上下文。提高AI专注度并且可以节约token。 可以输入压缩策略,比如:重点保留用户需求。
3. * * /clear**:清楚上下文。一般在新任务开启时使用。
2026-02-11 23:52:34 +08:00
1. 控制AI思考时间的关键词 think < think hard < think harder < ultrathink
2026-03-04 00:50:24 +08:00
4. * * /resume**:回到上一个对话。
5. * * /skills**: 在项目目录下新建Skills文件夹, 在里面添加Skill。
1. 可以输出/SkillName, 主动让ClaudeCode调用指定Skill。
6. * * /ide**: 可以打通ClaudeCode与对应IDE。
7. /rewind 或者 按2下ESC: 回滚这一步操作。
8. /tasks: 查看后台任务。
9. ! 临时执行命令行。
10. # 向claude说明相关知识。
11. 在命令行中开启危险模式**输入:** `/permission` 或 `/config` 在弹出的设置菜单中,寻找 * * "Auto-approve safe commands"** 或 * * "Full Auto-approve"** 选项并开启。
12. 启动危险模式: claude --dangerously-skip-permissions; 执行完某个Prompt后退出: claude -p "运行测试并修复报错" --dangerously-skip-permissions
13. 切换模型:
2026-02-25 18:43:13 +08:00
1. claude --model claude-opus-4-6
2026-02-25 20:37:59 +08:00
2. claude --model glm-4.7-flash:q8_0
2026-03-04 00:50:24 +08:00
14. 永久修改模型设置:claude config set -g model claude-opus-4-6
2026-02-11 23:52:34 +08:00
## Hook
当用户做到某项操作后自动执行某项命令。
- PreToolUse:
- PostToolUse:
- Notification
- UsePromptSubmit
- Stop
- SubagentStop
- PreCompact
- SessionStart
Common
- Task
- Bash
- Glob
- Read
- Edit
- MultiEdit
- Write
## SubAgent
2026-03-04 00:50:24 +08:00
用于哪些与主Agent上下文关系不大的任务。
- 提示词
- 这是一个用于代码审核的 SubAgent。在用户要求“代码审核”的时候调用它。
2026-02-11 23:52:34 +08:00
## 历史对话
- RonitSachdev/CCUndo: 回退对话并且回退代码。
2026-02-26 19:19:35 +08:00
# Plugin
2026-03-04 00:50:24 +08:00
用于将一系列的Skill、SubAgent、Hook等能力都打包到一起, 你只需要一键安装即可。
使用/plugin来进行安装, 通过find来寻找插件。
推荐插件:
2026-02-26 19:19:35 +08:00
- Context7
2026-02-11 23:52:34 +08:00
2026-02-10 17:21:08 +08:00
# 其他相关知识
2026-02-10 14:51:54 +08:00
## Agent Teams 工作机制与原理
在深入案例之前,先理解 Agent Teams 的底层工作机制。这有助于理解后续协作中发生的每一个事件。
### **2.1 架构概览**
```
┌─────────────────────────────────────────────────────────┐
│ 用户( Human) │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ Team Lead │ ◀── 主 Claude 会话 │
│ │ (Orchestrator) │ │
│ └────────┬────────┘ │
│ │ │
│ ┌────────────┼────────────┐ │
│ │ SendMessage / TaskUpdate │ │
│ │ (异步消息队列) │ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Agent A │ │ Agent B │ │ Agent C │ ◀── 子进程 │
│ │(Architect)│ │(Backend) │ │(Frontend)│ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │ │ │ │
│ └────────────┼────────────┘ │
│ ▼ │
│ 共享文件系统 │
│ (api-contract.yaml, │
│ shared-types.ts, ...) │
└─────────────────────────────────────────────────────────┘
```
### 2.2 核心组件
#### **Team( 团队) **
通过 TeamCreate 创建, 在 ~/.claude/teams/{team-name}/config.json 生成团队配置文件。团队是一个逻辑分组, 包含:
- 团队名称和描述
- 成员列表( name、agentId、agentType)
- 与 TaskList 的 1:1 对应关系
#### **Agent( 智能体) **
每个 Agent 是一个独立的 Claude 子进程, 通过 Task 工具启动( subagent_type: general-purpose) 。每个 Agent 拥有:
- **独立的上下文窗口**: Agent 之间不共享对话历史
- **独立的工具集**:可以读写文件、执行 bash 命令、搜索代码等
- **异步消息队列**:接收来自其他 Agent 或 Team Lead 的消息
- **团队感知**:可以读取团队配置文件,知道队友是谁
#### **TaskList( 任务列表) **
通过 TaskCreate、TaskUpdate、TaskList 等工具管理。任务系统提供:
- **状态机**: pending → in_progress → completed
- **依赖关系**: blockedBy / blocks 实现任务间的前后依赖
- **分配机制**: owner 字段标识任务归属
#### **SendMessage( 消息系统) **
Agent 间通信的唯一方式。消息类型包括:
- message: 点对点消息( Agent A → Agent B)
- broadcast: 广播消息( 发送给所有队友)
- shutdown_request / shutdown_response: 优雅关闭协议
### **2.3 通信模型:异步邮箱 + 空闲通知**
Agent Teams 的通信是**异步的**,这是理解整个协作过程的关键:
```
Agent A Agent B
│ │
├─── SendMessage ──────────▶│ (消息进入 B 的邮箱)
│ │
├─── 继续工作... │ (B 可能正忙,消息排队)
│ │
│ ├── 本轮工作结束
│ ├── 检查邮箱,读取消息
│ ├── 处理消息,发送回复
│ ◀── idle_notification ───┤ (B 的轮次结束,系统自动通知)
│ │
```
**关键机制:**
1. **消息不会打断正在工作的 Agent ** :如果 Agent B 正在写代码, Agent A 发送的消息会在 B 的邮箱中排队,直到 B 当前轮次结束后才会被处理。
2. **idle_notification 是系统自动发送的 ** :当一个 Agent 的轮次结束(无论是完成了工作还是在等待输入),系统会自动向 Team Lead 发送空闲通知。这不是 Agent 主动发的。
3. **Agent 间不直接通信 ** : 所有消息都通过邮箱系统路由。Agent A 发给 Agent B 的消息, Team Lead 可以在 idle_notification 的 summary 中看到摘要。
4. **共享文件系统是隐式通信通道 ** :虽然 Agent 间不共享上下文,但它们可以通过读写同一个文件(如 api-contract.yaml) 来传递信息。
### **2.4 Agent 的生命周期**
```
创建(Task tool)
│
▼
初始化 ──▶ 读取 prompt ──▶ 开始工作
│
┌───────────┤
▼ ▼
完成工作 等待消息
│ │
▼ ▼
发送结果 idle (空闲)
│ │
▼ ▼
idle_notification ──▶ Team Lead
│
┌───────┤
▼ ▼
收到新消息 收到 shutdown_request
│ │
▼ ▼
继续工作 shutdown_response(approve)
│
▼
进程退出
```
### **2.5 任务依赖如何控制协作节奏**
这个案例中最关键的协调机制是**任务依赖**:
```
Task #1 (Architect: 设计 API) status: pending → in_progress → completed
│
├── blocks ──▶ Task #2 (Backend: 评审) ← blockedBy: [#1 ]
├── blocks ──▶ Task #3 (Frontend: 评审) ← blockedBy: [#1 ]
└── blocks ──▶ Task #4 (QA: 评审+测试) ← blockedBy: [#1 ]
```
当 Task #1 的状态变为 completed 时, Tasks #2/ #3/ #4 的 blockedBy 列表自动清空, Agent 可以通过 TaskList 发现任务可执行。
但实际操作中,**依赖关系是"软约束"** —— Agent 并不会自动被阻塞。Team Lead 需要主动告知 Agent "你的任务被阻塞了,请等待",或者 Agent 自己通过 TaskList 查看依赖状态后决定等待。
### **2.6 多团队工作流**
在这个案例里面,同一个 Team Lead **顺序创建、使用、销毁了 4 支团队 ** ,每支团队负责一个阶段:
```
flash-sale (4 Agent) 合约设计 + 并行编码
│ 完成 → 销毁
▼
flash-sale-review (4 Agent) 代码评审
│ 完成 → 销毁
▼
p0-fix (9 Agent) P0 级问题并行修复
│ 完成 → 销毁
▼
remaining-fix (4 Agent) 剩余问题并行修复
│ 完成 → 销毁
```
每支团队拥有独立的 TaskList 和成员列表,团队之间通过**共享文件系统**传递成果(上一支团队的代码产出是下一支团队的评审/修复输入) 。Team Lead 的主会话贯穿全程,是唯一跨团队的持久上下文。