Files
BlueRoseNote/07-Other/AI/AI Agent/Claude & CodeX.md

407 lines
26 KiB
Markdown
Raw Normal View History

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 DashboardAI并行编程的指挥中心 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
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. 接入OpenClawAPI格式是基于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 的主会话贯穿全程,是唯一跨团队的持久上下文。